Skip to content

multi-agent-orchestration v0.1.0 — bounded specialists, visible policy

Choose a tag to compare

View all tags
@pabloalvarez99 pabloalvarez99 released this 14 Aug 04:37
v0.1.0
e2687ca

multi-agent-orchestration v0.1.0 — bounded specialists, visible policy

The first public release of portfolio project P3. It demonstrates coordination mechanics on
a deterministic, credential-free default path; it does not claim model-quality uplift.

LIVE in this release

  • Typed Research, Critic, and Writer handoffs over an in-memory bus.
  • Writer-only user-facing final output, global handoff budgets, at most two Research retries,
    and explicit degraded or budget_exhausted terminal states.
  • Ordered JSON-safe traces without full task text or fake-path wall-clock timestamps.
  • Library, POST /v1/tasks, JSON CLI, and accessible server-rendered task console.
  • Optional P2 HTTP Research behind explicit AGENTIC_RAG_URL; fake remains the default.
  • Fail-closed handling for missing configuration, timeout, transport, HTTP, and contract
    failures. P2's raw trace is not copied into P3's result.
  • Twelve deterministic routing/accounting goldens plus two zero-network boundary cases,
    reported as provider="fake" and billed_usd=0.0.
  • Python 3.12 CI gates for ruff, strict mypy, pytest, and the evaluation runner.
  • Non-root Docker image and standalone P3 Compose service.

PLANNED or deliberately not claimed

  • Hosted LLMs as the default, a hosted public demo, and the P5 multi-service platform.
  • Remote-process specialist isolation or a claim that separate models improve answer quality.
  • Live P2 availability in CI. The live integration smoke remains opt-in and skips when P2 is
    unset or unavailable; mocked tests prove the boundary contract.
  • Quality or factuality gains from the fake specialists. The goldens measure policy,
    ownership, routing, budgets, trace shape, and accounting only.

Reproduce the free path

python -m pip install -e ".[dev]"
ruff check .
mypy src/mao
pytest -q
python -m mao.evals.run
python -m mao.task --task "Compare hybrid vs dense retrieval in one paragraph"
python -m uvicorn mao.main:app --port 8000

The browser console is then available at http://127.0.0.1:8000/.

Assets 2
Loading