Metadata-Version: 2.3
Name: padwan-cli
Version: 0.4.0
Summary: CLI and TUI for padwan-llm
Author-email: julien.brayere@polarsen.com
Requires-Dist: padwan-llm>=0.6.0
Requires-Dist: piou[tui]>=0.34.1
Requires-Python: >=3.14
Description-Content-Type: text/markdown

# Padwan CLI

Interactive CLI/TUI for [`padwan-llm`](https://github.com/polarsen-io/padwan-llm).

> [!NOTE]
> This is a playground for experimenting with `padwan-llm` features (streaming, agents, MCP, thinking tokens, batch jobs) — not a production-grade tool. Expect rough edges and breaking changes.

<img alt="Chat demo" src="https://github.com/polarsen-io/padwan-cli/raw/master/docs/static/chat.gif" width="800"/>

## Quick start

```bash
export OPENAI_API_KEY=...
uvx padwan-cli
# then /help for commands
```


## Install

```bash
pip install padwan-cli
```

## Local Development

```bash
uv sync --group dev
uv run padwan-cli
```

## One-shot Mode

```bash
uvx padwan-cli "Hello" -m gpt-4o-mini
```
