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
Metadata
1 maintainer
Release files for soothe-client-python 1.0.23
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| soothe_client_python-1.0.23.tar.gz | 65.1 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| soothe_client_python-1.0.23-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 141.7 kB
Release files / soothe_client_python-1.0.23.tar.gz
| Download URL | soothe_client_python-1.0.23.tar.gz |
|---|---|
| Size | 65.1 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
9f7d14053ba95969ed99b9d9d563d83ea47135f8fff4b6e163f1debe71a93425
|
|
BLAKE2b-256 checksum How to use checksums |
026fa086f6570d4f083f23afad5fed194ff1ef11203660ad5936918b923ce5b3
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.12.13
|
Release files / soothe_client_python-1.0.23-py3-none-any.whl
| Download URL | soothe_client_python-1.0.23-py3-none-any.whl |
|---|---|
| Size | 76.6 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
ec9a8bf98363f63aec97a98aee8750b75bbd8aeb5bbf346f12542228c1af4d1a
|
|
BLAKE2b-256 checksum How to use checksums |
03f921fcd889f1b0bd86aac38e13e0c33b2362970cf847d1eb38af359129ed97
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.12.13
|
