Files
skills/public/hanzo-aci.html
zeekayandHanzo Dev 9e10c1c10e Each llms index points at the other two
hanzoskills.com/llms.txt now opens with the install line, the API
reference index and the company index, so an agent that lands on any
one of the three can find the rest.

robots.txt claimed 537 documents while llms.txt counts 920. The number
is gone from robots.txt; llms.txt derives it.

public/ is regenerated from scripts/site.py, which it had fallen
behind: the copy-prompt menu and agent bar were in the generator and
not in the committed pages. tests/site.mjs passes against the result.

Co-authored-by: Hanzo Dev <[email protected]>
2026-09-11 00:27:59 -07:00

366 lines
24 KiB
HTML

<!doctype html>
<html lang="en"><head>
<meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1">
<title>hanzo-aci</title>
<meta name="color-scheme" content="dark">
<style>
/* Committed to one visual world: a dark instrument panel. No light variant —
the dot field and the hairline rules only read on black, and a naive
inversion would wash both out. Every colour is painted explicitly so the page
never borrows a host background. */
@font-face{font-family:'Zen';src:url('/fonts/Zen-Variable.woff2') format('woff2');font-weight:100 900;font-style:normal;font-display:swap}
@font-face{font-family:'Zen';src:url('/fonts/Zen-Italic-Variable.woff2') format('woff2');font-weight:100 900;font-style:italic;font-display:swap}
@font-face{font-family:'Zen Mono';src:url('/fonts/ZenMono-Variable.woff2') format('woff2');font-weight:100 900;font-style:normal;font-display:swap}
@font-face{font-family:'Zen Mono';src:url('/fonts/ZenMono-Italic-Variable.woff2') format('woff2');font-weight:100 900;font-style:italic;font-display:swap}
@font-face{font-family:'Zen Pixel Square';src:url('/fonts/ZenPixel-Square.woff2') format('woff2');font-style:normal;font-display:swap}
:root{
--ink:#f4f4f2; --soft:#9c9c98; --faint:#6a6a66; --ground:#000; --panel:#0a0a0a;
--line:#232323; --line-hi:#3a3a3a; --accent:#f4f4f2;
--font-zen-sans:'Zen',-apple-system,BlinkMacSystemFont,"Segoe UI",Helvetica,Arial,sans-serif;
--font-zen-mono:'Zen Mono',ui-monospace,"SF Mono",SFMono-Regular,Menlo,Consolas,monospace;
--font-zen-pixel-square:'Zen Pixel Square',monospace;
--mono:var(--font-zen-mono);
--sans:var(--font-zen-sans);
/* Controls are pills and surfaces are soft, as on hanzo.ai. */
--r:999px; --r-soft:14px;
}
*{box-sizing:border-box}
html{-webkit-text-size-adjust:100%}
body{margin:0;background:var(--ground);color:var(--ink);font-family:var(--sans);
font-size:16px;line-height:1.65;-webkit-font-smoothing:antialiased}
.wrap{max-width:60rem;margin:0 auto;padding:0 1.75rem}
/* The dot field. A halftone made of one repeating radial-gradient, faded out
along the diagonal by a mask so it reads as a wave rather than wallpaper. */
/* No overflow clip here: the dot field is inset to the box already, and a clip
would cut off the copy-prompt menu. */
.hero{position:relative;border-bottom:1px solid var(--line)}
.hero::before{content:"";position:absolute;inset:0;
background-image:radial-gradient(var(--line-hi) 1px, transparent 1px);
background-size:7px 7px;
-webkit-mask-image:linear-gradient(115deg,#000 0%,rgba(0,0,0,.55) 38%,transparent 72%);
mask-image:linear-gradient(115deg,#000 0%,rgba(0,0,0,.55) 38%,transparent 72%);
pointer-events:none}
.hero .wrap{position:relative;padding-top:5.5rem;padding-bottom:4rem}
nav{border-bottom:1px solid var(--line)}
nav .in{max-width:60rem;margin:0 auto;padding:1.1rem 1.75rem;display:flex;
justify-content:space-between;align-items:center;gap:1rem}
.brand{font-family:var(--mono);font-size:.85rem;letter-spacing:.14em;
text-transform:uppercase;color:var(--ink);text-decoration:none;
display:inline-flex;align-items:center;gap:.6rem}
.brand i{font-style:normal;color:var(--faint)}
.mark{width:1.15em;height:1.15em;display:block;flex:0 0 auto}
nav a.up{font-family:var(--mono);font-size:.72rem;letter-spacing:.14em;
text-transform:uppercase;color:var(--soft);text-decoration:none}
nav a.up:hover{color:var(--ink)}
h1{font-family:var(--mono);font-size:clamp(2rem,5.4vw,3.4rem);line-height:1.12;
letter-spacing:-.02em;margin:0 0 1.1rem;font-weight:500;text-wrap:balance}
h1 em{font-style:normal;color:var(--faint)}
.lede{color:var(--soft);font-size:1.05rem;max-width:52ch;margin:0 0 2.25rem}
.btns{display:flex;flex-wrap:wrap;gap:.7rem;margin:0 0 .5rem;align-items:center}
.btn{display:inline-flex;align-items:center;gap:.5rem;font-family:var(--mono);
font-size:.72rem;letter-spacing:.14em;text-transform:uppercase;
padding:.8rem 1.4rem;border:1px solid var(--line-hi);border-radius:var(--r);
color:var(--ink);text-decoration:none;background:transparent;cursor:pointer;
line-height:1.2;font-weight:400}
.btn:hover{background:#141414;text-decoration:none;border-color:var(--soft)}
.btn.solid{background:var(--ink);color:#000;border-color:var(--ink)}
.btn.solid:hover{background:#d8d8d4}
.btn .chev{width:.7em;height:.7em;flex:0 0 auto;transition:transform .15s ease}
.btn[aria-expanded="true"] .chev{transform:rotate(180deg)}
/* Copy-prompt selector. Each row copies the prompt for its own target. */
.copy{position:relative;display:inline-flex}
.menu{position:absolute;top:calc(100% + .5rem);left:0;z-index:20;min-width:21rem;
background:var(--panel);border:1px solid var(--line-hi);border-radius:var(--r-soft);
padding:.4rem;display:flex;flex-direction:column;
box-shadow:0 12px 32px rgba(0,0,0,.75)}
.menu[hidden]{display:none}
.mi{display:flex;align-items:center;gap:.7rem;width:100%;text-align:left;
padding:.62rem .8rem;border:0;border-radius:calc(var(--r-soft) - .35rem);
background:transparent;color:var(--ink);font-family:var(--mono);font-size:.76rem;
letter-spacing:.04em;text-decoration:none;cursor:pointer;line-height:1.3;
white-space:nowrap}
.mi:hover,.mi:focus-visible{background:#181818;outline:none}
.mi .mark{width:1.05rem;height:1.05rem;color:var(--soft)}
.mi:hover .mark{color:var(--ink)}
.mi u{margin-left:auto;color:var(--faint);text-decoration:none;font-size:.68rem;
letter-spacing:.1em;text-transform:uppercase}
/* Works-with bar: one scrolling row, name and mark per agent. */
.strip{border-bottom:1px solid var(--line);background:var(--panel)}
.strip .in{max-width:60rem;margin:0 auto;padding:.9rem 1.75rem;display:flex;
align-items:center;gap:1.25rem;font-family:var(--mono);font-size:.72rem;
letter-spacing:.1em;text-transform:uppercase;color:var(--faint)}
.strip b{color:var(--soft);font-weight:400;flex:0 0 auto;
border-right:1px solid var(--line);padding-right:1.25rem;align-self:stretch;
display:flex;align-items:center}
.bar{display:flex;align-items:center;gap:.5rem;flex:1 1 auto;min-width:0;
overflow-x:auto;scrollbar-width:none;scroll-snap-type:x proximity;
-webkit-overflow-scrolling:touch;
-webkit-mask-image:linear-gradient(90deg,#000 calc(100% - 3rem),transparent);
mask-image:linear-gradient(90deg,#000 calc(100% - 3rem),transparent)}
.bar::-webkit-scrollbar{display:none}
.agent{display:inline-flex;align-items:center;gap:.45rem;flex:0 0 auto;
padding:.4rem .85rem;border:1px solid var(--line);border-radius:var(--r);
color:var(--soft);white-space:nowrap;scroll-snap-align:start;
text-decoration:none;background:var(--ground)}
.agent:hover{color:var(--ink);border-color:var(--line-hi);text-decoration:none}
.agent .mark{width:.95rem;height:.95rem}
h2{font-family:var(--mono);font-size:1.1rem;letter-spacing:-.01em;margin:2.75rem 0 .75rem;font-weight:500}
h3{font-size:1rem;margin:2rem 0 .5rem;font-weight:600}
h4,h5,h6{font-size:.94rem;margin:1.5rem 0 .5rem;font-weight:600}
p{margin:0 0 1rem;max-width:70ch}
ul,ol{margin:0 0 1rem;padding-left:1.35rem;max-width:70ch}
li{margin:.22rem 0}
a{color:var(--ink);text-decoration:underline;text-underline-offset:3px;
text-decoration-color:var(--line-hi)}
a:hover{text-decoration-color:var(--ink)}
a:focus-visible{outline:1px solid var(--ink);outline-offset:3px}
code{font-family:var(--mono);font-size:.85em;background:var(--panel);
border:1px solid var(--line);border-radius:5px;padding:.1em .36em}
pre{background:var(--panel);border:1px solid var(--line);padding:1rem 1.1rem;
border-radius:var(--r-soft);overflow-x:auto;margin:0 0 1.25rem}
pre code{background:none;border:0;padding:0;font-size:.82rem;line-height:1.7}
blockquote{margin:0 0 1rem;padding-left:1rem;border-left:1px solid var(--line-hi);color:var(--soft)}
hr{border:0;border-top:1px solid var(--line);margin:2.5rem 0}
table{border-collapse:collapse;width:100%;margin:0 0 1.25rem;font-size:.92rem;
display:block;overflow-x:auto}
th,td{border:1px solid var(--line);padding:.5rem .7rem;text-align:left}
.curl{display:block;background:var(--panel);border:1px solid var(--line);
border-radius:var(--r-soft);padding:.95rem 1.1rem;font-family:var(--mono);
font-size:.8rem;color:var(--soft);overflow-x:auto;margin:0 0 2.5rem;
white-space:pre;line-height:1.9}
.curl b{color:var(--ink);font-weight:400}
.curl i{font-style:normal;color:var(--faint)}
/* index */
#q{width:100%;padding:.85rem 1.2rem;font-family:var(--mono);font-size:.85rem;color:var(--ink);
background:var(--panel);border:1px solid var(--line);border-radius:var(--r);margin:0 0 .6rem}
#q::placeholder{color:var(--faint);text-transform:uppercase;letter-spacing:.1em;font-size:.72rem}
#q:focus{outline:none;border-color:var(--soft)}
#count{color:var(--faint);font-family:var(--mono);font-size:.72rem;letter-spacing:.1em;
text-transform:uppercase;margin:0 0 2rem}
.cat{margin:2.5rem 0 .5rem;font-family:var(--mono);font-size:.7rem;letter-spacing:.16em;
text-transform:uppercase;color:var(--faint);border-bottom:1px solid var(--line);
padding-bottom:.45rem}
.row{display:block;padding:.6rem .9rem;margin:0 -.9rem;border-bottom:1px solid var(--line);
border-radius:var(--r-soft);text-decoration:none}
.row:hover{background:#0a0a0a}
.nm{font-family:var(--mono);font-size:.84rem;color:var(--ink);display:block}
.ds{color:var(--soft);font-size:.9rem;display:block;margin-top:.12rem}
footer{margin-top:4rem;padding:2rem 0 4rem;border-top:1px solid var(--line);
color:var(--faint);font-size:.85rem}
footer a{color:var(--soft)}
.fmap{display:grid;gap:1.75rem;grid-template-columns:repeat(auto-fit,minmax(11rem,1fr));
margin:0 0 2rem;font-size:.85rem}
.fmap b{display:block;font-family:var(--mono);font-size:.68rem;letter-spacing:.16em;
text-transform:uppercase;color:var(--faint);font-weight:400;margin:0 0 .6rem;
border-bottom:1px solid var(--line);padding-bottom:.4rem}
.fmap a{display:inline-block;color:var(--ink);text-decoration:none;margin:.3rem .35rem 0 0}
.fmap a:hover{text-decoration:underline}
.fmap div{color:var(--faint);line-height:1.5}
.fend{border-top:1px solid var(--line);padding-top:1.25rem;font-size:.82rem}
@media (max-width:640px){
.hero .wrap{padding-top:3.25rem;padding-bottom:2.75rem}
.btns{gap:.5rem}
.btn{padding:.75rem 1.15rem;font-size:.68rem}
.copy,.copy .btn{width:100%;justify-content:center}
.menu{left:0;right:0;min-width:0}
.strip .in{flex-direction:column;align-items:flex-start;gap:.6rem;padding:.9rem 1.75rem}
.strip b{border-right:0;padding-right:0}
.bar{width:100%}
}
</style>
<link rel="alternate" type="text/markdown" href="/hanzo-aci.md">
<link rel="icon" href="/favicon.svg">
<link rel="canonical" href="https://hanzoskills.com/hanzo-aci">
</head>
<!-- Reading this with a machine? Every page here is also plain markdown.
This one: https://hanzoskills.com/hanzo-aci.md
Index: https://hanzoskills.com/llms.txt
Corpus: https://hanzoskills.com/all.md
Append .md to any path for the markdown twin. -->
<body>
<nav><div class="in">
<a class="brand" href="/"><svg class="mark" viewBox="0 0 67 67" fill="currentColor" aria-hidden="true"><path d="M22.21 67V44.6369H0V67H22.21Z"/><path d="M66.7038 22.3184H22.2534L0.0878906 44.6367H44.4634L66.7038 22.3184Z"/><path d="M22.21 0H0V22.3184H22.21V0Z"/><path d="M66.7198 0H44.5098V22.3184H66.7198V0Z"/><path d="M66.7198 67V44.6369H44.5098V67H66.7198Z"/></svg> HANZO<i>SKILLS</i></a>
<a class="up" href="/">All skills</a>
</div></nav>
<div class="wrap">
<h1>hanzo-aci</h1><p class="lede">Hanzo ACI (Agent Computer Interface) is a Python toolkit that gives AI agents the ability to edit files, lint code, index codebases, execute shell commands, and convert documents.</p><h1>Hanzo ACI - Agent Computer Interface</h1>
<p><strong>Category</strong>: Hanzo Ecosystem <strong>Related Skills</strong>: <code>hanzo/hanzo-mcp.md</code>, <code>hanzo/hanzo-code.md</code>, <code>hanzo/hanzo-agent.md</code></p>
<h2>Overview</h2>
<p>Hanzo ACI (Agent Computer Interface) is a <strong>Python toolkit</strong> that gives AI agents the ability to edit files, lint code, index codebases, execute shell commands, and convert documents. It provides the backend &quot;hands&quot; for Hanzo&#x27;s AI coding agents. Integrates with <code>hanzo-mcp</code> for Model Context Protocol server capabilities. Installable as <code>hanzo-aci</code> from PyPI.</p>
<h3>Why Hanzo ACI?</h3>
<ul><li><strong>File editing for agents</strong>: Programmatic file create/modify/view with line-number precision, undo history, and file caching</li><li><strong>Code linting</strong>: Tree-sitter based multi-language linting (syntax validation before applying changes)</li><li><strong>Codebase indexing</strong>: LocAgent-based code search and indexing with optional LlamaIndex integration</li><li><strong>Document conversion</strong>: Convert PDF, DOCX, PPTX, XLSX, HTML, YouTube transcripts to Markdown</li><li><strong>Shell execution</strong>: Safe subprocess execution utilities for agent tool calls</li><li><strong>MCP integration</strong>: CLI (<code>hanzo-dev</code>) unifies ACI editor tools with MCP server in a single process</li></ul>
<h3>Tech Stack</h3>
<ul><li><strong>Language</strong>: Python 3.12+</li><li><strong>Package Manager</strong>: Poetry (with <code>poetry.lock</code>)</li><li><strong>Code Analysis</strong>: tree-sitter 0.24+, tree-sitter-language-pack 0.7.3, grep-ast, libcst 1.5.0</li><li><strong>Document Processing</strong>: pdfminer-six, pypdf, mammoth, python-pptx, beautifulsoup4, markdownify, openpyxl, xlrd</li><li><strong>Data/Viz</strong>: pandas, matplotlib, networkx</li><li><strong>Validation</strong>: pydantic 2.11+</li><li><strong>Fuzzy Matching</strong>: rapidfuzz 3.13+</li><li><strong>MCP</strong>: hanzo-mcp (local path dep), mcp &gt;=1.9.4, fastmcp &gt;=2.9.2</li><li><strong>Optional</strong>: llama-index 0.12+ (for advanced code search/retrieval)</li><li><strong>Testing</strong>: pytest 8, pytest-forked</li><li><strong>Linting</strong>: ruff, pre-commit</li><li><strong>CI</strong>: GitHub Actions (unit tests, integration tests, lint, PyPI release)</li></ul>
<h3>OSS Base</h3>
<p>Original work by Hanzo. The LocAgent indexing module draws on code intelligence patterns. The editor module is purpose-built for agent-driven file manipulation.</p>
<p>Repo: <code>github.com/hanzoai/aci</code></p>
<h2>When to use</h2>
<ul><li>Building AI agents that need to read, edit, and create files</li><li>Adding code linting validation to agent tool pipelines</li><li>Indexing codebases for AI-powered code search</li><li>Converting documents (PDF, DOCX, PPTX, XLSX) to Markdown for LLM context</li><li>Running shell commands from agent workflows</li><li>Setting up a unified MCP + ACI development server</li></ul>
<h2>Hard requirements</h2>
<ol><li><strong>Python 3.12+</strong></li><li><strong>Poetry</strong> for dependency management</li><li><strong>hanzo-mcp</strong> package (local path dependency at <code>../mcp</code> -- must be available)</li><li><strong>tree-sitter</strong> native libraries (installed via tree-sitter-language-pack)</li></ol>
<h2>Quick reference</h2>
<p>| Item | Value | |------|-------| | PyPI Package | <code>hanzo-aci</code> | | Version | <code>1.0.0</code> | | Repo | <code>github.com/hanzoai/aci</code> | | Branch | <code>main</code> | | License | MIT | | Python | <code>&gt;=3.12</code> | | CLI | <code>hanzo-dev</code> (serve, edit, index) | | Server CLI | <code>hanzo-dev-server</code> | | Test | <code>poetry run pytest</code> | | Lint | <code>make lint</code> |</p>
<h2>One-file quickstart</h2>
<h3>Install and use</h3>
<pre><code class="lang-bash"># Install from PyPI
pip install hanzo-aci
# Or from source with all extras
git clone https://github.com/hanzoai/aci.git
cd aci
poetry install --extras llama
# Start the unified MCP + ACI server
hanzo-dev serve
# Edit a file via CLI
hanzo-dev edit myfile.py --line 42
# Index a codebase
hanzo-dev index /path/to/project --output index.json</code></pre>
<h3>Use in Python code</h3>
<pre><code class="lang-python">from hanzo_aci import file_editor, FileCache
# Initialize the file cache
cache = FileCache()
# Open and view a file with line numbers
result = file_editor.open_file(&quot;src/main.py&quot;, line_number=1)
print(result)
# The editor supports:
# - open_file(path, line_number=None)
# - create_file(path, content)
# - edit_file(path, old_str, new_str)
# - view_file(path, start_line, end_line)
# - undo_edit(path)
# Lint code before applying changes
from hanzo_aci.linter import DefaultLinter
linter = DefaultLinter()
errors = linter.lint(&quot;src/main.py&quot;)</code></pre>
<h2>Core Concepts</h2>
<h3>Architecture</h3>
<pre><code>┌─────────────────────────────────────────────┐
│ hanzo-dev CLI │
│ (unified entry point) │
├──────────┬──────────────┬───────────────────┤
│ serve │ edit │ index │
│ (MCP) │ (ACI) │ (LocAgent) │
└────┬─────┴──────┬───────┴────────┬──────────┘
│ │ │
┌────▼────┐ ┌────▼──────────┐ ┌───▼──────────┐
│hanzo-mcp│ │ hanzo_aci/ │ │ indexing/ │
│ server │ │ editor/ │ │ locagent/ │
│ │ │ linter/ │ │ tools.py │
│ │ │ utils/ │ │ repo/ │
└─────────┘ └───────────────┘ └──────────────┘</code></pre>
<h3>Editor Module</h3>
<p>The core module -- provides file manipulation for agents.</p>
<p>| Component | File | Purpose | |-----------|------|---------| | <code>editor.py</code> | 26KB | Main <code>FileEditor</code> class: open, create, edit, view, undo | | <code>file_cache.py</code> | 5KB | In-memory cache for file contents and metadata | | <code>history.py</code> | 4KB | Undo/redo history tracking per file | | <code>encoding.py</code> | 4KB | File encoding detection and handling | | <code>exceptions.py</code> | 1KB | Custom exceptions (<code>EditorError</code>, <code>FileNotFoundError</code>, etc.) | | <code>prompts.py</code> | 1KB | Prompt templates for agent interactions | | <code>results.py</code> | 1KB | Structured result types for editor operations | | <code>md_converter.py</code> | 41KB | Convert PDF/DOCX/PPTX/XLSX/HTML/YouTube to Markdown |</p>
<h3>Linter Module</h3>
<p>Tree-sitter based code validation.</p>
<p>| Component | File | Purpose | |-----------|------|---------| | <code>linter.py</code> | 5KB | Main linter orchestrator -- dispatches to language-specific impl | | <code>base.py</code> | 2KB | Base linter interface | | <code>impl/</code> | -- | Language-specific linter implementations |</p>
<h3>Indexing Module (LocAgent)</h3>
<p>Code intelligence and search.</p>
<p>| Component | File | Purpose | |-----------|------|---------| | <code>tools.py</code> | 46KB | Core indexing tools: <code>index_codebase</code>, search, file analysis | | <code>results.py</code> | 7KB | Search result types and ranking | | <code>compress.py</code> | 2KB | Code compression for context windows | | <code>utils.py</code> | 1KB | Path and file utilities | | <code>repo/</code> | -- | Repository structure analysis |</p>
<h3>Utilities</h3>
<p>| Component | File | Purpose | |-----------|------|---------| | <code>shell.py</code> | 2KB | Safe subprocess execution with timeout | | <code>diff.py</code> | 1KB | Unified diff generation for file changes | | <code>logger.py</code> | 800B | Structured logging setup |</p>
<h3>CLI Commands</h3>
<pre><code>hanzo-dev serve [--transport stdio|sse] # Start MCP server (default)
hanzo-dev edit &lt;file&gt; [--line N] # Open file in ACI editor
hanzo-dev index &lt;path&gt; [--output file] # Index a codebase
Common flags:
--allow-path &lt;path&gt; Allow access to specific paths
--enable-all-tools Enable all available tools
--enable-agent-tool Enable agent delegation tool
--log-level DEBUG|INFO|WARNING|ERROR</code></pre>
<h2>Directory structure</h2>
<pre><code>aci/
├── hanzo_aci/
│ ├── __init__.py # Exports file_editor, FileCache
│ ├── cli.py # hanzo-dev CLI (v0.3.1)
│ ├── editor/
│ │ ├── __init__.py # Editor module exports
│ │ ├── editor.py # FileEditor class (26KB)
│ │ ├── file_cache.py # File content caching
│ │ ├── history.py # Undo/redo history
│ │ ├── encoding.py # Charset detection
│ │ ├── exceptions.py # EditorError types
│ │ ├── prompts.py # Agent prompt templates
│ │ ├── results.py # Structured results
│ │ ├── config.py # Editor configuration
│ │ └── md_converter.py # Document-to-Markdown (41KB)
│ ├── linter/
│ │ ├── __init__.py # Linter exports
│ │ ├── linter.py # Main linter
│ │ ├── base.py # Base interface
│ │ └── impl/ # Language-specific linters
│ ├── indexing/
│ │ └── locagent/
│ │ ├── tools.py # Code indexing (46KB)
│ │ ├── results.py # Search results
│ │ ├── compress.py # Code compression
│ │ ├── utils.py # Utilities
│ │ └── repo/ # Repo analysis
│ └── utils/
│ ├── diff.py # Diff generation
│ ├── shell.py # Shell execution
│ └── logger.py # Logging setup
├── tests/
│ ├── unit/ # Unit tests
│ ├── integration/ # Integration tests
│ └── data/ # Test fixtures
├── dev_config/
│ └── python/
│ └── .pre-commit-config.yaml
├── .github/workflows/
│ ├── py-unit-tests.yml # Unit test CI
│ ├── py-intg-tests.yml # Integration test CI
│ ├── lint.yml # Ruff lint CI
│ ├── pypi-release.yml # PyPI publish on release
│ └── hanzo-resolver.yml # Issue resolver
├── pyproject.toml # Poetry config, v1.0.0
├── poetry.lock
├── Makefile # lint, install-pre-commit-hooks
└── pytest.ini</code></pre>
<h2>Troubleshooting</h2>
<p>| Issue | Cause | Solution | |-------|-------|----------| | <code>ModuleNotFoundError: hanzo_mcp</code> | Missing local dependency | Ensure <code>../mcp</code> exists or install <code>hanzo-mcp</code> from PyPI | | tree-sitter parse errors | Wrong language pack version | Pin <code>tree-sitter-language-pack==0.7.3</code> | | <code>hanzo-dev serve</code> hangs | No MCP client connected | Use stdio transport with a compatible MCP client | | llama-index import error | Optional dep not installed | Install with <code>poetry install --extras llama</code> | | Encoding errors on file read | Binary file detected | ACI uses <code>binaryornot</code> to skip binary files | | Lint CI fails | Pre-commit hooks not installed | Run <code>make install-pre-commit-hooks</code> |</p>
<h2>Related Skills</h2>
<ul><li><code>hanzo/hanzo-mcp.md</code> - MCP server that ACI integrates with</li><li><code>hanzo/hanzo-code.md</code> - Hanzo Code editor (uses ACI concepts for its agent tools)</li><li><code>hanzo/hanzo-agent.md</code> - Multi-agent SDK that can use ACI tools</li><li><code>hanzo/hanzo-operative.md</code> - Computer use agent (complementary to ACI)</li></ul>
<hr>
<p><strong>Last Updated</strong>: 2026-03-13 <strong>Category</strong>: Hanzo Ecosystem <strong>Related</strong>: agent, aci, editor, linter, mcp, code-intelligence <strong>Prerequisites</strong>: Python 3.12+, Poetry, tree-sitter</p>
<footer>
<div class="fmap">
<div><b>Build</b>
<a href="https://hanzo.app">hanzo.app</a> app builder
<a href="https://hanzo.codes">hanzo.codes</a> code with an agent
<a href="https://hanzoskills.com">hanzoskills.com</a> what an agent reads</div>
<div><b>Run</b>
<a href="https://console.hanzo.ai">console.hanzo.ai</a> cloud console
<a href="https://api.hanzo.ai">api.hanzo.ai</a> the API</div>
<div><b>Account</b>
<a href="https://hanzo.id">hanzo.id</a> sign in
<a href="https://pay.hanzo.ai">pay.hanzo.ai</a> top up
<a href="https://billing.hanzo.ai">billing.hanzo.ai</a> invoices and usage</div>
<div><b>Company</b>
<a href="https://hanzo.ai">hanzo.ai</a> canonical
<a href="https://hanzo.ventures">hanzo.ventures</a> ventures</div>
</div>
<div class="fend"><a href="/hanzo-aci.md">This page as plain text</a> · <a href="/llms.txt">Index for agents</a></div>
</footer>
</div></body></html>