Odysseus

A self-hosted AI workspace with chat, agents, research, documents, email and notes.

Illustrative image, AI-generated
DifficultySome experience
HardwareCPU is enough for small models · GPU (NVIDIA/AMD) is much faster
LicenseAGPL-3.0-or-later
LinksGitHub

Odysseus is PewDiePie's open-source alternative to paying for ChatGPT subscriptions. You can chat with local models or bring your own API keys. Agents run multi-step web research for you, and you can compare models side by side in blind tests. On top of that you get a document editor, an email inbox with summaries, plus notes, tasks and a calendar. The "Cookbook" suggests models that suit your hardware and downloads them for you. All your data stays on your own machine.

How to try it

Commands from the official guides – just copy them.

Linux

# Option 1: Docker (recommended)
git clone https://github.com/odysseus-dev/odysseus.git
cd odysseus
cp .env.example .env       # optional
docker compose up -d --build
# Get the admin password from the logs:
docker compose logs odysseus
# Then open your browser (the address is in the README or the setup guide)

# Option 2: native (requires Python 3.11+, plus tmux for the Cookbook)
git clone https://github.com/odysseus-dev/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
# Then open in your browser: http://localhost:7000

macOS

# Quick route: the script installs the dependencies via Homebrew and starts everything
git clone https://github.com/odysseus-dev/odysseus.git
cd odysseus
./start-macos.sh
# Then open in your browser: http://127.0.0.1:7860
# Note: Docker on a Mac can't use the Metal GPU, so the native setup is the better choice

Windows (PowerShell)

# Requires Python 3.11+; Git for Windows recommended (for Cookbook downloads and the agent terminal)
git clone https://github.com/odysseus-dev/odysseus.git
cd odysseus
# Launch script (safe to run as often as you like)
powershell -ExecutionPolicy Bypass -File .\launch-windows.ps1
# Then open http://localhost:7000 and sign in with the generated admin password

Commands from the official guide. New in the Toolbox since Nov 19, 2026.

Ask the AI assistant

Questions about Odysseus, installation or background? Our assistant knows this page and runs on our own machine, not in someone else's cloud.

Connecting …

The Assistant is an AI (Gemma 4) and can make mistakes – please check important details against the source. Questions are used only to generate an answer and are deleted after one hour. Please don't enter any personal data.

Comments

What do you think? Already tried it? Write it here, no sign-up needed.

  1. Loading comments …

Comments are public. Links aren't allowed, and we delete abusive posts. You can delete your own comment at any time in this browser. Learn more in the Privacy Policy.