# Odysseus

Odysseus is a self-hosted ai app. Self-hosted AI workspace with chat, agents, deep research, documents, email, calendar, and model Cookbook. It is open source and self-hosted, installable on Docker Hub, TrueNAS, Unraid and ZimaOS.

Canonical page: https://ourlocalhost.com/app/1565/odysseus

## Description

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

## Platform availability

Available on 3 of 10 platforms: Unraid, TrueNAS, ZimaOS.

## Health score

19/100 (Low), based on 3 of 4 factors.
- Maintained: 0 (GitHub repository no longer exists)
- Easy to install: 55 (3 install platforms, install notes, Docker image)
- Light to run: 20 (8 GB minimum RAM, runs on ARM)

## Links

- Docker Hub: https://hub.docker.com/r/realitymolder/odysseus
- TrueNAS: https://apps.truenas.com/catalog/odysseus/
- Unraid: https://ca.unraid.net/apps/odysseus-025cihp09mtdwx?q=Odysseus
- ZimaOS: https://github.com/bigbeartechworld/big-bear-casaos/tree/master/Apps/odysseus

## Common questions

### What must I do before starting Odysseus with Docker Compose?

Copy .env.example to .env in the cloned folder before running Docker Compose. This creates the settings file the app reads, so skipping it can leave required values missing and cause startup problems.

### What first-run step is required for a native install?

Create a virtual environment, install the requirements, and run python setup.py before starting the server. This first-run step creates the files the app expects.

### How can I reach Odysseus from another device?

The native start command listens on 127.0.0.1:7000, which means the same computer only. Change the host setting or put a proxy in front if you need access from another device.

### How do I connect models in the Odysseus setup guide?

The guide says to connect Ollama or API keys, read logs, and choose a model that fits your hardware.

---
Source: Our Local Host (https://ourlocalhost.com/app/1565/odysseus), the self-hosted and open-source app directory.
