# Alicorn Agent 

Автономный агент-исследователь для **локальных** 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).