llm-canvas


Namellm-canvas JSON
Version 0.1.6 PyPI version JSON
download
home_pageNone
SummaryVisualize complex LLM conversation flows in infinite canvases
upload_time2025-08-23 19:14:21
maintainerNone
docs_urlNone
authorLittleLittleCloud
requires_python>=3.9
licenseMIT
keywords ai chat llm visualization
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            <p align="center">
    <img src="web_ui/public/assets/logo-icon-badge.svg" width="120" height="120" alt="LLM Canvas logo" />
  
</p>

<h1 align="center">LLM Canvas</h1>

<p align="center"><strong>Visualize complex LLM conversation flows in infinite canvas.</strong></p>

<p align="center">
    <a href="https://pypi.org/project/llm-canvas/"><img src="https://img.shields.io/pypi/v/llm-canvas" alt="PyPI" /></a>
    <a href="https://littlelittlecloud.github.io/llm-canvas/"><img src="https://img.shields.io/badge/Website-LLM_Canvas-blue" alt="Website" /></a>
    <img src="https://img.shields.io/badge/License-MIT-green" alt="License MIT" />
    <img src="https://img.shields.io/badge/Python-3.9%2B-blue" alt="Python 3.9+" />
</p>

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

```bash
pip install llm-canvas
```

### Start Local Server

```bash
# 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

```python
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**

```python
# 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**

```python
# 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 examples** → [examples/README.md](examples/README.md)

## 🤝 Contributing

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

