Skip to main content

Visualize LLM conversations as a navigable canvas

Project description

LLM Canvas logo

LLM Canvas

Visualize complex LLM conversation flows in infinite canvas.

PyPI License MIT Python 3.9+

As LLM applications evolve, conversation flows become increasingly complex. Conversations may branch into multiple paths, run in parallel, or require summarization across different threads. Managing and understanding these intricate conversation flows becomes a significant challenge in LLM ops.

LLM Canvas solves this by providing a powerful visualization tool for complex conversation flows. Create branching conversation trees, explore different response paths, and visualize tool interactions through an intuitive web interface — all while maintaining complete privacy with local deployment.

📰 News

🎉 August 2025: LLM Canvas v0.1.1 released with improved branching API and enhanced web UI

🌟 Key Features

  • 🌳 Branching Conversations: Create and explore multiple conversation paths from any message
  • 🔧 Tool Call Visualization: See how your LLM uses tools with clear input/output flows
  • 📦 Zero Dependencies: Self-contained with built-in web UI

🚀 Quick Start

Installation

pip install llm-canvas

Start Local Server

# Start the local server
llm-canvas server --port 8000

# Server starts at http://localhost:8000
# Create and view your canvases in the web interface

Basic Usage

from llm_canvas import CanvasClient

# Create a client and canvas
client = CanvasClient()
canvas = client.create_canvas("My Conversation", "Exploring LLM interactions")

# Add messages
user_msg_id = client.add_message(canvas.canvas_id, "What is machine learning?", "user")
client.add_message(
    canvas.canvas_id,
    "Machine learning is a subset of AI that enables computers to learn from data...",
    "assistant",
    parent_node_id=user_msg_id
)

Use Cases

1. Conversation Branching

# Create different response paths
main_branch = canvas.checkout("main", create_if_not_exists=True)
main_branch.commit_message({"role": "user", "content": "Explain quantum computing"})

# Create alternative explanations
simple_branch = canvas.checkout("simple-explanation", create_if_not_exists=True)
simple_branch.commit_message({"role": "assistant", "content": "Quantum computing uses quantum mechanics..."})

technical_branch = canvas.checkout("technical-explanation", create_if_not_exists=True)
technical_branch.commit_message({"role": "assistant", "content": "Quantum computing leverages superposition and entanglement..."})

2. Tool Usage Visualization

# Visualize how LLMs use tools
client.add_message(canvas_id, [
    {"type": "text", "text": "I'll check the weather for you."},
    {"type": "tool_use", "id": "weather_001", "name": "get_weather", "input": {"location": "San Francisco"}}
], "assistant")

client.add_message(canvas_id, [
    {"type": "tool_result", "tool_use_id": "weather_001", "content": '{"temperature": 72, "condition": "sunny"}'}
], "user")

📝 More examplesexamples/README.md

🤝 Contributing

We welcome contributions! LLM Canvas is open source and community-driven.

LLM Canvas: Story Behind

Check out the full story to learn about the inspiration and development journey of LLM Canvas.

📄 License

MIT License - see LICENSE for details.


Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

llm_canvas-0.1.3.tar.gz (579.1 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

llm_canvas-0.1.3-py3-none-any.whl (624.5 kB view details)

Uploaded Python 3

File details

Details for the file llm_canvas-0.1.3.tar.gz.

File metadata

  • Download URL: llm_canvas-0.1.3.tar.gz
  • Upload date:
  • Size: 579.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.12.9

File hashes

Hashes for llm_canvas-0.1.3.tar.gz
Algorithm Hash digest
SHA256 74020efd9a51ce32f25c91009f7fc0eaee5b69927040266b60ed0339d94423a8
MD5 cc01eed5d60de6b7ec59d4517f78eafd
BLAKE2b-256 27ac7479357cd74551b6a639b463274ded8bc6b0d73fe0bd37c98df7871d8ba7

See more details on using hashes here.

Provenance

The following attestation bundles were made for llm_canvas-0.1.3.tar.gz:

Publisher: release.yml on LittleLittleCloud/llm-canvas

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file llm_canvas-0.1.3-py3-none-any.whl.

File metadata

  • Download URL: llm_canvas-0.1.3-py3-none-any.whl
  • Upload date:
  • Size: 624.5 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.12.9

File hashes

Hashes for llm_canvas-0.1.3-py3-none-any.whl
Algorithm Hash digest
SHA256 88d1547682839017235f42b01f7a161e62dacdf2b9ecd3cf2756ca19e922bc0e
MD5 16b6c29a8cb9c061c7f4c66372c51ef9
BLAKE2b-256 f418714612ec71ebe79ed4476a0c6d4f93a432a01f64829990ae58ec2e7143a8

See more details on using hashes here.

Provenance

The following attestation bundles were made for llm_canvas-0.1.3-py3-none-any.whl:

Publisher: release.yml on LittleLittleCloud/llm-canvas

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page