Install Odysseus on macOS
Official path on Mac: ./start-macos.sh → open http://localhost:7860.
Quick answer
Native requirements: Python 3.11+, Git. Prefer the curated main branch.
Expected URL: http://localhost:7860 (script default). Docker installs still use port 7000.
Official tip: clone -b main for the curated branch. Bare git clone defaults to dev (newest, less stable).
Recommended — start-macos.sh
Best for Apple Silicon: Metal-friendly native install, auto deps, port 7860.
terminal
# Recommended on Apple Silicon (Metal / Cookbook GPU):
git clone -b main https://github.com/pewdiepie-archdaemon/odysseus.git && cd odysseus
./start-macos.sh
# Opens http://127.0.0.1:7860 (NOT 7000 — AirPlay often holds 7000)
# First-run admin password prints in the terminalManual native install
terminal
# Manual native path (same result as the script):
git clone -b main 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 7860
# Open http://localhost:7860Docker install
Docker cannot use the Metal GPU. Use this if you only need the workspace UI + cloud/API or host Ollama.
terminal
git clone -b main https://github.com/pewdiepie-archdaemon/odysseus.git && cd odysseus
cp .env.example .env
docker compose up -d --build
# Open http://localhost:7000
# Note: Docker on Mac cannot use the Metal GPU — Cookbook serves on CPU only.
# Prefer ./start-macos.sh for local GPU-accelerated models.Ollama on Mac
terminal
# Install Ollama from https://ollama.com/download
ollama pull llama3.2
# Native Odysseus (port 7860) → Settings → endpoint:
# http://localhost:11434/v1
# Docker Odysseus → Settings → endpoint:
# http://host.docker.internal:11434/v1FAQ