repowiserepowise

MCP server

pewdiepie-archdaemon / odysseus

Self-hosted AI workspace.

★ 95,444stars on GitHubPythonAGPL-3.0
Install odysseusView on GitHub★ 95.4kSee this for your own repoAsk this codebase

Repowise maps public repos from their source. Not affiliated with pewdiepie-archdaemon. What is Repowise?

github.com/pewdiepie-archdaemon/odysseusIndexed at 9712a54

What is odysseus?

odysseus is a self-hosted AI workspace for chat, agents, research, documents, email, notes, calendar, and local model workflows. It runs an agent-driven loop over local or API models and external tools, taking in chat prompts, documents and notes and producing outputs such as generated reports, edited documents and stored sessions. The project is written mainly in Python, with a JavaScript front end. To install it, run git clone https://github.com/pewdiepie-archdaemon/odysseus.git and follow the steps below. Its code health is 5.7 out of 10 (Fair), ranked #199 of 4,000+ indexed repos. The last commit to odysseus was on Oct 16, 2026, and 348 people have contributed.

As of commit 9712a54, indexed Oct 18, 2026. What it is comes from a model reading the README; the rest is measured from the source and git history, not from the maintainer.

For agentsodysseus.md

Repo facts: type, license, health, rank, contributors
odysseus facts
TypeMCP server
LicenseAGPL-3.0
Code health5.7 / 10 (Fair)
Health rank#199 of 4,000+ indexed repos
Last commitOct 16, 2026
Contributors348
Bus factor2
Size2,507 files, 565,324 lines

Install odysseus

Commands copied from the README

  1. 1Clone the odysseus repository.
    git clone https://github.com/pewdiepie-archdaemon/odysseus.git
  2. 2Change into the project directory
    cd odysseus
  3. 3Copy the example environment file
    cp .env.example .env
  4. 4Build and start the containers
    docker compose up -d --build

Full install notes on GitHub

Explore odysseus

Ask about this code in your agent

This connects Repowise to odysseus's code. It does not install odysseus. To install odysseus, use the install steps.

Useful if you want to change or fork odysseus: your agent can ask how it is put together and get answers that cite its files.

Show the connect command (Claude Code, Cursor, Codex, VS Code)

Run it in a terminal, then type /mcp in Claude Code and sign in with Repowise. No key to paste.

Docs
bash
claude mcp add --transport http repowise https://api.repowise.dev/mcp/pewdiepie-archdaemon/odysseus
Claude Code, Claude, Cursor and VS Code sign you in on first use, free. Codex and Windsurf need an API key: sign in to create one.Sign in for a key

This repo is public, so anyone with a free Repowise account can connect.

Try asking

  • get_overview()
  • get_answer("how is odysseus put together?")
  • get_why("why is odysseus structured this way?")

Ask about odysseus

Answers come from odysseus's README and source, with the files they cite. Two free answers a day without an account.

Want this for your own codebase? Map your repo free

About this page

Get a page like this for your own codebase

Repowise built this map of pewdiepie-archdaemon/odysseus from its source and git history. It parses every symbol, draws the dependency graph, scores each file's health from complexity, duplication, coverage and churn, finds hotspots and owners in the history, and writes documentation for every module. Your coding agent reads the same index over MCP, so its answers cite real files.

Free for 2 public repos, with a page like this one. No card. See how Repowise works

Prefer local? pip install repowise && repowise init indexes your own checkout, no account needed. Star Repowise on GitHub

pewdiepie-archdaemon/odysseus FAQ

What is odysseus?

odysseus is a self-hosted AI workspace for chat, agents, research, documents, email, notes, calendar, and local model workflows. It runs agent loops over local or API models and external tools.

How does odysseus work?

odysseus takes chat prompts, documents and notes as input and runs an agent-driven loop over models and tools. Its HTTP API, served from app.py, returns generated pages, edited documents and stored sessions.

How do I install odysseus?

odysseus can be installed by changing into the project directory, copying .env.example to .env, and running docker compose up -d --build. The containers are started from the compose files. See the install steps

What language is odysseus written in?

odysseus is written mainly in Python, with JavaScript for the front end and some Swift files for image bridge tools. Its primary language is Python.

How is the odysseus code organized?

odysseus is organized into modules such as routes, which wires the web framework to the rest of the code, and core, which holds persistence and session logic. The mcp_servers module provides email, image generation, memory and RAG retrieval servers.

When should I use odysseus?

Use odysseus when you want a self-hosted workspace for chat, agents, research, documents, email, notes, calendar and local model workflows. It is intended for running these tasks on your own infrastructure.

What license does odysseus use?

odysseus uses the AGPL-3.0 license. The license identifier in the project is AGPL-3.0.

Code health

5.7out of 10Fair

Hotspots average 3.5, the place fixes pay off most.

Full health report

On the leaderboards:#57 of 64 Python repos

Key features of odysseus

  • Chat and agents run over local or API models, with tools, MCP, files, shell, skills and memory.
  • Deep Research performs multi-step web research with source reading and report generation.
  • Documents provides a writing-first editor with AI edits, suggestions, Markdown, HTML, CSV and syntax highlighting.
  • Email offers an IMAP and SMTP inbox with triage, tags, summaries, reminders and reply drafts.
  • Notes, tasks and calendar include reminders, todos, scheduled agent tasks and CalDAV sync.

How pewdiepie-archdaemon/odysseus works

Input enters through app.py, an entry point that serves the HTTP API, and through static/app.js, the browser-side entry point. The routes module assembles the route modules and provides shared helpers, sitting between the web framework and the rest of the codebase. The agent execution loop lives in src/agent_loop.py, which drives calls to models and tools. The core module holds shared persistence primitives such as models and database utilities, along with the session management that routes rely on. Email, image generation, memory and RAG retrieval are provided as separate MCP servers under mcp_servers, and the results are returned to users as generated pages, documents, sessions and interactive UI surfaces.

The codebase has 2,507 files and 29,621 symbols in 15 modules, led by Python, JavaScript and Shell. Code health is 5.7 out of 10, rated fair.