Install Odysseus on macOS
Native Python or Docker — both work on Intel and Apple Silicon Macs.
Quick answer
Native requirements: Python 3.11+, Git.
Docker requirements: Docker Desktop for Mac.
Native install
terminal
git clone https://github.com/pewdiepie-archdaemon/odysseus.git
cd odysseus
python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt
python setup.py
python -m uvicorn app:app --host 127.0.0.1 --port 7000
# Open http://localhost:7000Docker install
terminal
git clone https://github.com/pewdiepie-archdaemon/odysseus.git
cd odysseus
cp .env.example .env
docker compose up -d --build
# Open http://localhost:7000Ollama on Mac
terminal
# Install Ollama from https://ollama.com/download
ollama pull llama3.2
# Native Odysseus → Settings → endpoint:
# http://localhost:11434/v1
# Docker Odysseus → Settings → endpoint:
# http://host.docker.internal:11434/v1FAQ