Постоянная память для артефактов CARL: шагов (steps), цепочек (chains), агентов (agents) и карт памяти (memory cards).

• Docker и Docker Compose
• GNU Make
• Python 3.10+ и uv для автономной локальной работы

make up
# Приостановить стек без удаления контейнеров
make stop

Теперь команда make up автоматически применяет миграции Alembic перед запуском API. Команда make migrate остается доступной, если вы хотите запустить обновление схемы явно.

• API: http://localhost:8002
• Swagger UI: http://localhost:8002/docs
• Веб-интерфейс (Web UI): http://localhost:7861

Развертывание compose по умолчанию публикует только API и Web UI. PostgreSQL и Redis остаются внутренними для сети Docker. Используйте make psql или make redis-cli, если вам нужен shell-доступ к этим сервисам.

Установите эти переменные в deploy/.env или экспортируйте их перед запуском make up:

MEMORY_API_HOST_PORT=8002
MEMORY_WEB_UI_HOST_PORT=7861

Автономные запуски API и UI сохраняют свои исходные настройки по умолчанию, если вы не переопределите их явно:

• Примеры API в клиентской документации могут использовать http://localhost:8000
• Автономный процесс Gradio UI по умолчанию использует http://localhost:7860

Эти автономные настройки по умолчанию не зависят от описанного выше стека Docker Compose.

• Шаги (Steps) — Одиночные шаги рассуждения (LLM, Инструмент, MCP, Память, Преобразование, Условие)
• Цепочки (Chains) — Последовательности шагов с зависимостями
• Агенты (Agents) — Полные конфигурации агентов
• Карты памяти (Memory Cards) — Многократно используемые паттерны и знания

• Неизменяемая история версий
• Привязка к каналам (latest, stable, custom)
• Различия (diff) между версиями
• Откат к предыдущим версиям

• Полнотекстовый поиск
• Фильтрация по типу сущности
• Фильтрация по тегам
• Фасетный поиск

• Просмотр сущностей по типам
• Редактирование содержимого сущностей (редактор JSON)
• Поиск по всем сущностям
• Мониторинг статуса подключения

┌─────────────────────────────┐
│  Web UI                     │  Gradio
│  host 7861 -> container 7860│
└──────────────┬──────────────┘
               │
               ▼
┌─────────────────────────────┐
│  FastAPI API                │  REST API
│  host 8002 -> container 8000│
└──────────────┬──────────────┘
               │
               ├─────────┐
               ▼         ▼
┌──────────────┐ ┌──────────────┐
│ PostgreSQL   │ │ Redis        │
│ internal only│ │ internal only│
└──────────────┘ └──────────────┘

• Swagger UI: http://localhost:8002/docs
• Спецификация OpenAPI: openapi.yaml

make test
make test-integration
make client-test

MIT