Odysseus 1.0 — это self-hosted AI workspace, который работает на вашем железе с вашими данными. Всё локально, приватно, без троянов. Проект задуман как самостоятельная альтернатива ChatGPT и Claude, но с упором на контроль пользователя и возможность кастомизации.
Внутри есть всё для ежедневной работы с AI: чат с любой локальной моделью или API — поддержка vLLM, llama.cpp, Ollama, OpenRouter, OpenAI. Агент, которому можно дать инструменты (MCP, web, файлы, shell, память). Cookbook сканирует ваше железо, подбирает модели под VRAM (GGUF, FP8, AWQ) и сам скачивает их через vLLM или llama.cpp. Deep Research — многошаговый сбор и синтез источников в визуальный отчёт, адаптировано из Tongyi DeepResearch. Compare позволяет слепо тестировать модели без смещения. Документы — редактор с AI-подсказками, где вы пишете, а AI помогает, а не наоборот. Память и навыки для агента — ChromaDB + fastembed (ONNX), векторный и ключевой поиск, импорт/экспорт. Почта — IMAP/SMTP с AI-сортировкой, автотегами, черновиками, спам-фильтром. Заметки и задачи с cron-расписанием, напоминания через ntfy, браузер или email. Календарь — локальный, с синхронизацией по CalDAV с Radicale, Nextcloud, Apple или Fastmail. Всё адаптировано под мобильные (PWA, жесты). Ещё редактор изображений, тем, загрузка файлов (vision + PDF), веб-поиск, сессии, 2FA.
Установка простая. Рекомендуемый способ — Docker: клонируете репозиторий, копируете .env.example, запускаете docker compose up -d --build. Compose поднимет Odysseus, ChromaDB, SearXNG и ntfy. После первого запуска открываете localhost:7000, входите с сгенерированным паролем и настраиваете всё через интерфейс. Для Cookbook на удалённых серверах используется SSH-ключ из контейнера. Можно установить вручную на Linux/macOS — нужен Python 3.11+ и tmux (для фоновых загрузок моделей). На Windows — через PowerShell. После pip install -r requirements.txt и python setup.py запускаете uvicorn app:app.
Безопасность — важная часть. По умолчанию включена аутентификация AUTH_ENABLED=true. Не выставляйте Odysseus в открытый интернет без HTTPS и обратного прокси. Рекомендуется Caddy с автоматическими сертификатами Let's Encrypt, либо Tailscale с MagicDNS для LAN. Все данные лежат в data/ (gitignored). Неадминистраторы не имеют доступа к shell, файлам, MCP, API-ключам — всё строго разграничено по правам. Для production используйте только защищённое соединение.
Основные env-переменные: LLM_HOST (адрес LLM-сервера), OPENAI_API_KEY (опционально), SEARXNG_INSTANCE (по умолчанию localhost:8080, в Docker — searxng:8080), DATABASE_URL (SQLite по умолчанию), CHROMADB_HOST и CHROMADB_PORT. Docker Compose всё это настраивает автоматически. Проект распространяется под лицензией MIT.