Odysseus

Odysseus

Docker app from RealityMolder-Odysseus' Repository

Overview

Self-hosted AI workspace with chat, agents, deep research, documents, email, calendar, and model Cookbook.

Readme

View on GitHub

Odysseus

A self-hosted AI workspace for chat, agents, research, documents, email, notes, calendar, and local model workflows.

Quick Start · Setup Guide · Contributing · Roadmap

Packaging status

Odysseus interface

Quick Start

dev is the default branch and gets the newest changes first. Use main if you want the more curated branch.

git clone https://github.com/pewdiepie-archdaemon/odysseus.git
cd odysseus
cp .env.example .env
docker compose up -d --build

Open http://localhost:7000 when the containers are healthy. The first admin password is printed in docker compose logs odysseus.

Native installs, GPU notes, Windows/macOS instructions, HTTPS, and configuration live in the setup guide.

Features

  • Chat + Agents — local/API models, tools, MCP, files, shell, skills, and memory.
  • Cookbook — hardware-aware model recommendations, downloads, and serving.
  • Deep Research — multi-step web research with source reading and report generation.
  • Compare — blind side-by-side model testing and synthesis.
  • Documents — writing-first editor with AI edits, suggestions, Markdown, HTML, CSV, and syntax highlighting.
  • Email — IMAP/SMTP inbox with triage, tags, summaries, reminders, and reply drafts.
  • Notes, Tasks + Calendar — reminders, todos, scheduled agent tasks, and CalDAV sync.
  • Extras — gallery/image editor, themes, uploads, web search, presets, sessions, and 2FA.

Demo

A full hover-to-play tour lives on the landing page: docs/index.html.

Contributing

Help is welcome. The best entry points are fresh-install testing, provider setup bugs, mobile/editor polish, docs, and small focused refactors. See CONTRIBUTING.md and ROADMAP.md.

Security

Odysseus is a self-hosted workspace with powerful local tools. Keep auth enabled, keep private data out of Git, and do not expose raw model/service ports publicly. Deployment details are in the setup guide.

Star History

Star History Chart

License

AGPL-3.0-or-later -- see LICENSE and ACKNOWLEDGMENTS.md.

Install Odysseus on Unraid in a few clicks.

Find Odysseus in Community Apps on your Unraid server, review the template, and click Install. Unraid handles the Docker app or plugin setup from the published template.

Open the Apps tab on your Unraid server Search Community Apps for Odysseus Review the template variables and paths Click Install
Explore Unraid OS

Requirements


    Odysseus-ChromaDB

Categories

AI > Tools

Download Statistics

1,992
Total Downloads

Related apps

Explore more like this

Explore all
Tools apps

Links

Projectgithub.comSupportgithub.comDocker Hubregistry.hub.docker.comTemplateraw.githubusercontent.com

Details

Repository
realitymolder/odysseus:stable
Registry
https://registry.hub.docker.com
Last Updated2026-06-25
First Seen2026-06-30

Runtime arguments

Web UI
http://[IP]:[PORT:7000]
Network
bridge
Shell
bash
Privileged
false

Template configuration

App PortPorttcp

Web UI port

Target
7000
Default
7000
Value
7000
App DataPathrw

Persistent data storage (database, uploads, memory)

Target
/app/data
Default
/mnt/user/appdata/odysseus/data
Value
/mnt/user/appdata/odysseus/data
App LogsPathrw

Application logs

Target
/app/logs
Default
/mnt/user/appdata/odysseus/logs
Value
/mnt/user/appdata/odysseus/logs
HF CachePathrw

HuggingFace model cache

Target
/app/.cache/huggingface
Default
/mnt/user/appdata/odysseus/huggingface
Value
/mnt/user/appdata/odysseus/huggingface
Local CachePathrw

Cookbook-installed engines (vLLM, llama.cpp)

Target
/app/.local
Default
/mnt/user/appdata/odysseus/local
Value
/mnt/user/appdata/odysseus/local
SSH KeysPathrw

Cookbook remote-server SSH keys

Target
/app/.ssh
Default
/mnt/user/appdata/odysseus/ssh
Value
/mnt/user/appdata/odysseus/ssh
PUIDVariable

User ID for file permissions (default 99 = nobody)

Default
99
Value
99
PGIDVariable

Group ID for file permissions (default 100 = users)

Default
100
Value
100
Auth EnabledVariable

Enable authentication

Target
AUTH_ENABLED
Default
true
Value
true
Admin UserVariable

First admin account username

Target
ODYSSEUS_ADMIN_USER
Default
admin
Value
admin
Admin PasswordVariable

Pre-seed admin password (leave blank for auto-generated)

Target
ODYSSEUS_ADMIN_PASSWORD
App PortVariable

Internal app port (leave as 7000)

Target
APP_PORT
Default
7000
Value
7000
LLM HostVariable

Primary LLM server hostname

Target
LLM_HOST
Default
localhost
Value
localhost
OpenAI API KeyVariable

Optional OpenAI API key

Target
OPENAI_API_KEY
SearXNG InstanceVariable

SearXNG URL (compose: searxng:8080, branded template: odysseus-searxng:8080)

Target
SEARXNG_INSTANCE
Default
http://odysseus-searxng:8080
Value
http://odysseus-searxng:8080
ChromaDB HostVariable

ChromaDB host (internal Docker hostname)

Target
CHROMADB_HOST
Default
odysseus-chromadb
Value
odysseus-chromadb
ChromaDB PortVariable

ChromaDB port

Target
CHROMADB_PORT
Default
8000
Value
8000
Database URLVariable

Database connection string

Target
DATABASE_URL
Default
sqlite:///./data/app.db
Value
sqlite:///./data/app.db
Extra HostsVariable

Extra hosts mapping (for reaching host services like Ollama)

Target
EXTRA_HOSTS
Default
host.docker.internal:host-gateway
Value
host.docker.internal:host-gateway