Odysseus: A Comprehensive Self-Hosted AI Workspace for Local Productivity

Overview of Odysseus

Odysseus is an open-source, self-hosted AI platform designed to centralize various productivity tools, including chat, research, document management, email, and personal scheduling. By running locally, users maintain control over their data while utilizing AI workflows that support both local models and external APIs.

Key Features

Odysseus integrates several high-level functionalities into a unified interface:

• AI Chat and Agents: Supports local and API-based models with tool-use, memory, and shell interaction.
• Deep Research: Automates multi-step web research, reading sources, and generating reports.
• Document and Email Management: Features a writing-first editor and an IMAP/SMTP client for triage, summarization, and drafting.
• Organization: Includes a calendar (CalDAV), tasks, and notes module for seamless scheduling.
• Model Benchmarking: A compare tool allows for blind side-by-side testing of different AI models.

Deployment and Security

Odysseus is distributed via Docker, with images hosted on `ghcr.io`. Users can deploy using `docker-compose`, making it accessible even on systems without full development toolchains.

Important Security Guidelines

• Authentication: Always set `AUTH_ENABLED=true` for any deployment accessible over a network.
• Network Exposure: Keep `LOCALHOST_BYPASS=false` when deploying outside of a purely local environment to prevent unauthorized access.
• Credential Handling: Never store private API keys or sensitive data in configuration files that might be committed to version control systems like Git.

How to Get Started

Users can access the platform via `http://localhost:7011` once containers are initialized. The initial admin password is generated during the first startup and can be retrieved via Docker logs. Detailed setup guides, including instructions for GPU acceleration and OS-specific configurations, are available in the project's official GitHub repository. The project encourages community contributions, particularly in documentation, testing, and UI polish.