Metadata-Version: 2.4
Name: esp-donut
Version: 0.2.1
Summary: Donut client tools for ESP devices: the donut CLI and the donut-hands daemon
Requires-Python: >=3.13
Requires-Dist: esptool>=5.0
Requires-Dist: nanoid<3,>=2
Requires-Dist: platformdirs<5,>=4
Requires-Dist: pyserial>=3.5
Requires-Dist: websockets>=14
Description-Content-Type: text/markdown

# esp-donut

Client tools for [Donut](https://donut.espressif.tools), the remote-hands
service for ESP devices:

- **`donut`** — the user-facing CLI. Lists devices exposed by connected
  hands boxes and attaches a local rfc2217 port to a remote device.
- **`donut-hands`** — the daemon that runs on a lab box next to the
  hardware, dials the hub, and serves its serial ports.

## Install

```sh
pip install esp-donut
```

## Quick start

```sh
export DONUT_TOKEN=...   # mint one with `donut-admin token mint --role agent`
donut ls
```

For the hands daemon, create a config with `donut-hands --init` and run
`donut-hands`. See the hub's documentation for the config schema and the
wire protocol.
