refactor: cleanup

sdk/python/README.md

@@ -0,0 +1,37 @@
+# donutbrowser
+
+A thin Python client for the [Donut Browser](https://donutbrowser.com) local
+REST API. Every method wraps exactly one documented endpoint; nothing is
+invented, cached or retried.
+
+The local API is off by default. Switch it on in the app under **Settings →
+Integrations → Local API → "Enable Local API Server"**, then copy the port and
+the authentication token from that screen.
+
+```bash
+pip install -e .            # from this directory
+```
+
+```python
+from donutbrowser import DonutClient
+
+with DonutClient(token="...") as client:
+    with client.run(profile_id, url="https://example.com", headless=True) as session:
+        print(session.cdp_url)
+```
+
+The client reads `DONUT_API_TOKEN` and `DONUT_API_PORT` when the token and port
+are not passed as arguments.
+
+Full documentation, including the Node package and a worked agent example, is in
+[`sdk/README.md`](../README.md).
+
+## Tests
+
+```bash
+pip install -e ".[dev]"
+pytest
+```
+
+The suite runs entirely against a fake HTTP server on loopback. It never reaches
+the network and never needs the desktop app.