Skip to content

Hanzo Python SDK

The complete Python SDK for building AI applications with Hanzo AI infrastructure.

Overview

The Hanzo Python SDK provides:

  • Agent SDK (hanzo-agent) - Build agentic AI applications with a lightweight, production-ready framework
  • MCP Server (hanzo-mcp) - Model Context Protocol server with 30+ tools for AI code assistants
  • Tool Packages (hanzo-tools-*) - Modular tool packages for file operations, shell commands, browser automation, and more

Installation

pip install hanzo-mcp[tools-all]

pip install hanzo-agent

uv pip install hanzo-mcp

Quick Start

Using with Claude Code

The easiest way to use Hanzo MCP is with Claude Code:

# Install globally
uvx hanzo-mcp

# Or run directly
uvx hanzo-mcp --transport stdio

Agent SDK Example

from agents import Agent, Runner

agent = Agent(
    name="assistant",
    instructions="You are a helpful assistant."
)

result = Runner.run_sync(agent, "Hello!")
print(result.final_output)

MCP Tools Example

from hanzo_mcp import create_mcp_server

# Create server with all tools
server = create_mcp_server()
server.run()

Packages

Package Description PyPI
hanzo-mcp MCP server with all tools PyPI
hanzo-agent Agent SDK PyPI
hanzo-tools-shell Shell/command tools PyPI
hanzo-tools-fs File system tools PyPI
hanzo-tools-browser Browser automation PyPI
hanzo-tools-memory Memory/knowledge tools PyPI

Features

30+ MCP Tools

  • File System: read, write, edit, tree, find, search, ast
  • Shell: cmd, zsh, bash, ps, npx, uvx, open
  • Browser: Full Playwright automation with 70+ actions
  • Memory: Unified memory tool with recall, create, update, delete
  • Reasoning: think, critic for structured AI reasoning
  • LSP: Go-to-definition, find references, rename, hover
  • Refactor: Advanced code refactoring with AST support
  • Agent: Run external AI agents (Claude, Gemini, Codex, etc.)
  • LLM: Direct LLM access and multi-model consensus

Auto-Backgrounding

Long-running commands automatically background after 30 seconds:

# This will auto-background if it takes too long
cmd("npm install")

# Check status
ps()  # List all background processes
ps(logs="cmd_xxx")  # View output
ps(kill="cmd_xxx")  # Stop process

Multi-Backend Support

Use the MCP with any AI assistant:

  • Claude Code - uvx hanzo-mcp
  • VS Code/Cursor - Hanzo extension with auto-detection
  • Antigravity - Full integration via Open VSX
  • Any MCP Client - Standard MCP protocol

Documentation

Getting Started

Reference

Tool Categories