Metadata-Version: 2.4
Name: hmz
Version: 0.1.0b2
Summary: The agent flow system for token maxxing.
Keywords: agents,ai,claude-code,codex,coding-agents,llm,tui,workflow
Author: Zijian Zhang
Author-email: Zijian Zhang <35801754+futrime@users.noreply.github.com>
License-Expression: Apache-2.0
License-File: LICENSE
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Operating System :: MacOS
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Topic :: Software Development
Classifier: Typing :: Typed
Requires-Dist: dateparser>=1.4.3
Requires-Dist: psutil>=7.2.2
Requires-Dist: pydantic>=2.13.5
Requires-Dist: pyfiglet>=1.0
Requires-Dist: pyyaml>=6.0.3
Requires-Dist: rich>=15
Requires-Dist: semver>=3.0.4
Requires-Dist: sentry-sdk>=2.71.0
Requires-Dist: textual>=8.2.8
Requires-Dist: tomlkit>=0.15.1
Requires-Dist: typing-extensions>=4.13
Requires-Dist: hmz[dsh,kimi,litellm] ; extra == 'all'
Requires-Dist: deepseek-harness-sdk>=0.1.5rc1,<0.1.6 ; extra == 'dsh'
Requires-Dist: python-dotenv>=1.2.3 ; extra == 'dsh'
Requires-Dist: websockets>=15,<18 ; extra == 'kimi'
Requires-Dist: litellm>=1.104 ; extra == 'litellm'
Requires-Python: >=3.12
Project-URL: Homepage, https://github.com/humanfia/humanize
Project-URL: Documentation, https://docs.humanfia.ai/humanize/
Project-URL: Changelog, https://github.com/humanfia/humanize/releases
Project-URL: Source, https://github.com/humanfia/humanize
Project-URL: Issues, https://github.com/humanfia/humanize/issues
Provides-Extra: all
Provides-Extra: dsh
Provides-Extra: kimi
Provides-Extra: litellm
Description-Content-Type: text/markdown

# humanize _(hmz)_

![humanize](https://socialify.git.ci/humanfia/humanize/image?description=1&font=Raleway&forks=1&issues=1&logo=https%3A%2F%2Fraw.githubusercontent.com%2Fhumanfia%2Fhumanize%2Frefs%2Fheads%2Fmain%2Fdocs%2Fpublic%2Flogo.svg&name=1&owner=1&pattern=Circuit+Board&pulls=1&stargazers=1&theme=Auto)

The agent flow system for token maxxing.

## Install

Needs Python 3.12 or newer, [uv](https://docs.astral.sh/uv/), and a coding agent CLI you are
signed in to, such as Claude Code or Codex.

```sh
uv tool install 'hmz>=0.1.0b1'
```

humanize has only pre-releases so far: `>=0.1.0b1` lets uv take the newest one.

Three backends need a package of their own: `[dsh]` for DeepSeek Harness, `[kimi]` for Kimi
Code, `[litellm]` for a model called directly, `[all]` for all three.

```sh
uv tool install 'hmz[all]>=0.1.0b1'
```

## Usage

Open the terminal interface in a repository:

```sh
hmz
```

Or run a flow from your shell:

```sh
hmz exec -f chat -a assistant=claude/claude-opus-5:high "What does this repository do?"
```

Agents run with approvals bypassed, so start in a scratch repository. The
[documentation](https://docs.humanfia.ai/humanize/) opens with a quickstart.

## Contributing

Pull requests are welcome:
[CONTRIBUTING.md](https://github.com/humanfia/humanize/blob/main/CONTRIBUTING.md) says how to
propose one. Report a bug or request a feature through the
[issue forms](https://github.com/humanfia/humanize/issues/new/choose), and report a
vulnerability privately, as [SECURITY.md](https://github.com/humanfia/humanize/blob/main/SECURITY.md)
says. Everyone taking part follows the
[Code of Conduct](https://github.com/humanfia/.github/blob/main/CODE_OF_CONDUCT.md).

## License

Apache-2.0 &copy; Humanfia
