Skip to content

Instantly share code, notes, and snippets.

@cyberofficial

cyberofficial/Ollama-Dungeon-Install-WIndows.md

Created July 30, 2025 00:08
Show Gist options
  • Save cyberofficial/e2bbbb2bfb6b43a14b39571e2e3a962e to your computer and use it in GitHub Desktop.
Save cyberofficial/e2bbbb2bfb6b43a14b39571e2e3a962e to your computer and use it in GitHub Desktop.
Download ZIP
Raw
Ollama-Dungeon-Install-WIndows.md

Beginner Installation Guide (For Total Beginners)

Welcome! This guide will help you install everything you need to run Ollama Dungeon, even if you've never used GitHub or Python before. Follow each step carefully!

1. Install Git (Version Control)

Git lets you download this project. Download and install it from the official site:

Download Git for Windows

How to install:

  1. Click the link above and download the installer.
  2. Run the downloaded file (Git-*-64-bit.exe).
  3. Click "Next" through all the steps (default options are fine for beginners).
  4. When finished, you can close the installer.

2. Install Python 3.12.7

Python is the programming language for this project.

Download Python 3.12.7 for Windows (64-bit)

How to install:

  1. Click the link above and download the installer.
  2. Run the downloaded file.
  3. IMPORTANT: On the first screen, check the box that says "Add Python to PATH".
  4. Click "Install Now" and wait for it to finish.
  5. When done, close the installer.

3. Verify Python and pip

  1. Open the Windows Start menu, type cmd, and press Enter to open the Command Prompt.
  2. Type python --version and press Enter. You should see something like Python 3.12.7.
  3. Type pip --version and press Enter. You should see a version number. If you see an error, restart your computer and try again.

4. Download This Project

  1. In the Command Prompt, type:
git clone https://github.com/cyberofficial/Ollama-Dungeon.git
  1. Press Enter. This will create a folder called Ollama-Dungeon with all the files.
  2. Move into the folder:
cd Ollama-Dungeon

5. (Recommended) Create a Python Virtual Environment

A virtual environment keeps your Python packages isolated for this project.

  1. In the Command Prompt (inside the Ollama-Dungeon folder), type:
python -m venv venv

This creates a folder named venv with your isolated environment.

  1. Activate the virtual environment:
venv\Scripts\activate

(You should see (venv) at the start of your command line now.)

6. Install Required Python Packages

  1. With the virtual environment activated, type:
pip install -r requirements.txt
  1. Wait for all packages to finish installing.

7. Download or Use Your Preferred AI Models

Ollama supports many different models. The game is tested with the qwen3 models, but you can use any compatible model you prefer.

Recommended (but not required):

ollama pull qwen3:4b
ollama pull qwen3:8b

You can also pull and use other models from the Ollama model library.

Start the Ollama server (required for any model):

ollama serve

Leave ollama serve running in its window while you play.

8. Start the Game

  1. In a new Command Prompt window (still in the Ollama-Dungeon folder), type:
python main.py
  1. The game will start! Follow the on-screen instructions to play.

Troubleshooting

  • If you get errors about missing commands, try restarting your computer.
  • If you see "Can't connect to Ollama", make sure ollama serve is running.
  • For more help, see the Troubleshooting section at the bottom of the README.md.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment