Documentation¶
reactifact is a reactive, artifact-driven agent runtime. Start with the
concepts, then the recipes and patterns; the examples are the best real-world
reference.
Languages¶
English¶
| Page | What it covers |
|---|---|
| index | What reactifact is, the mental model, quick start |
| why-reactifact | the design argument: why effects, why no graph, why determinism, why versioned state |
| concepts | Context, Artifact, Patch, Agent, Produce, provenance, HITL, budget |
| sources | Retrieval: FileSystem, Embedding, CSV, Web; SourceRef |
| providers | LLMs, embedders, images, speech, video — 20+ vendors |
| recipes | fan_out_sources, materialize_doc, StatusMachine |
| patterns | HITL tool approvals, structured LLM, fallbacks, sessions |
| observability | Traces, SQLite store, dashboard, Langfuse, Postgres |
| mcp | MCP client (call remote tools) and server (expose Tools/Context as MCP) |
| viz | Mermaid rendering: blueprint, context, trace + python -m reactifact CLI |
| replay | Record & replay (§55): ReplayLLM, state replay, replay CLI |
| branching | Fork & merge (§39-§40): branch(), three-way merge(), BranchStore |
| effects | The produce contract & mental model (§24): self.effects, Patch = runtime transport |
| eval | Multi-level evaluation (§56): evidence/claim/provenance/calc/answer metrics |
| examples | knowledge, research, medic-lab, devops, repair |
| port-matrix | how canonical patterns (LangGraph/LangChain/CrewAI/…) map to our idioms + examples/ |
| release | versioning, changelog, build/verify/publish |
| api | Public API reference (top-level symbols) |
| design-notes/adaptive | Design notes for the adaptive scheduler (Scheduler, uncertainty_policy, §24/§26) — English only |
| design-notes/patches | Design notes for the effects → Patch compilation model (§12-§13) — English only |
Русский¶
| Страница | О чём |
|---|---|
| index | Что такое reactifact, ментальная модель, быстрый старт |
| why-reactifact | дизайн-аргумент: почему effects, почему без графа, почему детерминизм, почему версионируемое состояние |
| concepts | Context, Artifact, Patch, Agent, Produce, provenance, HITL, баджеты |
| sources | Получение данных: FileSystem, Embedding, CSV, Web; SourceRef |
| providers | LLM, эмбединги, изображения, речь, видео — 20+ вендоров |
| recipes | fan_out_sources, materialize_doc, StatusMachine |
| patterns | HITL-подтверждение инструментов, structured LLM, фолбэки, сессии |
| observability | Трейсы, SQLite-хранилище, дашборд, Langfuse, Postgres |
| mcp | MCP-клиент (вызов удалённых инструментов) и сервер (отдать Tool/Context как MCP) |
| viz | Рендер в Mermaid: blueprint, context, trace + CLI python -m reactifact |
| replay | Запись и воспроизведение (§55): ReplayLLM, реплей состояния, CLI replay |
| branching | Форк и слияние (§39-§40): branch(), трёхсторонний merge(), BranchStore |
| effects | Контракт produce и ментальная модель (§24): self.effects, Patch = транспорт рантайма |
| eval | Многоуровневая оценка (§56): метрики evidence/claim/provenance/calc/answer |
| examples | knowledge, research, medic-lab, devops, repair |
| port-matrix | как канонические паттерны (LangGraph/LangChain/CrewAI/…) мапятся на наши идиомы + examples/ |
| release | версионирование, чейджлог, сборка/проверка/публикация |
| api | Справочник публичного API (символы верхнего уровня) |
| design-notes/adaptive | Design-заметки об адаптивном планировщике (Scheduler, uncertainty_policy, §24/§26) — только на английском |
| design-notes/patches | Design-заметки о компиляции effects → Patch (§12-§13) — только на английском |