# pewdiepie-archdaemon/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.

Source: https://github.com/pewdiepie-archdaemon/odysseus
Indexed: commit 9712a54 on 2026-10-18 by Repowise. Facts come from the source and git history, not from the maintainer.

## Facts

- Type: MCP server
- Language: Python
- Stars: 95,444 at index time
- License: AGPL-3.0
- Code health: 5.7/10, Fair
- Last commit: 2026-10-16
- Contributors: 348

## Install

From the README: https://github.com/pewdiepie-archdaemon/odysseus#quick-start

Clone the odysseus repository.
    git clone https://github.com/pewdiepie-archdaemon/odysseus.git

Change into the project directory.
    cd odysseus

Copy the example environment file.
    cp .env.example .env

Build and start the containers.
    docker compose up -d --build

## How it 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.

- app.py: entry point
- scripts/_lib/cli.py: entry point
- static/app.js: entry point
- swift/odysseus-mlx-image-bridge/Sources/OdysseusMLXColorize/main.swift: entry point
- swift/odysseus-mlx-image-bridge/Sources/OdysseusMLXInpaint/main.swift: entry point
Modules: tests, static, src, scripts, routes, services, frontend, core. 2,507 files, 565,324 lines, 29,621 symbols.

## Code health

- Score: 5.7/10 (Fair)
- Trend: 4.8 on 2026-09-29, 5.7 on 2026-10-18
- Rank: #201 of 4,000+ indexed repos
- Hotspots: src/agent_loop.py, static/js/emailLibrary.js, src/clean_agent_preview.py, static/js/chat.js, tests/test_clean_agent_preview.py
- Lowest file: static/js/tasks.js
- Dead code: 95 findings

## Maintenance

- Last commit 2026-10-16, first commit 2026-05-31, 2,398 commits
- 348 contributors, bus factor 2

## Security

- Security findings are shown to signed-in users at https://repowise.dev/repo/pewdiepie-archdaemon/odysseus/security

## More

- Page: https://repowise.dev/repo/pewdiepie-archdaemon/odysseus
- Ask this codebase: https://repowise.dev/repo/pewdiepie-archdaemon/odysseus/chat
- Docs: https://repowise.dev/repo/pewdiepie-archdaemon/odysseus/docs
- MCP (signs in with Repowise on first use):
    claude mcp add --transport http repowise https://api.repowise.dev/mcp/pewdiepie-archdaemon/odysseus