harzoo 0.1.1

Terminal agent framework with pluggable tools and TUI.

harzoo is a terminal agent framework with a Textual TUI and a file-based tool plugin runtime.

Project layers

• Core: src/harzoo/main.py, src/harzoo/tui/, src/harzoo/agent/
• Reusable bootstrap: src/harzoo/agent/start.py

Agent behavior and tools come only from your config directory (typically ~/.harzoo/config/): agents/*.md profiles and tools/*.py plugins. Download starter packs from the Harzoo website and place them there.

Features

• Profile-based configuration (YAML front matter + prompt body)
• Tool hub loads *.py plugins from config/tools/
• Textual-based interactive UI
• OpenAI-compatible LLM loop

Installation

pip install harzoo

Configure profiles and tools under ~/.harzoo/config/ before running:

harzoo

Development

pip install -e .
python -m pytest

Build distributions:

python -m build

Publish a new release to PyPI (harzoo is already published — bump version in pyproject.toml first):

export TWINE_USERNAME=__token__
export TWINE_PASSWORD=pypi-xxxxxxxx
./scripts/publish-pypi.sh

Or upload to TestPyPI first:

twine upload --repository testpypi dist/*

Documentation

pip install -e ".[docs]"
mkdocs serve