Главная / Загрузка

Загрузка и быстрый старт

Платформа распространяется как исходный код: отдельного установщика нет, вы клонируете репозиторий и запускаете приложение в своём окружении. Так у вас остаются и код, и данные.

Требования к окружению

Python	3.12 или новее (`python --version`)
Streamlit	1.66.0 или новее (ставится из `requirements.txt`)
СУБД	не требуется: SQLite через SQLAlchemy, база создаётся при первом запуске
Порты	8501 (по умолчанию) — только локально, если не публикуете сервис
ОС	Windows, Linux, macOS

Шаг 1. Получить код

git clone https://github.com/TVD2100/sagaai-platform.git
cd sagaai-platform

Без git: скачайте архив репозитория на GitHub (Code → Download ZIP) и распакуйте.

Шаг 2. Виртуальное окружение

python -m venv .venv

Активация:

# Windows (PowerShell)
.venv\Scripts\Activate.ps1

# Linux, macOS
source .venv/bin/activate

Шаг 3. Зависимости

pip install -r requirements.txt

При первом запуске приложение само сверяет установленные библиотеки и их версии. Если чего-то не хватает, в интерфейсе появится предупреждение с точной командой установки.

Шаг 4. Запуск

streamlit run app.py

Интерфейс откроется на http://localhost:8501. Если команда streamlit не найдена — запускайте через модуль:

python -m streamlit run app.py

Что дальше

Добавьте модель и ключ провайдера в настройках — без ключей работают интерфейс и поиск BM25.
Загрузите документы в базу знаний и задайте вопрос: ответ должен опираться на ваши файлы.
Создайте первого сотрудника через Employee Creator — по описанию задачи на естественном языке.
Обновления платформы ставятся изнутри приложения: раздел «Обновления» показывает версии файлов и ставит новые.

Тесты

python -m pytest

Перед публикацией в интернет

Платформа даёт агентам доступ к файлам и инструментам. Если вы открываете интерфейс наружу, поставьте его за обратный прокси с аутентификацией и ограничьте сетевой доступ — подробности в разделе о безопасности.