mirror of https://github.com/hanzoai/python-sdk.git synced 2026-10-23 20:23:00 +00:00

Files

T

zeekay a0387b1604 fix(docs): correct auto-background timeout from 45s to 30s

The auto-backgrounding timeout was changed to 30 seconds but
documentation still referenced 45 seconds. Updated all occurrences.

2026-01-05 17:30:53 -08:00

3.5 KiB

Raw Blame History

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

=== "Full Install" bash pip install hanzo-mcp[tools-all]

=== "Agent SDK Only" bash pip install hanzo-agent

=== "Using uv" bash 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
`hanzo-agent`	Agent SDK
`hanzo-tools-shell`	Shell/command tools
`hanzo-tools-fs`	File system tools
`hanzo-tools-browser`	Browser automation
`hanzo-tools-memory`	Memory/knowledge tools

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

3.5 KiB Raw Blame History