Files
alicorn-agent/README.md
T

4.6 KiB

Alicorn Agent

Статус 2026-10-15: архитектура Alicorn признана избыточной для локального железа (a2000 12GB). Выделен упрощённый проект Pegas — см. /home/neo/workspace/pegas/. Alicorn остаётся архивной полной спецификацией (Anvil, World Model, Rust-выполнитель — отложены). Память реализована в pegas-memory/.

Автономный агент-исследователь для локальных LLM.

Alicorn = агентский runtime, спроектированный для локальных моделей, а не адаптированный под них.

Ключевой принцип: «Модель предлагает — Runtime располагает»

  • LLM (Ornith) — только предлагает план в типизированном DSL. Не мутирует состояние, не вызывает инструменты напрямую.
  • Runtime (Rust) — детерминированно исполняет план. Дает скорость (без интерпретации) и точность (каждое исполнение байт-в-байт из журнала).

Почему это нужно

Существующие фреймворки (LangChain, CrewAI, AutoGen, Hermes) предполагают LLM = облачный API (дешёвый контекст, 200+ t/s, редкие ошибки). Локальные модели — наоборот: слабый контекст, 20–150 t/s, частые ошибки. Агент «задыхается» через 5–10 шагов.

Alicorn решает это через:

  1. Детерминированный Rust-выполнитель — без интерпретации, скорость и воспроизводимость.
  2. Append-only журнал (SQLite WAL) — источник правды и replay.
  3. Anvil — экономика доверия (права, репутация, бюджет, любопытство) через смарт-контракты.
  4. World Model (V-JEPA 2) — симуляция последствий до реального действия.
  5. Pegas Memory — единое хранилище (Postgres + pgvector + Apache AGE).

Архитектура (7 слоёв)

# Слой Технология Роль
1 Pegas Memory PostgreSQL + pgvector + Apache AGE Текст, векторы, граф, метаданные
2 KTL MinerU, Segnatura, gresmcp, mammoth + VLM Qwen3-VL PDF/EPUB/Web → структурированные знания
3 MCP-серверы Rust (mcport/V.E.L.O.C.I.T.Y.) Knowledge, Anvil, Tool, World Model
4 Anvil Solidity + Foundry Права, репутация, бюджет, любопытство
5 Pegas Core Rust (dsh Harness) Planner, Executor, Researcher, Decision
6 World Model V-JEPA 2 / Agentic-JEPA (wm-mcp) Симуляция последствий
7 Observability OTEL + ClickHouse + Grafana Трассировка, стоимость, качество

Допы: append-only журнал (SQLite WAL) = source of truth + replay; Dragonfly/Redis = кэш сессий; NATS JetStream = event bus.

Детерминизм и replay

  • Append-only журнал (SQLite WAL + FULL sync) — source of truth.
  • Пишутся входы/выходы (llm.request/response, tool.call/result, anvil.check), не промежуточные рассуждения.
  • Event Sourcing: состояние = детерминированная свёртка журнала через reducer.
  • Replay — байт-в-байт, верификация в CI.
  • Exactly-once через Transactional Outbox + Idempotency Key + Saga.

Внутренние драйвы

Не on-chain: любопытство, компетентность, автономность, связность.

Связь с другими проектами

  • spark-mind / «Animus» — локальный чат-бот (персона, память, дашборд). Предок Alicorn.
  • Outline (docs.qw4.ru) — вики, источник спецификации.

Стек

Ornith 1.5 A3B, Spark-X2.5-4B, Nanbeige4.1-3B, Clef-Flash, bge-m3 (эмбеддинги), PostgreSQL, pgvector, Apache AGE, V-JEPA 2, Rust.

Статус

Архитектурная спецификация зафиксирована. MVP-код — в разработке (см. ROADMAP.md).