Odysseus — это самостоятельно размещаемая AI-платформа, созданная как ориентированная на приватность альтернатива ChatGPT и Claude. По словам авторов, это «самостоятельно размещаемая версия того пользовательского опыта, который вы получаете от ChatGPT и Claude, только с большим количеством "костылей" и веселья».
Версия 1.0 работает на персональном оборудовании и не требует обязательных внешних зависимостей. Главные принципы — приватность, локально-ориентированная архитектура и полный контроль со стороны пользователя.
Общение с несколькими локальными моделями и API: vLLM, llama.cpp, Ollama, OpenRouter, OpenAI.
Автоматическое выполнение задач с доступом к инструментам: MCP, веб-браузинг, операции с файлами, команды оболочки.
Сканирование оборудования, рекомендации совместимых моделей и загрузка с учётом доступного объёма VRAM.
Многошаговый сбор и синтез информации (Deep Research).
«Слепое» сравнение ответов моделей бок о бок.
Совместная работа над документами в формате Markdown с помощью ИИ.
Память и навыки на основе ChromaDB и векторного поиска (embeddings).
Интеграция по IMAP/SMTP с функциями AI-сортировки писем (триаж).
Планировщик и синхронизация календаря через CalDAV.
Адаптивный интерфейс и возможность установки как PWA-приложение.
git clone https://github.com/pewdiepie-archdaemon/odysseus.git
cd odysseus
cp .env.example .env
docker compose up -d --buildОткройте платформу по адресу http://localhost:7000.
Требуется Python 3.11+. Создайте виртуальное окружение, установите зависимости и запустите сервер:
git clone https://github.com/pewdiepie-archdaemon/odysseus.git
cd odysseus
python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt
python setup.py
python -m uvicorn app:app --host 127.0.0.1 --port 7000Пользователям Apple Silicon рекомендуется нативная установка для аппаратного ускорения через Metal (Docker не имеет доступа к Metal):
git clone https://github.com/pewdiepie-archdaemon/odysseus.git
cd odysseus
./start-macos.shДля автоматической установки выполните скрипт, либо вручную создайте venv и установите зависимости:
git clone https://github.com/pewdiepie-archdaemon/odysseus.git
cd odysseus
powershell -ExecutionPolicy Bypass -File .\launch-windows.ps1При первом запуске Odysseus автоматически создаёт учётную запись администратора (имя admin, если не задана переменная ODYSSEUS_ADMIN_USER) и выводит временный пароль в терминал.
Для установок через Docker эту же строку с паролем можно найти в логах:
docker compose logs odysseusВойдите, используя временные учётные данные, после чего обязательно смените пароль в разделе «Настройки» (Settings).
Значения по умолчанию работают «из коробки»: клонируйте репозиторий, запустите, а затем настройте модели, поиск и почту внутри раздела «Настройки» (Settings). Для большинства пользователей правка файла .env не требуется.
После входа конфигурация доступна двумя способами:
/setupВ разделе настроек вы зададите:
Файл .env опционален, но рекомендуется для задания значений уровня развёртывания и секретов — таких как APP_BIND, APP_PORT, AUTH_ENABLED, DATABASE_URL или заранее заданный пароль администратора.
Подключитесь к локальным моделям или API (vLLM, llama.cpp, Ollama, OpenAI и др.) и сразу начинайте диалог.
Предоставьте агенту инструменты, и он автономно выполнит задачи, используя доступ в интернет, операции с файлами, команды оболочки и постоянную память.
Платформа сканирует ваше оборудование, рекомендует подходящие модели и обеспечивает загрузку и запуск «в один клик» с оптимизацией под доступный объём VRAM.
| Переменная | Описание | По умолчанию |
|---|---|---|
APP_BIND | Привязка к сетевому интерфейсу | 127.0.0.1 |
APP_PORT | Порт веб-интерфейса | 7000 |
AUTH_ENABLED | Требование авторизации (вход по логину) | true |
DATABASE_URL | Строка подключения к базе данных | — |
CHROMADB_HOST | Хост сервиса векторной памяти | — |
ODYSSEUS_ADMIN_USER | Имя учётной записи администратора | admin |
Важно: Odysseus — мощный административный инструмент. Соблюдайте меры предосторожности.
AUTH_ENABLED=true для любого развёртывания, доступного по сети..env, базы данных, загрузки и API-ключи вне системы контроля версий (приватно, не в Git).В основе платформы лежит фреймворк FastAPI, фронтенд-ресурсы находятся в каталоге static/. Пользовательские данные — сессии, сообщения, embeddings, загрузки — сохраняются в каталоге data/, исключённом из системы контроля версий.
Приложение поддерживает опциональные зависимости для расширенных функций, таких как преобразование речи в текст (speech-to-text) и извлечение содержимого документов.