Claude

Using Claude Code? You do not need this page. Install the CLI and the pictograph-cv skill (Agents - overview) and Claude Code drives Pictograph itself.

This page is for building your own agent on the Anthropic SDK or the Claude Agent SDK. Toolkit setup and guardrails live on Agents - overview; here are the two Claude-specific integration paths.

Source: agents/claude.py

Path 1: Anthropic SDK (raw tool dicts)

No extra dependencies - works with the standard anthropic package. You manage the tool-use loop.

import anthropic
from pictograph.agents import create_toolkit, for_anthropic_messages

toolkit = create_toolkit()
tools = for_anthropic_messages(toolkit)
client = anthropic.Anthropic()

messages = [
    {"role": "user", "content": "Upload ./photos to a dataset called 'demo' and auto-annotate cars and people."},
]

response = client.messages.create(
    model="claude-opus-5-5",
    max_tokens=4096,
    tools=tools,
    tool_choice={"type": "auto"},
    messages=messages,
)

while response.stop_reason == "tool_use":
    tool_uses = [b for b in response.content if b.type == "tool_use"]
    tool_results = [
        {
            "type": "tool_result",
            "tool_use_id": tu.id,
            "content": str(toolkit.dispatch(name=tu.name, args=tu.input)),
        }
        for tu in tool_uses
    ]
    messages.append({"role": "assistant", "content": response.content})
    messages.append({"role": "user", "content": tool_results})
    response = client.messages.create(
        model="claude-opus-5-5",
        max_tokens=4096,
        tools=tools,
        messages=messages,
    )

print(response.content)

toolkit.dispatch(name, args) validates args through the tool’s Pydantic schema, invokes the handler, and returns a JSON-serializable result. Invalid input raises ValidationError.

Path 2: Claude Agent SDK

The Agent SDK manages the loop, streaming, and dispatch. Requires the extra:

pip install 'pictograph[agents]'

from claude_agent_sdk import ClaudeSDKClient, ClaudeAgentOptions
from pictograph.agents import create_toolkit, for_claude_agent_sdk

toolkit = create_toolkit()
agent_tools = for_claude_agent_sdk(toolkit)

async with ClaudeSDKClient(
    options=ClaudeAgentOptions(
        system_prompt="You drive Pictograph for the user. Confirm destructive operations.",
        allowed_tools=[t.name for t in agent_tools],
    ),
) as agent:
    async for response in agent.query(
        "Train a YOLOX model on the 'road-signs' dataset, A10G GPU, 50 epochs"
    ):
        print(response)

Picking between paths

See also

• Agents - toolkit setup, guardrails, and the registry
• Bundled Skill - pictograph-cv for Claude Code / claude.ai
• Cookbook - recipe-style examples