Локальная установка
Установите и запустите стек одним скриптом установки или склонируйте репозиторий и запустите вручную.
1. Быстрая установка через install.sh
Установщик скачивает tagged-релиз, собирает образ локально и запускает стек; образ/профиль выбирает установщик. Повторный запуск обновляет на месте. Явная версия: VERSION=0.1.0 sh install.sh.
curl -fsSL https://raw.githubusercontent.com/Arttron/aigentron/main/install.sh | shИли клонируйте исходники (опционально)
git clone https://github.com/Arttron/aigentron.git
cd aigentronТребования
- Docker Desktop или Docker Engine + Compose v2 (обязательно)
- Опционально: Ollama, запущенная на хосте (не в контейнере), для routine-модели — лишь один из вариантов провайдера, а не обязательное требование. Оркестратор обращается к ней через http://host.docker.internal:11434
- ANTHROPIC_API_KEY — для complex-модели (облачный Claude)
- Опционально: модель с поддержкой инструментов в вашем Ollama на хосте (по умолчанию qwen3-coder:30b, задаётся через ROUTINE_MODEL в .env) — только если вы выбрали Ollama
- Опционально: одноразовая Docker-сеть, чтобы агенты находили БД проектов по имени сервиса (docker network create lds-agents) — только для compose-сценария с агентами
- Если вы всё же используете Ollama, избегайте qwen2.5-coder — он не поддерживает структурированные вызовы инструментов и ломает SDK агентов. Поддерживаемый стандарт — qwen3-coder:30b.
2. Опционально: локальные модели через Ollama
Только если вы выбрали Ollama в качестве провайдера. Загрузите в Ollama на хосте (не в контейнер); укажите ROUTINE_MODEL в .env, если выбрали другую модель.
ollama pull qwen3-coder:30b3. Опционально: внешняя Docker-сеть
Одноразовая настройка, нужна только для compose-сценария с агентами — чтобы агенты находили БД по имени сервиса.
docker network create lds-agents4. Из исходников: сборка и запуск
Для сборки из исходников: эквивалент docker compose up -d --build. Поднимает Postgres, Redis, LiteLLM (Anthropic-совместимый прокси перед Ollama), оркестратор (:3001) и dashboard (:3000), всё с bind-mount для горячей перезагрузки. Первый запуск медленнее — оркестратор компилирует packages/shared и packages/agent-runner до прохождения healthcheck.
make up5. Откройте dashboard
Dashboard → http://localhost:3000 • API оркестратора → http://localhost:3001 Показаны значения по умолчанию; в некоторых конфигурациях порт dashboard может отличаться — переопределите его через маппинг портов (compose или docker run -p). Опционально: docker compose --profile mcp up -d для Playwright MCP и dev-сервера для frontend/design-агентов.
Полезные команды: make logs | make ps | make migrate | make down | make clean (⚠️ удаляет данные БД). Более подробная документация по настройке, маршрутизации моделей и approval gate — в репозитории.
