# Odysseus — Self-Hosted AI Workspace

> An open-source, self-hosted AI workspace that lets you run agents, chat with models, and manage workflows from a single unified interface on your own hardware.

## Install

Save as a script file and run:

# Odysseus — Self-Hosted AI Workspace

## Quick Use
```bash
git clone https://github.com/pewdiepie-archdaemon/odysseus.git
cd odysseus
docker compose up -d
# Open http://localhost:3000 in your browser
```

## Introduction
Odysseus is an open-source, self-hosted AI workspace that brings together model chat, agent orchestration, and workflow management into a single web interface. It gives developers and teams a private, extensible environment for interacting with multiple AI providers without sending data to third-party SaaS platforms.

## What Odysseus Does
- Provides a unified web UI for chatting with multiple LLM providers simultaneously
- Supports local model backends including Ollama and vLLM alongside cloud APIs
- Offers built-in agent orchestration for multi-step automated workflows
- Includes session management with persistent conversation history and branching
- Ships as a single Docker Compose stack for quick self-hosted deployment

## Architecture Overview
Odysseus uses a JavaScript-based full-stack architecture with a web frontend that communicates with a backend API server. The backend handles model routing, session persistence, and agent execution. All data is stored locally, and the system supports pluggable provider adapters so you can connect any OpenAI-compatible endpoint. The Docker Compose setup bundles the application with its dependencies for single-command deployment.

## Self-Hosting & Configuration
- Deploy with Docker Compose: clone the repo and run `docker compose up -d`
- Configure API keys for cloud providers via environment variables or the settings UI
- Connect local models through Ollama or any OpenAI-compatible endpoint
- Data is stored locally in mounted volumes for full privacy
- Reverse proxy with Nginx or Caddy for HTTPS in production

## Key Features
- Multi-provider model routing from a single interface
- Agent workflows with human review gates
- Session branching to explore different conversation paths
- Plugin system for extending functionality
- Fully self-contained with no external service dependencies

## Comparison with Similar Tools
- **Open WebUI** — focused on Ollama chat; Odysseus adds agent orchestration and multi-provider routing
- **LibreChat** — similar multi-model chat but Odysseus includes workflow automation
- **LobeChat** — polished UI for chat; Odysseus targets developers wanting self-hosted agent pipelines
- **AnythingLLM** — knowledge-base focused; Odysseus emphasizes agent execution and session management

## FAQ
**Q: Does Odysseus require a GPU?**
A: No. You can use cloud API providers. A GPU is only needed if you want to run local models via Ollama or vLLM.

**Q: Which LLM providers are supported?**
A: Any OpenAI-compatible API, plus native integrations for Ollama, Anthropic, and Google.

**Q: Can I use Odysseus for a team?**
A: Yes. The workspace supports multiple users with separate sessions and configurable access.

**Q: Is data sent to any external service?**
A: No. All data stays on your server. API calls go directly to the providers you configure.

## Sources
- https://github.com/pewdiepie-archdaemon/odysseus

---
Source: https://tokrepo.com/en/workflows/asset-553acee7
Author: Script Depot