soothe-client-python
Talk to a running soothe-daemon over WebSocket — send prompts, stream agent turns, run jobs.
pip install soothe-client-python
Requires a local daemon (default ws://127.0.0.1:8765).
Quick start
import asyncio
from soothe_client.appkit import DaemonSession
async def main() -> None:
session = DaemonSession("ws://127.0.0.1:8765")
await session.connect()
await session.send_turn("Summarize this in one sentence: agents need tools.")
async for _namespace, mode, data in session.iter_turn_chunks():
if mode == "custom" and isinstance(data, dict):
text = data.get("content") or data.get("text")
if text:
print(text, end="", flush=True)
print()
await session.close()
asyncio.run(main())
More patterns: examples/ (hello → streaming → multi-turn → pool → jobs).
What you get
| Need | Use |
|---|---|
| One conversation, stream replies | DaemonSession (soothe_client.appkit) |
| Jobs / cron (async) | AsyncCommandClient |
| Jobs / cron (scripts / sync) | CommandClient |
| Raw WebSocket / custom RPCs | WebSocketClient |
| Many users / HTTP backend | ConnectionPool + TurnRunner |
Wire request param models: soothe_client.protocol_params.
Develop
make sync-dev
make check # lint + unit tests
make test-examples-offline # offline appkit examples
make test-examples # live 01–06 (needs soothed)
make test-integration # live integration suite (needs soothed)
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file soothe_client_python-1.0.21.tar.gz.
File metadata
- Download URL: soothe_client_python-1.0.21.tar.gz
- Upload date:
- Size: 70.0 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
uv/0.11.29 {"installer":{"name":"uv","version":"0.11.29","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
f342d6bdf93c604a63e1e049ba6bc4ecd37cd09aebe20a133abb8e7d89a10265
|
|
| MD5 |
7744491ba19df0e5663ba82e9342c111
|
|
| BLAKE2b-256 |
3a33afe7d62452cd22b358c019692a7476acca7bec6f2630eb448130f83a75e3
|
File details
Details for the file soothe_client_python-1.0.21-py3-none-any.whl.
File metadata
- Download URL: soothe_client_python-1.0.21-py3-none-any.whl
- Upload date:
- Size: 81.6 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
uv/0.11.29 {"installer":{"name":"uv","version":"0.11.29","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
731b3a8d2258bae55d6320f8d40b61a4fd841201a57af74c950c9a7b87b0e0c8
|
|
| MD5 |
e917f51c1832ef65b9d39bdc51f9e3c9
|
|
| BLAKE2b-256 |
2e3b0e655a695483be93706030799a1e63ac790519b33f38650ed1f34aba9c16
|
