​
Системные требования для локального запуска

​
Минимальные требования

  • RAM: 8 GB (4 GB доступны Docker)
  • Storage: 10 GB свободного места
  • CPU: 2 ядра (x86_64 или ARM64)
  • OS:
    • macOS 10.15+ (Catalina или новее)
    • Windows 10/11 с WSL2
    • Linux с kernel 3.10+

​
Требования к ПО

Чтобы запустить Агентику локально, убедитесь, что установлены:
  • Docker версии 20.10 или новее
  • curl — обычно уже установлен на macOS/Linux
Docker Compose входит в Docker Desktop. Перед началом убедитесь, что Docker запущен.

​
Ресурсы Docker

Если вы используете Docker Desktop, выделите Docker достаточно ресурсов:
  1. Откройте настройки Docker Desktop
  2. Перейдите в Resources
  3. Выделите минимум:
    • Memory: 4 GB (рекомендуется 8 GB)
    • CPUs: 2 (рекомендуется 4)
    • Disk: 10 GB

​
Необходимые порты

Убедитесь, что доступны эти порты:
  • 3010 — Web UI
  • 8000 — API Server
  • 5432 — PostgreSQL
  • 6379 — Redis
  • 9000 — MinIO (S3-compatible storage)
  • 9001 — MinIO Console

​
Проверка доступности порта

Проверьте, занят ли порт (замените 3010 на нужный номер):

​
Docker Registry

Образы Агентики публикуются в наш приватный GitHub Container Registry: ghcr.io/zuzla. Образы приватные, поэтому сначала выполните вход с токеном GitHub, имеющим read:packages:
При деплое через remote_up.sh можно не логиниться вручную: задайте GHCR_PAT=<PAT с read:packages> в .env — скрипт залогинится сам перед pull. Startup-скрипт по умолчанию использует этот registry. Чтобы задать его явно, экспортируйте переменную окружения REGISTRY перед запуском startup-скрипта: