Skip to main content

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)

Metadata

Release files for soothe-client-python 1.2.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for soothe-client-python 1.2.1
File Size Uploaded Provenance Actions
soothe_client_python-1.2.1.tar.gz 114.2 kB With provenance Details for soothe_client_python-1.2.1.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for soothe-client-python 1.2.1
File Interpreter ABI Platform Actions
soothe_client_python-1.2.1-py3-none-any.whl Python 3 none any Details for soothe_client_python-1.2.1-py3-none-any.whl

Total release size: 254.3 kB

Release files / soothe_client_python-1.2.1.tar.gz

Download URL soothe_client_python-1.2.1.tar.gz
Size 114.2 kB
Tags Source
SHA-256 checksum
How to use checksums
3b1fc6ad857948f1ab6d919a0abb472b0f8d4322efc1babd99c93c6fca05e456
BLAKE2b-256 checksum
How to use checksums
4b5d7b1714045d5c56a4b60aeb10fd3599e214aec9745e564e49a6025ec8e791
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 16, 2026.

Transparency log

Release files / soothe_client_python-1.2.1-py3-none-any.whl

Download URL soothe_client_python-1.2.1-py3-none-any.whl
Size 140.1 kB
Tags Python 3
SHA-256 checksum
How to use checksums
1eb0476cd20dcc5f1ade00112097af1a3ff06d0f1a03829e18906d408eb5dc9f
BLAKE2b-256 checksum
How to use checksums
4620cf0e410e904170af7fef18cfad581ee74fffc0f8255532be29ab801d6066
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 16, 2026.

Transparency log

Security for soothe-client-python 1.2.1

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for soothe_client_python-1.2.1.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 16, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

1.2.1 This release

2 release files Full provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page