Metadata-Version: 2.5
Name: handler-ai
Version: 0.1.0
Summary: Run coding agents (Claude Code, Codex, Vibe, pi) in rootless Podman sandboxes on Linux
Project-URL: Homepage, https://github.com/macray/handler-ai
Project-URL: Documentation, https://macray.github.io/handler-ai/
Project-URL: Changelog, https://github.com/macray/handler-ai/blob/main/CHANGELOG.md
Project-URL: Issues, https://github.com/macray/handler-ai/issues
License-Expression: Apache-2.0
Keywords: acp,agents,ai,claude-code,codex,podman,sandbox
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Web Environment
Classifier: Intended Audience :: Developers
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Software Development
Requires-Python: >=3.12
Requires-Dist: cryptography>=45
Requires-Dist: dulwich>=1.2
Requires-Dist: fastapi>=0.141
Requires-Dist: httpx>=0.28
Requires-Dist: jsonschema>=4.23
Requires-Dist: pydantic<3,>=2.13
Requires-Dist: pyyaml>=6
Requires-Dist: tomlkit>=0.13
Requires-Dist: uvicorn>=0.53
Requires-Dist: websockets>=17
Description-Content-Type: text/markdown

# Handler

**Handler**: every agent needs one.

Run coding agents in containers on your Linux machine. Each agent (Claude Code, Codex, Mistral
Vibe or pi) runs in its own rootless Podman container that sees only its project folder and reaches
only the hosts you allow. A daemon keeps the sessions, which you follow from a web UI, the
terminal, your editor (over ACP) or your phone.

## Install

**You need:** Linux with rootless Podman, `passt` and a systemd user session, and about 3 GB of
disk for the images, built on your machine.

```bash
uv tool install handler-ai   # or: pipx install handler-ai
handler setup                # starts handlerd as a user service, checks this machine, builds the images
handler ui                   # opens the web UI
```

The first `handler setup` downloads and builds the images: from a few minutes to half an hour.
Without uv: `curl -fsSL https://github.com/macray/handler-ai/releases/latest/download/install.sh | sh`
installs it, then Handler. To update: `uv tool upgrade handler-ai`.

## More

- [README](https://github.com/macray/handler-ai#readme): what Handler does, compared with other
  sandboxes, and a first session.
- [Documentation](https://macray.github.io/handler-ai/)
- [Changelog](https://github.com/macray/handler-ai/blob/main/CHANGELOG.md) ·
  [Issues](https://github.com/macray/handler-ai/issues)
