Metadata-Version: 2.5
Name: fram-agent
Version: 0.4.8.1
Summary: Fram: a fork of the Tau coding-agent harness.
License-Expression: MIT
Requires-Python: >=3.12
Requires-Dist: anyio>=4.0
Requires-Dist: httpx[socks]>=0.27
Requires-Dist: packaging>=24.0
Requires-Dist: pillow>=11.0
Requires-Dist: pydantic>=2.11
Requires-Dist: pygments>=2.18
Requires-Dist: rich>=13.0
Requires-Dist: textual>=8.2.8
Requires-Dist: typer>=0.12
Description-Content-Type: text/markdown

# Fram

Fram is a fork of [Tau](https://github.com/huggingface/tau), the Python
coding-agent harness. The `fram-agent` distribution installs the `fram`
command.

It bundles Tau's own packages (`tau_ai`, `tau_agent`, `tau_coding`) under
their usual import names, so Tau extensions keep working. Because of that,
`fram` replaces `tau-ai` in any environment it is installed into. Install it
in its own tool environment:

```bash
uv tool install fram-agent
```

The distribution is `fram-agent` because the shorter name `fram` is taken on
PyPI by an unrelated project. The command is still `fram`.

`fram` shares Tau's configuration and sessions (`~/.tau`, or `TAU_HOME`).
`fram --version` names the Tau release it is based on. `fram update` is not
supported; upgrade with `uv tool upgrade fram-agent`.
