Deep Research

Многошаговый ресёрч. Даёшь тему - агент сам ищет источники, читает, сопоставляет и собирает визуальный отчёт. Адаптировано из Alibaba Tongyi DeepResearch.

Полезно когда нужно быстро разобраться в новой теме или собрать обзор для статьи или презентации.

Compare

Слепое сравнение моделей. Задаёшь промпт, две модели отвечают параллельно, ты не видишь какая какая - выбираешь лучший ответ. Хорошо отрезвляет тех, кто на хайпе бежит платить за условный GPT-5, не проверяя что задача решается локальной 14B-моделью за бесплатно.

Documents

Текстовый редактор внутри Odysseus. Многотабовый, поддерживает markdown, HTML, CSV, подсветку синтаксиса. AI там не пишет за тебя - он помогает: подсказывает правки, отвечает на запросы по куску текста. Подход правильный: ты автор, AI - помощник, а не наоборот.

Память и скиллы

Это то, что делает агента твоим, а не общим. Каждый чат отправляется в векторное хранилище (ChromaDB + ONNX-эмбеддинги через fastembed). Через какое-то время агент уже знает твой контекст, твоих людей, твои проекты, твою стилистику. Скиллы можно импортировать и экспортировать.

Email

Полноценный почтовик с AI-триажем:

• IMAP и SMTP
• авто-определение срочности
• авто-теги
• авто-саммари длинных писем
• черновики ответов
• антиспам
• per-account роутинг
• учитывает CalDAV (видит твой календарь)

Заметки, задачи, календарь

Быстрые заметки с напоминаниями. To-do список. Cron-style задачи которые агент может выполнять сам - например «каждое утро в 8 утра делай сводку по почте и кидай в ntfy».

Календарь локальный, синхронизируется по CalDAV с Radicale, Nextcloud, Apple, Fastmail. Импорт и экспорт .ics.

Прочее

• работает на телефоне как PWA (можно «установить»)
• встроенный image-редактор
• кастомные темы
• загрузка файлов (vision + PDF)
• web-поиск через SearXNG
• пресеты, сессии, 2FA

Как ставится

Идеология: «defaults work out of the box». Минимум конфигурации.

Docker (рекомендуется):

git clone https://github.com/pewdiepie-archdaemon/odysseus.git
cd odysseus
cp .env.example .env
docker compose up -d --build

После запуска - http://localhost:7000. Первый пароль админа печатается в логах (docker compose logs odysseus), потом меняешь в настройках.

Docker по умолчанию биндит на 127.0.0.1 - то есть наружу не торчит, доступен только с твоей машины. Хочешь LAN или reverse-proxy - руками выставляешь APP_BIND=0.0.0.0.

Native Linux / macOS / Windows:

Python 3.11+, venv, pip install -r requirements.txt, uvicorn. Для винды есть launch-windows.ps1 который сам всё разворачивает.

Apple Silicon:

Docker на маке не умеет в Metal-GPU, поэтому для Cookbook на M-серии есть нативный start-macos.sh. Поднимается на 127.0.0.1:7860.

GPU:

NVIDIA и AMD оверлеи через COMPOSE_FILE. Прописал в .env - и контейнер видит видеокарту.

Что под капотом

app.py                   # FastAPI
core/      auth, database, middleware
src/       llm_core, agent_loop, agent_tools, search/
routes/    chat, session, document, memory, model
services/  docs, memory, search, hwfit (Cookbook)
static/    index.html + app.js + js/

Стек: FastAPI, SQLite (по дефолту, можно переключить через DATABASE_URL), ChromaDB для векторов, SearXNG для веб-поиска, ntfy для уведомлений. Всё это поднимается одним docker-compose.

Безопасность

Авторы прямо пишут: это не игрушка, у системы есть shell-доступ, загрузка файлов, скачивание моделей, веб-ресёрч, доступ к почте и календарю. По сути - админ-консоль. Поэтому:

• AUTH_ENABLED=true обязательно для всего что доступно по сети
• наружу - только через HTTPS и reverse proxy (Caddy конфиг приведён в README, две строчки)
• не-админы не получают shell, Python, запись файлов и админ-роуты по умолчанию
• права раздаются per-user

Подход здравый. Если ставишь на VPS - бери Caddy с Let's Encrypt, и спишь спокойно.

Зачем это лично тебе

Я смотрю на это с двух сторон.

Как пользователь. Подписки на Claude, ChatGPT, Perplexity суммарно легко улетают в 60-80 баксов в месяц. И ты не контролируешь ни лимиты, ни цены, ни то, что они завтра сделают с твоими данными. Odysseus + хороший локальный сервер (или дешёвый API типа OpenRouter) закрывают 90% задач персонального ассистента и обходятся кратно дешевле.

Как предприниматель. Если строишь продукт вокруг AI - это готовый каркас на котором можно ставить эксперименты, не собирая UI с нуля. Чат, агенты, память, deep research, документы - всё уже есть. Берёшь, форкаешь, кастомизируешь под свой кейс.

И главное: это полная альтернатива зависимости от чужих облаков. Один сервер - один контроль.

Ссылка

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

Лицензия MIT. Форкай, используй, ломай, чини.