SagaAI

Главная / Документация / Быстрый старт

Быстрый старт

Быстрый старт

Пятнадцать минут от нуля до работающего интерфейса. Всё локально: облако не нужно.

Что понадобится

  • Python 3.12 или новее;
  • git (или архив репозитория);
  • около 1 ГБ свободного места под зависимости.

Шаги

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

Активируйте окружение:

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

# Linux, macOS
source .venv/bin/activate

Установите зависимости и запустите:

pip install -r requirements.txt
streamlit run app.py

Интерфейс откроется на http://localhost:8501. Если команда streamlit не найдена, используйте python -m streamlit run app.py.

Первый запуск

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

Дальше имеет смысл:

  1. Добавить модель и ключ провайдера в настройках — без ключей работают интерфейс

и лексический поиск BM25.

  1. Загрузить документы в базу знаний и задать по ним вопрос.
  2. Создать сотрудника через Employee Creator, описав задачу естественным языком.

Обновления

Платформа обновляет себя сама: при холодном старте применяются уже скачанные обновления, а раздел «Обновления» показывает состояние файлов и позволяет поставить новую версию. Перед применением файлы сверяются по контрольным суммам, поэтому недокачанный файл не попадёт в работу.

Тесты

python -m pytest

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