- 🐛 **Bug Reports**: [GitHub Issues](https://github.com/LittleLittleCloud/llm_canvas/issues)
- 💡 **Feature Requests**: [GitHub Discussions](https://github.com/LittleLittleCloud/llm_canvas/discussions)
- 🔀 **Pull Requests**: See our [Contributing Guide](CONTRIBUTING.md)
- 📖 **Documentation**: Help improve our docs

## LLM Canvas: Story Behind

Check out the [full story](https://dev.to/littlelittlecloud/llm-canvas-the-story-behind-11i6) to learn about the inspiration and development journey of LLM Canvas.

## 📄 License

MIT License - see [LICENSE](LICENSE) for details.

---

            

Raw data

            {
    "_id": null,
    "home_page": null,
    "name": "llm-canvas",
    "maintainer": null,
    "docs_url": null,
    "requires_python": ">=3.9",
    "maintainer_email": null,
    "keywords": "ai, chat, llm, visualization",
    "author": "LittleLittleCloud",
    "author_email": null,
    "download_url": "https://files.pythonhosted.org/packages/fd/2f/14c41c6e30bbe82fddad5c4cc30bce46c1aaf89f5ac75f3946fb9a40a919/llm_canvas-0.1.6.tar.gz",
    "platform": null,
    "description": "<p align=\"center\">\n    <img src=\"web_ui/public/assets/logo-icon-badge.svg\" width=\"120\" height=\"120\" alt=\"LLM Canvas logo\" />\n  \n</p>\n\n<h1 align=\"center\">LLM Canvas</h1>\n\n<p align=\"center\"><strong>Visualize complex LLM conversation flows in infinite canvas.</strong></p>\n\n<p align=\"center\">\n    <a href=\"https://pypi.org/project/llm-canvas/\"><img src=\"https://img.shields.io/pypi/v/llm-canvas\" alt=\"PyPI\" /></a>\n    <a href=\"https://littlelittlecloud.github.io/llm-canvas/\"><img src=\"https://img.shields.io/badge/Website-LLM_Canvas-blue\" alt=\"Website\" /></a>\n    <img src=\"https://img.shields.io/badge/License-MIT-green\" alt=\"License MIT\" />\n    <img src=\"https://img.shields.io/badge/Python-3.9%2B-blue\" alt=\"Python 3.9+\" />\n</p>\n\nAs 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.\n\nLLM 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 \u2014 all while maintaining complete privacy with local deployment.\n\n## \ud83d\udcf0 News\n\n**\ud83c\udf89 August 2025**: LLM Canvas v0.1.1 released with improved branching API and enhanced web UI\n\n## \ud83c\udf1f Key Features\n\n- **\ud83c\udf33 Branching Conversations**: Create and explore multiple conversation paths from any message\n- **\ud83d\udd27 Tool Call Visualization**: See how your LLM uses tools with clear input/output flows\n- **\ud83d\udce6 Zero Dependencies**: Self-contained with built-in web UI\n\n## \ud83d\ude80 Quick Start\n\n### Installation\n\n```bash\npip install llm-canvas\n```\n\n### Start Local Server\n\n```bash\n# Start the local server\nllm-canvas server --port 8000\n\n# Server starts at http://localhost:8000\n# Create and view your canvases in the web interface\n```\n\n### Basic Usage\n\n```python\nfrom llm_canvas import CanvasClient\n\n# Create a client and canvas\nclient = CanvasClient()\ncanvas = client.create_canvas(\"My Conversation\", \"Exploring LLM interactions\")\n\n# Add messages\nuser_msg_id = client.add_message(canvas.canvas_id, \"What is machine learning?\", \"user\")\nclient.add_message(\n    canvas.canvas_id,\n    \"Machine learning is a subset of AI that enables computers to learn from data...\",\n    \"assistant\",\n    parent_node_id=user_msg_id\n)\n```\n\n### Use Cases\n\n#### 1. **Conversation Branching**\n\n```python\n# Create different response paths\nmain_branch = canvas.checkout(\"main\", create_if_not_exists=True)\nmain_branch.commit_message({\"role\": \"user\", \"content\": \"Explain quantum computing\"})\n\n# Create alternative explanations\nsimple_branch = canvas.checkout(\"simple-explanation\", create_if_not_exists=True)\nsimple_branch.commit_message({\"role\": \"assistant\", \"content\": \"Quantum computing uses quantum mechanics...\"})\n\ntechnical_branch = canvas.checkout(\"technical-explanation\", create_if_not_exists=True)\ntechnical_branch.commit_message({\"role\": \"assistant\", \"content\": \"Quantum computing leverages superposition and entanglement...\"})\n```\n\n#### 2. **Tool Usage Visualization**\n\n```python\n# Visualize how LLMs use tools\nclient.add_message(canvas_id, [\n    {\"type\": \"text\", \"text\": \"I'll check the weather for you.\"},\n    {\"type\": \"tool_use\", \"id\": \"weather_001\", \"name\": \"get_weather\", \"input\": {\"location\": \"San Francisco\"}}\n], \"assistant\")\n\nclient.add_message(canvas_id, [\n    {\"type\": \"tool_result\", \"tool_use_id\": \"weather_001\", \"content\": '{\"temperature\": 72, \"condition\": \"sunny\"}'}\n], \"user\")\n```\n\n\ud83d\udcdd **More examples** \u2192 [examples/README.md](examples/README.md)\n\n## \ud83e\udd1d Contributing\n\nWe welcome contributions! LLM Canvas is open source and community-driven.\n\n- \ud83d\udc1b **Bug Reports**: [GitHub Issues](https://github.com/LittleLittleCloud/llm_canvas/issues)\n- \ud83d\udca1 **Feature Requests**: [GitHub Discussions](https://github.com/LittleLittleCloud/llm_canvas/discussions)\n- \ud83d\udd00 **Pull Requests**: See our [Contributing Guide](CONTRIBUTING.md)\n- \ud83d\udcd6 **Documentation**: Help improve our docs\n\n## LLM Canvas: Story Behind\n\nCheck out the [full story](https://dev.to/littlelittlecloud/llm-canvas-the-story-behind-11i6) to learn about the inspiration and development journey of LLM Canvas.\n\n## \ud83d\udcc4 License\n\nMIT License - see [LICENSE](LICENSE) for details.\n\n---\n",
    "bugtrack_url": null,
    "license": "MIT",
    "summary": "Visualize complex LLM conversation flows in infinite canvases",
    "version": "0.1.6",
    "project_urls": {
        "Homepage": "https://github.com/LittleLittleCloud/llm_canvas"
    },
    "split_keywords": [
        "ai",
        " chat",
        " llm",
        " visualization"
    ],
    "urls": [
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "ffb51e114e2c45d51162a0a553542bc3016ec20edbcbb818b16d9189b49e8aed",
                "md5": "62a5b0b25562d5253827a98b20e8204a",
                "sha256": "8c4ee1f54c82703381cd43b2c730a1558878cac251bfe23f10a977a9a554fda5"
            },
            "downloads": -1,
            "filename": "llm_canvas-0.1.6-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "62a5b0b25562d5253827a98b20e8204a",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.9",
            "size": 615007,
            "upload_time": "2025-08-23T19:14:19",
            "upload_time_iso_8601": "2025-08-23T19:14:19.586927Z",
            "url": "https://files.pythonhosted.org/packages/ff/b5/1e114e2c45d51162a0a553542bc3016ec20edbcbb818b16d9189b49e8aed/llm_canvas-0.1.6-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "fd2f14c41c6e30bbe82fddad5c4cc30bce46c1aaf89f5ac75f3946fb9a40a919",
                "md5": "9b5de62808f5f922fe65ec67999d80a0",
                "sha256": "1eab946fa5636b4904dd3fcc408d562721074664960a12c35c8b01390551c74b"
            },
            "downloads": -1,
            "filename": "llm_canvas-0.1.6.tar.gz",
            "has_sig": false,
            "md5_digest": "9b5de62808f5f922fe65ec67999d80a0",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.9",
            "size": 568928,
            "upload_time": "2025-08-23T19:14:21",
            "upload_time_iso_8601": "2025-08-23T19:14:21.263539Z",
            "url": "https://files.pythonhosted.org/packages/fd/2f/14c41c6e30bbe82fddad5c4cc30bce46c1aaf89f5ac75f3946fb9a40a919/llm_canvas-0.1.6.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2025-08-23 19:14:21",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "LittleLittleCloud",
    "github_project": "llm_canvas",
    "github_not_found": true,
    "lcname": "llm-canvas"
}
        
Elapsed time: 0.79376s