Hanzo ACI

# 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

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("src/main.py", 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("src/main.py")

┌─────────────────────────────────────────────┐
│              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/      │
└─────────┘ └───────────────┘ └──────────────┘

hanzo-dev serve [--transport stdio|sse]    # Start MCP server (default)
hanzo-dev edit <file> [--line N]           # Open file in ACI editor
hanzo-dev index <path> [--output file]     # Index a codebase

Common flags:
  --allow-path <path>       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

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