Metadata-Version: 2.4
Name: tauon
Version: 0.0.1
Summary: A minimal Python agent framework built on tau-ai.
License-Expression: MIT
Requires-Python: >=3.12
Requires-Dist: tau-ai>=0.3.3
Description-Content-Type: text/markdown

# Tauon

A minimal Python agent framework built on [`tau`](https://github.com/huggingface/tau).
Think of it like [flue](https://github.com/withastro/flue) of `tau` instead of [pi](https://github.com/earendil-works/pi).

## Quick start

```python
from tauon import define_agent, define_tool, use_model, use_tool


@define_tool
def get_weather(city: str) -> str:
    """Get the current weather for a city."""
    return f"Sunny and 22°C in {city}."


@define_agent
def WeatherAgent() -> str:
    use_model("openai/gpt-4.1-mini")
    use_tool(get_weather)
    return "You are a weather assistant."
```

```bash
export OPENAI_API_KEY=...
uv run tauon run examples/weather.py --message "What's the weather in Paris?"
```
