SagaAI - это открытая платформа, на которой вы собираете и управляете собственной командой ИИ-сотрудников: чат-ассистенты, автономные оркестраторы, базы знаний (RAG) и встроенный агент-разработчик DevAgent - в одном веб-интерфейсе, на вашем компьютере или сервере, с контролем над действиями агентов и защитой ваших данных. Лицензия - MIT.
Это не «ещё один чат-бот» и не «ещё один кодинг-агент». SagaAI объединяет персональных ассистентов, агентные платформы и кодинг-агентов в единой системе: сотрудники с разными ролями работают над задачами, опираются на ваши базы знаний, а агент-разработчик DevAgent редактирует код ваших проектов - с планом, утверждением, бэкапами и тестами. Подробное сравнение с аналогами и позиционирование: COMPARISON.md.
| Роль | Что делает | Для кого это ценно |
|---|---|---|
| 💬 ИИ-помощники | Чат-ассистенты с собственными системными промптами и файлами | Рутинные вопросы, тексты, переводы, разбор документов |
| 👥 Сотрудники-оркестраторы | Автономные агенты с ролями, инструментами, инструкциями и навыками; работают сами, шаг за шагом | Многошаговые рабочие задачи: анализ, обработка, генерация |
| 🔧 DevAgent | Встроенный агент-разработчик: план → утверждение → правки → тесты, с бэкапами и откатами; по вашему выбору - полностью автономный режим следования загруженному плану | Разработка и доработка кода в ваших проектах |
| 📚 Базы знаний (RAG) | Локальные векторные базы с семантическим поиском по вашим документам | Ответы и работа агентов на основе именно ваших данных |
| 🧩 Навыки и коннекторы | Пакеты инструкций для агентов, подключение внешних сервисов (GitHub) | Расширение возможностей без правки кода платформы |
Всё управляется в браузере: чаты, настройки сотрудников, хранилище знаний, история диалогов, обновления - в одном интерфейсе на русском, английском и китайском языках.
Бизнес-пользователям: создавайте помощников и сотрудников под свои задачи без единой строки кода - опишите роль, подключите базу знаний, и команда работает. История диалогов, статистика расхода токенов и защита доступа по паролю - под контролем.
Разработчикам: полный доступ к системным промптам, моделям, инструментам и функциям агентов; DevAgent ведёт разработку в ваших проектах с утверждением изменений, автономным тестированием и документацией; расширяйте платформу навыками и собственными функциями. Self-hosted, открытый код (MIT) - вы владеете и кодом, и данными.
✅ Статус версии: стабильный релиз (v1.1.0). Линия 1.x сохраняет публичные API, интерфейс и форматы данных обратно совместимыми; ломающие изменения выходят только в новом мажорном релизе.
⚠️ Требования к квалификации пользователя. Платформа предназначена для опытных разработчиков, обладающих практическими навыками работы с автономными ИИ-агентами и способных анализировать выполняемые агентом действия в реальном времени, своевременно выявляя и прерывая нелегитимные или потенциально опасные операции. Не рекомендуется лицам без соответствующей технической квалификации.В силу особенностей работы больших языковых моделей - включая галлюцинации и некорректную интерпретацию задач - автономные агенты могут причинить ущерб пользователю и третьим лицам. Используя данное программное обеспечение, пользователь принимает на себя полную ответственность за действия ИИ-агентов.
Согласно лицензии MIT программное обеспечение предоставляется «как есть», без каких-либо гарантий, явно выраженных или подразумеваемых, включая гарантии товарной пригодности, пригодности для определённых целей и ненарушения прав. Ни в каком случае авторы или правообладатели не несут ответственности по каким-либо искам, за ущерб или по иным требованиям, возникшим из-за использования программного обеспечения или иных действий с ним. Полный текст лицензии.
Каждая возможность платформы обслуживает главную идею - команда ИИ-сотрудников под вашим контролем.
- Чат с поддержкой OpenAI-совместимых API (YandexAI, DeepSeek) и GigaChat; поддержка веб-поиска от Yandex AI и Deepseek.
- Прикрепление файлов: текст, PDF, офисные форматы (docx, pptx, xlsx) с автоматическим извлечением содержимого.
- Ответы в Markdown с подсветкой синтаксиса и кнопкой копирования.
- Каждый сотрудник - автономный агент со своим системным промптом, моделью, эконом-режимом, инструментами, инструкциями, функциями, навыками, базами знаний и подключениями.
- Системные функции включаются и выключаются чекбоксами на вкладке «Функции»; отключённый инструмент реально блокируется диспетчером.
- В системный промпт каждого сотрудника автоматически добавляется каталог доступных инструментов (
## Available tools) с правилами вызова; независимые вызовы разрешено объединять в один батч (с условиями независимости). - DevAgent - встроенный (неудаляемый) оркестратор, всегда доступен.
- Секция «Сотрудники» в сайдбаре: первые 5 всегда видны, остальные - в свёрнутом блоке «Все (N)»; поиск показывается только при количестве сотрудников больше пяти. Порядок - по времени последнего диалога (новые и недавно использованные сверху).
- Создание, редактирование и удаление помощников (системных промптов) с привязкой файлов и подбором модели под сложность задачи.
- Assistant Creator - встроенный мета-инструмент: генерирует качественный системный промпт по описанию роли.
- Секция «Помощники» в сайдбаре: первые 5 всегда видны, остальные - в свёрнутом блоке «Все (N)»; поиск показывается только при количестве помощников больше пяти.
- Редактирование кода с утверждением изменений: каждое изменение предлагается и применяется контролируемо.
- Полностью автономный режим по вашему выбору. При готовом плане DevAgent спросит, следовать ли ему в точности или сначала проанализировать код; при подробном ТЗ - действовать ли без согласования. План всё равно составляется, но фаза утверждения пропускается и исполнение начинается сразу.
- Версионирование файлов (бэкапы), снапшоты проекта и полный откат.
- Регламентированный пайплайн тестирования: юнит-тесты, регрессия, сценарные тесты, саморевью.
- Внешняя память задач (
TASK_STATE.md): план, прогресс, журналы анализа и открытых вопросов - для многоэтапных работ. - Защита от path traversal (инструменты не выходят за пределы рабочей папки), санитизация и разметка недоверенных данных, эвристическая защита от prompt-injection.
- Работа с любым проектом: DevAgent строит карту проекта (
PROJECT_MAP.md) и ведёт документацию (спецификация, архитектура, changelog).
- Локальные базы знаний с векторным индексом и семантическим поиском; загрузка документов, автоматическая индексация (чанкинг + эмбеддинги).
- Страница «Хранилище»: создание баз, файлы, индексация, тестовый поиск. DevAgent и сотрудники обращаются к базам напрямую.
- Стандартизированные пакеты инструкций и скриптов для сотрудников и DevAgent.
- Создание навыков по запросу на естественном языке и адаптация навыков из других экосистем ИИ-агентов.
- Подключение внешних сервисов (сейчас - GitHub) с хранением токенов в защищённом виде.
- В диалоги оркестраторов загружаются файлы любого формата (до 100 МиБ на файл); агент сам решает, когда и как извлекать содержимое.
- Встроенный конвейер обновлений через публичный GitHub-репозиторий без токена: проверка, выборочная установка (файлы - по отдельности, пакеты кода - целиком), просмотр и откат.
- Применение только при холодном старте, каждый файл бэкапится, запись атомарная, сбой откатывается.
- Страница «Статистика»: расход токенов по периодам, поставщикам и моделям на основе диалогов помощников и сотрудников.
- Страница «Доступы»: вход по паролю, интервал повторного запроса; во время выполнения задачи оркестратором авторизация не запрашивается.
- TLS-верификация включена по умолчанию; API-ключи хранятся в защищённом виде (или задаются через переменные окружения и не сохраняются в БД); секреты не отображаются в интерфейсе.
- Темы оформления: светлая, тёмная, системная. Интерфейс на русском, английском и китайском языках.
- Единая «История» всех диалогов с фильтрами и поиском.
- Python 3.10 или новее. Проверьте командой
python --version(на Windows также подойдётpy --version). Если Python не установлен, скачайте его с python.org; при установке на Windows отметьте пункт «Add Python to PATH».
-
Скачайте репозиторий (Git не обязателен):
- Страница репозитория → Code → Download ZIP → распакуйте архив в удобную папку.
- Или клонируйте:
git clone https://github.com/TVD2100/sagaai-platform SagaAI.
-
Откройте терминал в папке проекта. Зайдите в папку, затем Shift + правая кнопка мыши по пустому месту → «Открыть окно PowerShell здесь».
-
Установите зависимости:
pip install -r requirements.txt
- Запустите приложение:
streamlit run app.py
Если команда не находит streamlit, запустите через модуль Python: python -m streamlit run app.py.
- Откройте браузер: http://localhost:8501.
- Клонируйте репозиторий:
git clone https://github.com/TVD2100/sagaai-platform SagaAI
cd SagaAI
- Установите зависимости:
pip install -r requirements.txt
- Запустите приложение:
streamlit run app.py- и откройте http://localhost:8501.
Если команда не находит streamlit, запустите через модуль Python: python -m streamlit run app.py.
После запуска задайте API-ключи нужных AI-сервисов на странице «Настройки» - и создавайте помощников, сотрудников и базы знаний.
Способ 1 - страница «Доступы» (рекомендуется): в боковом меню «🔐 Доступы» включите «Доступ по паролю», задайте пароль и подтверждение, настройте интервал повторного запроса и нажмите «Сохранить». Пароль хранится в БД в зашифрованном виде (Fernet).
Способ 2 - переменная окружения SAGAAI_AUTH_PASSWORD.
После включения интерфейс показывает форму входа. Пароль из формы имеет приоритет перед переменной окружения; при выключенном переключателе на странице «Доступы» пароль не запрашивается.
По умолчанию все HTTPS-запросы к AI-сервисам проверяют сертификаты (verify=True). Отключать проверку не рекомендуется (риск MITM-атаки), но при необходимости (корпоративный прокси, самоподписанный CA):
| Пакет | Назначение |
|---|---|
app.py |
Точка входа Streamlit |
core/ |
Бизнес-логика (API, файлы, помощники, оркестраторы, RAG, аутентификация, криптография, обновления) без зависимостей от Streamlit |
ui/ |
Страницы интерфейса (чат, сотрудники, хранилище RAG, статистика, коннекторы, библиотека навыков) |
storage/ |
SQLAlchemy ORM-модели и репозиторий для SQLite |
dev_agent/ |
Агентный цикл DevAgent: безопасный писатель, инструменты, подбор моделей, внешняя память задач |
defaults/ |
Канонические копии: промпты оркестраторов, инструкции, пресеты, локализации, RAG-базы |
tests/ |
Полный набор тестов (pytest), включая сценарные (tests/scenarios/ и tests/smoke/) |
langs/ |
Переводы интерфейса (ru, en, zh-CN) |
Технологии: Python 3.10+ · Streamlit · SQLite через SQLAlchemy · векторный индекс RAG (SQLite + косинусное сходство, эмбеддинги Yandex Embeddings API) · cryptography · pytest.
AI-провайдеры: OpenAI-совместимые API (YandexAI, DeepSeek), GigaChat; веб-поиск DeepSeek - через Anthropic-совместимый endpoint (модель deepseek-flash).
Обновления: версии и хеши всех поставляемых файлов ведёт манифест file_versions.json; конвейер обновлений доставляет их пользователям через публичный GitHub-репозиторий без токена. Обновления применяются при холодном старте, с бэкапом и откатом при сбое.
Тесты: python3 -m pytest - полный регрессионный набор.
- PROJECT_MAP.md - карта проекта: каждый файл и его назначение.
- SPEC.md - спецификация требований платформы.
- ARCHITECTURE.md - архитектура.
- COMPARISON.md - сравнение с аналогами и позиционирование.
SagaAI распространяется под лицензией MIT (© 2026 Deinekin T.V.) - свободное использование, изменение и распространение.