Agents

Odysseus

Self-hosted AI workspace for chat, autonomous agents, deep research, email, documents, and more — local-first, privacy-first, no telemetry.

36K Stars
4.3K Forks
MIT License
pewdiepie-archdaemon Maintainer
2026-06-03 Verified
Overview

What is Odysseus?

Odysseus is a self-hosted AI workspace that unifies chat, autonomous agents, deep research, email triage, document editing, calendar, notes, memory, and model serving into a single local-first interface. It runs on your own hardware against your own endpoints — no telemetry, no cloud dependency, and full data privacy.

All-in-one self-hosted workspace

Odysseus combines chat, autonomous agents, deep research, email triage, document editing, calendar, notes, memory, model serving, and more in a single application.

Most AI tools require stitching together multiple services. Odysseus gives you everything in one local-first package without sending data to the cloud.

Local-first with privacy by default

Runs entirely on your hardware against your own model endpoints. No telemetry, no cloud dependency, and no third-party access to your conversations or data.

Privacy is the default architecture, not an afterthought or a premium feature.

Agent loop built on opencode with MCP

Odysseus's agent system is built on opencode, with full MCP tool support, web browsing, file access, shell commands, and persistent memory.

The agent isn't just a chat wrapper — it can take real actions, use tools, and evolve its own skills over time.
Use cases

What Odysseus is built for

01

All-in-one local AI workspace

Run chat, agents, email, documents, and calendar from a single self-hosted dashboard connected to your own models.

02

Autonomous agent workflows

Give the agent tools (MCP, shell, files, web) and let it plan and execute multi-step tasks autonomously.

03

Local model management and serving

Use the Cookbook to scan your hardware, discover suitable models, download them, and serve them — all from the UI.

04

Privacy-preserving email assistant

Connect your IMAP/SMTP accounts for AI-powered email triage, summaries, and draft replies — without sending email data to third-party services.

Quick start

Get started in seconds

terminal
$ git clone https://github.com/pewdiepie-archdaemon/odysseus.git && cd odysseus && docker compose up -d --build
$ git clone https://github.com/pewdiepie-archdaemon/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
$ git clone https://github.com/pewdiepie-archdaemon/odysseus.git && cd odysseus && ./start-macos.sh
Comparison

How it stacks up

Choose Odysseus for a complete self-hosted workspace

vs cloud AI workspaces

ChatGPT and Claude offer polished hosted experiences. Odysseus gives you the same breadth of features — chat, agents, research, tools — but runs entirely on your own hardware with no telemetry.

Choose Odysseus for breadth over specialization

vs single-purpose tools

Dedicated coding agents like Aider or OpenHands go deeper on code tasks. Odysseus is broader — it handles email, calendar, documents, and model management alongside agent capabilities.

FAQ

Frequently asked questions

What should I check before using Odysseus?

Start with one safe workflow for Odysseus. Inspect official setup instructions, required credentials, execution logs, approval points, and failure recovery before expanding from a sandbox task into production automation.

Is Odysseus open source?

Odysseus is listed with MIT based on the official source links in this profile. Re-check the repository, model card, or docs before production use.

Who should evaluate Odysseus?

Odysseus is most worth evaluating for developers who want a self-hosted all-in-one AI workspace with full data privacy.

Does Odysseus require a GPU?

No. Odysseus connects to any LLM endpoint — local or remote. The Cookbook model serving is optional and GPU-dependent. You can use it with API providers like OpenAI, Anthropic, or OpenRouter without any local GPU.

How does Odysseus compare to running separate tools?

Odysseus combines chat, agents, deep research, email, documents, calendar, and model management into one application. The tradeoff is breadth over specialization — dedicated tools may go deeper on specific tasks.