👁️🧠 Verified Agents Framework

Verel

The agent framework where nothing is “done” until a grader returns a verdict — checked by real senses including eyes — and only verified work compounds into the fleet’s shared memory.

$ pip install verel
148 tests passing ruff + mypy clean MIT Ollama Cloud · OpenAI
A glowing brain with an eye, and verified work passing through a verdict gate
Eval-driven by design

The loop is the whole point

Every agent action is a hypothesis. One verdict bus unifies vision + tests + lint + types into a single pass / warn / fail — with attestation, so a hollow check can’t mint green.

An eval-driven loop of five connected nodes
✍️
Write
agent acts
👁️
Perceive
senses → percepts
⚖️
Gate
verdict bus
🛠️
Fix
agent patches
Pass
self-computed
One framework

Five organs

A brain, eyes, a verdict bus, a fleet, and agents that build their own tools — each gated by the bus.

🧠

Brain

Memory that compounds — trust + provenance, consolidation, a held-out attested promotion gate, and lifecycle controls (pin · volatile-until-confirmed · TTL · correction chains). Only verified work graduates.

verel.memory
👁️

Eyes

AgentVision as a perception organ (DOM / contrast / OCR grounded), feeding the verdict bus and the brain.

verel.senses
⚖️

Verdict bus

One schema for every sense — advisory ceiling, grader attestation, scrubbed fingerprints, stuck/progress.

verel.verdict
🚁

Fleet

Agents managing agents — an LLM manager fans out; workers run in isolated git worktrees under budget.

verel.fleet
🔧

Tool-smith

Detect → scaffold → test → register → reuse, sandboxed with bwrap, admitted only on a passing attested eval.

verel.toolsmith
♻️

Agent-run CI/CD

Self-healing pipeline with a deterministic rollback engine that never acts on advisory evidence.

verel.ci
How it works

Architecture & flow

The five organs and the eval-driven loop — hand-drawn, and verified clean by the eyes Verel ships.

Verel system architecture diagram Verel eval-driven loop diagram
At a glance

The whole story, one image

Rendered and verified by the eyes Verel ships — Verel gates its own marketing.

Verel architecture infographic — five organs and the eval-driven loop
5
organs, end-to-end
148
tests, dogfooded
1
verdict bus, all senses
MIT
open source