protoAgentA lean, A2A-native agent you own

A small core on LangGraph that grows with git-URL plugins. Run one agent or orchestrate a fleet — from a console, the OpenAI API, or A2A. Local-first, yours to fork.

Spin up your first agent

Run headless

A2A-native, built for fleets

Every agent is a spec-compliant A2A 1.0 server — agent card, JSON-RPC over /a2a, SSE streaming, tasks/* lifecycle, push. Delegate to other a2a / openai / acp endpoints; run one or orchestrate many.

cost-v1 + trace propagation

Every terminal task emits a cost-v1 DataPart with token usage and wall time. a2a.trace metadata nests this agent's Langfuse trace under the caller's.

Free starter tools

DuckDuckGo web search, URL fetch, safe calculator, and IANA-timezone clock — zero API keys, enough to demo a real research loop on a fresh clone.

A lean core, opt-in plugins

Start small; add tools, skills, subagents, workflows, FastAPI routes, console dashboards, memory backends, and managed MCP servers as git-URL plugins (python -m server plugin install, pinned in plugins.lock) — without touching core. Discord, Google (Gmail+Calendar), and the plugin-devkit ship first-party.

Release pipeline

Dispatch prepare-release → semver bump PR → merge → tag → GHCR image → GitHub release → Discord embed. Flip the RELEASE_ENABLED repo variable to enable it on a fork.

Documentation Structure

This site follows the Diátaxis framework:

Section	Purpose	Start here if you…
Tutorials	Learning-oriented walkthroughs	Are about to fork protoAgent for the first time
How-To Guides	Task-oriented procedures	Need to accomplish a specific change in a fork
Reference	Technical descriptions	Need exact details on an API, config key, or extension
Explanation	Understanding-oriented discussion	Want to understand why the template is shaped this way

Canonical reference implementation

protoLabsAI/roxy is a filled-in fork built on this template — an autonomous ProtoMaker portfolio manager (persona, A2A skills, project registry). When the docs here don't cover something specific, Roxy is the filled-in example to consult.