Начало работы

bash cp .env.example .env docker compose up --build -d

Интерфейс	URL
UI	http://localhost:3000
UI через Traefik	http://agentbi.localhost:8088
API	http://localhost:8000
OpenAPI docs	http://localhost:8000/docs
Traefik dashboard	http://localhost:8080

Примечание

Traefik слушает порт хоста 8088 (порт 80 часто уже занят).

Демо-вход: нажмите Sign in to demo на /login.html или откройте /demo/login.html
Учётные данные: demo@agentbi.online / demo123 (только чтение)

Регистрация: /register.html — новая организация на Free, затем оплата на странице тарифов.

При первом запуске API создаёт пользователя-администратора, публичного демо-пользователя (при DEMO_USER_ENABLED=true), записывает в лог демо API-ключ и (при SEED_DEMO_DATA=true или DEMO_SEED_ON_START=true) загружает 6 агентов и ~30 дней событий.

Проверка работоспособности

```bash curl -s http://localhost:8000/api/v1/health

{"status":"ok","service":"AgentBI","version":"…"}

curl -s http://localhost:8000/api/v1/health/ready

{"status":"ok","service":"AgentBI","database":true,"redis":true,"version":"…"}

curl -s http://localhost:8000/api/v1/version ```

Сайт документации (MkDocs)

bash pip install -r requirements-docs.txt mkdocs serve -a 127.0.0.1:8002 mkdocs build --strict # тот же контроль, что в CI workflow Docs

CI workflow .github/workflows/docs.yml собирает документацию при каждом изменении. Публикация на GitHub Pages опциональна (переменная репозитория ENABLE_GITHUB_PAGES) — бесплатные приватные репозитории не могут размещать Pages; вместо этого скачайте артефакт mkdocs-site.