Agent2

Turn domain experts into production AI agents.

Not just how they think — how they work. The tools, the books, the memory, the judgment calls.

Quick start — 2 minutes

Requirements: Claude Code (or Codex, Cursor, Gemini CLI), Docker, Python 3.12+ with uv

Step 1: Clone and start

git clone https://github.com/duozokker/agent2.git
cd agent2
cp .env.example .env
docker compose up -d

Step 2: Open in your AI coding tool and clone an expert

Open the repo in Claude Code (or Codex, Cursor, Gemini CLI). Then type:

Clone a tax accountant who processes invoices, checks regulations, and produces booking entries.

Agent2 ships with built-in skills. Your AI tool reads them, runs /brain-clone, interviews you about the domain, and generates a complete agent — prompt, tools, knowledge, schemas, Docker config. Everything.

Step 3: Deploy

docker compose build my-agent
docker compose up -d my-agent

Your expert is now a production API. Auth, typed output, knowledge search, memory, human approval — all included.

That's it. No framework to learn. Your AI coding tool IS the interface.

What Agent2 does

Every company has domain experts whose knowledge is trapped in their heads. An accountant who knows which DATEV account to use. A lawyer who spots the risky clause. A compliance officer who catches the violation.

Agent2 clones their entire workplace into an AI agent:

What we clone                         How
─────────────────────────────────────────────────────────
How the expert thinks                 Chain-of-Thought prompt
What tools they use                   Tool integrations (DB, email, lookups)
Which books they read                 Knowledge search (R2R collections)
What they remember                    Persistent memory between sessions
When they ask for help                Pause/resume + clarifying questions
What needs sign-off                   Sandbox tools + human approval
What they produce                     Pydantic-validated typed output

The result is a production HTTP service — not a chatbot, not a prompt wrapper. A typed API you call a million times.

Feature matrix

Build your first agent

1. Copy the template

cp -r agents/_template agents/my-agent

2. Define your output

# agents/my-agent/schemas.py
from pydantic import BaseModel, Field

class InvoiceSummary(BaseModel):
    vendor: str = Field(description="Vendor name")
    total: float = Field(gt=0, description="Total amount in EUR")
    account_code: str = Field(description="Suggested booking account")
    confidence: float = Field(ge=0.0, le=1.0)

3. Create the agent

# agents/my-agent/agent.py
from shared.runtime import create_agent
from .schemas import InvoiceSummary

agent = create_agent(
    name="my-agent",
    output_type=InvoiceSummary,
    instructions=(
        "You are an experienced accountant with 20 years in practice. "
        "When you receive an invoice, think step by step: "
        "What kind of document is this? Check the client file. "
        "Validate formal requirements. Look up the right account. "
        "If anything is unclear, ask."
    ),
)

@agent.tool_plain
def lookup_vendor(name: str) -> dict:
    """Check if this vendor exists in our database."""
    return {"known": True, "default_account": "6805"}

4. Expose the API

# agents/my-agent/main.py
from shared.api import create_app
app = create_app("my-agent")

That's it. Your agent now has a production HTTP API with auth, rate limiting, structured output, async execution, and error handling.

Why not X?

Stack

Agent2 stays close to the ecosystem instead of reinventing it:

Default vs. full stack

Default (docker compose up -d) — fast developer loop:

• Postgres, Redis, Langfuse
• example-agent, support-ticket, code-review, invoice, approval-demo, resume-demo, provider-policy-demo

Full (docker compose --profile full up -d) — complete platform:

• Everything above + R2R, Docling, Temporal, Knowledge MCP
• rag-test, scoped-tools-demo

Documentation

AI-assisted development

Agent2 ships with built-in skills for AI coding tools. Open this repo in Claude Code, Cursor, Codex, or Gemini CLI and your agent already knows how to work with the framework.

Skills follow the open SKILL.md standard and are available in .claude/skills/, .codex/skills/, .gemini/skills/, and .github/skills/.

Design principles

• Framework code lives in shared/. Product logic lives in agent modules.
• Capabilities are opt-in. Pause/resume, approvals, knowledge, tool scoping — use what you need.
• Prompts are code-first. Langfuse is optional for iteration and observability, not a requirement.
• Errors are RFC 7807. Every failure returns application/problem+json.
• No lock-in. Standard Python, standard Docker, standard FastAPI. Deploy anywhere.

Status

Agent2 provides production-tested primitives for turning domain expertise into AI agents — born from real enterprise work processing millions of documents for German tax firms.

Current release: v0.1.0 (pre-release, API stable for core features)

What's here

• Typed agent creation with create_agent()
• Full HTTP API with create_app()
• Sync and async task execution
• Pause/resume with serialized message history
• Human-in-the-loop approval workflows
• Provider-aware execution with cache routing
• Tool interception and collection scoping
• Mock mode for development without LLM keys
• 39 unit tests covering framework primitives
• GitHub Actions CI with lint + test + Docker verify
• 5 built-in skills for AI coding tools (Claude Code, Codex, Gemini CLI, Copilot)

Roadmap

• PyPI package (pip install agent2)
• Agent2 Cloud (managed hosting + dashboard)
• CLI for agent scaffolding
• Multi-agent orchestration primitives
• WebSocket streaming for long-running tasks
• Plugin system for community agent templates
• Brain Clone marketplace (pre-built expert templates)
• Domain expert interview UI

Built by Artesiana

Agent2 was born from production work at Artesiana, where we turn domain expertise into AI agents. The framework has powered 4M+ processed documents and $160k+ in revenue since September 2025.

We're open-sourcing the core because we believe the infrastructure for cloning domain experts should be a shared foundation, not a proprietary moat.

Built with Agent2

MandantLink — Autonomous invoice processing for tax firms

MandantLink turns a 20-year accounting veteran's expertise into an AI agent that processes invoices end-to-end: OCR → knowledge-backed analysis → clarifying questions → human approval → DATEV export. Built with Agent2's expert cloning pattern.

Have you built something with Agent2? Open a PR to add your project here.

License

MIT