other / agent

Odysseus

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

Repository owner odysseus-dev

Not rated yet
0 comments

Like 0 Save

Published 11 Oct 2026Listing updated 12 Oct 2026

At a glance

Purpose: A self-hosted AI workspace for chat, agents, research, documents, email, notes, calendar and local model workflows.
Runs in: Web service
Operating systems: macOS, Windows
Needs: Runtime: Docker Compose; Needs internet: Yes; Needs accounts or API keys beyond your agent: Not stated
Files and data: Reads files: Not stated; Writes files: Not stated; Sends data to other services: Yes
Tool type: Agent
Delivery: From GitHub
Version: Latest on the dev branch
Access: Code on GitHub
Compatibility: According to the README, Odysseus runs with Docker Compose and pulls a multi-arch container image, and it can run as a Portainer stack. The README says the setup guide covers native installs, GPU notes, Windows and macOS instructions, and HTTPS. It names local and API models, MCP, IMAP and SMTP email, and CalDAV calendars. The top-level files include docker-compose.gpu-amd.yml and docker-compose.gpu-nvidia.yml.
External costs: The repository is AGPL-3.0-licensed and states no pricing. The model provider you connect may charge for usage.
Permissions: The README shows copying .env.example to .env and starting background containers with docker compose up -d --build. The README says the compose files pull the project's multi-arch container image and build locally if the pull fails. The README lists files, shell, MCP, skills and memory under Chat and Agents, along with web research, model downloads and serving, an IMAP/SMTP inbox, CalDAV sync and scheduled agent tasks. The top-level inventory includes scripts/, but the README does not describe that folder's contents. The README does not describe approval or sandbox modes. The README advises keeping authentication enabled, keeping private data out of Git and avoiding public exposure of raw model or service ports. The README specifies AUTH_ENABLED=true for network-accessible deployments and LOCALHOST_BYPASS=false outside local development.
Usage terms: GNU Affero General Public License v3.0, as stated in the repository. See its LICENSE file for the exact terms. The README's license section says AGPL-3.0-or-later and also points to ACKNOWLEDGMENTS.md.
Interface: web

Code on GitHub

odysseus-dev/odysseus

AGPL-3.0

Python93,078 stars1,536 forksLast pushed 8 Oct 2026 UTC

Self-hosted AI workspace.

Public GitHub data fetched 13 Oct 2026 UTC · 0 days old

Skill folders in this repository (14)

Folders that contain a SKILL.md file, from GitHub's file list on 13 Oct 2026 UTC.

View on GitHub ↗

What it does

According to the README, Odysseus is a self-hosted AI workspace for chat, agents, research, documents, email, notes, calendar and local model workflows.

The README lists local or API models, tools, MCP, files, shell, skills and memory under Chat and Agents. The README describes Cookbook as hardware-aware model recommendations, downloads and serving. The README describes Deep Research as multi-step web research with source reading and report generation, and Compare as blind side-by-side model testing and synthesis. The README describes Documents as a writing-first editor with AI edits and suggestions. The README describes Email as an IMAP/SMTP inbox with triage, tags, summaries, reminders and reply drafts. The README lists scheduled agent tasks and CalDAV sync under Notes, Tasks and Calendar.

The README gives a Docker Compose quick start and says to open the app on localhost port 7011. The README says dev gets the newest changes first and describes main as the more curated branch.

Who it is for

People who want a self-hosted workspace that puts AI chat and agents next to documents, email, notes and a calendar.

Example tasks

Start Odysseus with Docker Compose and open it in a browser.
Run a multi-step web research task and generate a report with Deep Research.
Use Compare for the blind side-by-side model testing and synthesis described in the README.
Triage an IMAP/SMTP inbox and draft replies.
Schedule an agent task or sync a calendar over CalDAV.

Getting started

According to the README, clone the repository, run cd odysseus, run cp .env.example .env, then run docker compose up -d --build. Open localhost on port 7011 when the containers are healthy. The README says the first admin password is printed in the output of docker compose logs odysseus. For production it advises pinning an immutable image tag instead of :latest. The README has the exact commands.

Limitations

According to the README, the quick start uses Docker Compose and starts with cp .env.example .env. The README says native installs, GPU notes, Windows and macOS instructions, HTTPS and configuration live in a separate setup guide, which is not part of the README. The README says to keep AUTH_ENABLED=true for any network-accessible deployment, keep LOCALHOST_BYPASS=false outside local development, and not expose raw model or service ports publicly. The README names no specific model providers. It says the dev branch gets the newest changes first and points to main as the more curated branch. The repository can change at any time; check its README before you install.

Data practices

The README describes Odysseus as self-hosted and lists local or API models, web search, an IMAP/SMTP inbox and CalDAV sync. The README does not specify the payloads or retention policies of those configured external services. The README advises keeping private data out of Git, keeping authentication enabled and avoiding public exposure of raw model or service ports. The README does not mention telemetry.