git404hub

what is agentcanvas fr?

vstorm-co/agentcanvas — explained in plain English

Analysis updated 2026-05-18

24PythonAudience · developerComplexity · 2/5LicenseSetup · easy

tl;dr

A Python library that turns Pydantic AI agent logs from Logfire into an interactive HTML diagram showing what the agent did and what it cost.

vibe map

mindmap
  root((agentcanvas))
    What it does
      Read Logfire logs
      Build HTML diagram
      Show cost and reasoning
    Tech stack
      Python
      Pydantic AI
      Logfire
    Use cases
      Agent debugging
      Client presentations
      Cost tracking
    Audience
      Developers
      AI agent builders

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

what do people make with this?

VIBE 1

Visualize an AI agent's full decision and tool call sequence as a diagram.

VIBE 2

Inspect the exact token cost and reasoning behind each step of an agent run.

VIBE 3

Share a self contained HTML report of an agent run with a client or teammate, no server needed.

VIBE 4

Walk through an agent's behavior in a guided, step by step presentation mode.

what's the stack?

PythonPydantic AILogfire

how it stacks up fr

vstorm-co/agentcanvas0311119/free_registertool18597990650-lab/multi-agent-game
Stars242424
LanguagePythonPythonPython
Setup difficultyeasyhardmoderate
Complexity2/54/53/5
Audiencedeveloperdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

how do i run it?

Difficulty · easy time til it works · 5min

Requires a Logfire read token and Python 3.12 or newer.

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

in plain english

agentcanvas is a Python library that turns AI agent activity logs into an interactive, visual diagram. When you build a conversational AI agent using Pydantic AI and log its activity to Logfire (a tracing service), agentcanvas reads those logs and generates a single HTML file you can open in any browser to see exactly what the agent did and how much it cost. The output shows the full sequence of events in a block diagram: the user's question, the AI model's decisions, each external tool or function the model called, and the final answer. If your agent uses smaller specialized agents inside it (nested sub-agents), those appear as labeled frames within the diagram, so the structure stays readable no matter how many layers deep the system goes. You can click any step to open an inspector panel showing input and output token counts, exact dollar cost, the model's reasoning, which tools were available, and timing information. For presentations or client meetings, a guided tour mode walks through the diagram step by step with plain-language narration, either automatically or at your own pace using the spacebar or arrow keys. Each conversation turn is displayed in a side panel showing the full back-and-forth transcript between the user and the assistant, including any tool calls in between. Installation is one command: pip install agentcanvas. You provide a Logfire read token, run the command-line tool, and it fetches your most recent agent run and opens a self-contained HTML report in your browser. The file requires no server and works offline, so sharing it is as simple as attaching it to an email. The library can also be imported directly into Python scripts for custom reporting. The project is MIT-licensed and requires Python 3.12 or newer.

prompts (copy fr)

prompt 1
Show me how to install agentcanvas and generate an HTML report from my latest Pydantic AI agent run.
prompt 2
Explain how to read the token cost and reasoning shown in agentcanvas's inspector panel.
prompt 3
Help me set up the guided tour mode to present an agent's decision flow to a client.
prompt 4
Show me how to import agentcanvas directly into a Python script for custom reporting.

Frequently asked questions

what is agentcanvas fr?

A Python library that turns Pydantic AI agent logs from Logfire into an interactive HTML diagram showing what the agent did and what it cost.

What language is agentcanvas written in?

Mainly Python. The stack also includes Python, Pydantic AI, Logfire.

What license does agentcanvas use?

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is agentcanvas to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is agentcanvas for?

Mainly developer.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.