Odysseus-AIO

Self-hosted AI workspace — master container that auto-deploys the full stack (Odysseus, ChromaDB, SearXNG, ntfy).

  • AI
  • Infrastructure
  • Tools & Utilities
Self-hosted AI workspace — master container that auto-deploys the full stack (Odysseus, ChromaDB, SearXNG, ntfy). One install, full environment.

Platform availability

Available on 1 of 10 platforms

  • Unraid
  • TrueNAS (not listed)
  • Umbrel (not listed)
  • ZimaOS (not listed)
  • Proxmox (not listed)
  • Helm (not listed)
  • Mac (not listed)
  • Windows (not listed)
  • Linux (not listed)
  • Any server (not listed)

Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.

48/100 Fair

Maintained
73last commit 116 days ago
Popular
198 GitHub stars
Easy to install
351 install platform, install notes, Docker image
Light to run
No data

Based on 3 of 4 factors.

Availability: platform listings confirmed today, links checked 39 days ago

GitHub stars
8
Open issues
2
Last commit
2026-07-28
Latest release
stable-b053380
License
MIT
Activity
stale

Checked 10 days ago - source: GitHub (realitymolder/odysseus-aio)

Resources & Compatibility

ARM (e.g. Raspberry Pi) is supported.

Checked 54 days ago - source: Docker Hub image tags and published docs

First-install notes

  • Start with Docker and your .env file Copy `.env.example` to `.env`, fill in any settings it asks for, then run `docker compose up -d --build` to start everything in Docker. This matters because the app reads that `.env` file — a plain-text settings file — before starting, and Docker Compose avoids installing each piece by hand. source
  • Add optional features after first run If you want local speech-to-text, text-to-speech, or document extraction, activate the same Python environment and run `pip install -r requirements-optional.txt`. Without this optional step, those extra features won’t be available, but the basic app can still run. source
  • Expose Ollama if you use local models If Odysseus should use local models through Ollama, start Ollama on the host with `OLLAMA_HOST=0.0.0.0:11434 ollama serve` so Docker containers can reach it. If it only listens on localhost, Odysseus may not be able to connect, and local-model features can fail. source
  • Management UI Access the built-in management UI at port 9000 to view and manage all deployed containers. source

Fetched 38 days ago - each note links to its source

Alternatives

No alternatives collected yet.

Common questions

Which ports should I expect from a fresh Odysseus-AIO install?

The management UI runs on port 9000. The deployed services default to 7000 for Odysseus, 8100 for ChromaDB, 8080 for SearXNG, and 8091 for ntfy.

Why does the container need Docker socket access?

It acts as a master container that pulls and provisions the Odysseus, ChromaDB, SearXNG, and ntfy containers. Docker socket access is required for that management role.

How do I set the admin username and password?

Authentication is enabled by default and the admin username defaults to admin. Set ODYSSEUS_ADMIN_PASSWORD to pre-seed the password; if it is left empty, a password is auto-generated.

How do I connect the workspace to an Ollama server?

Set ODYSSEUS_OLLAMA_BASE_URL to the Ollama server URL. You can also use ODYSSEUS_LLM_HOST for the primary LLM server hostname.

What do I need to enable NVIDIA GPU support?

Set ODYSSEUS_NVIDIA_ENABLED to true. The NVIDIA Container Toolkit must be installed for GPU support.

How do I update the deployed stack?

Open the built-in management UI on port 9000 and use its update function. The UI also handles deploy, stop, and status monitoring.

Answers sourced from github.com

Community

Collected 53 days ago - public community threads