Soothe
Goal-driven multi-agent orchestration framework (in-process host core).
Extends soothe-nano with StrangeLoop planning, durability, and Autopilot (daemon-dispatched). For a lightweight one-shot coding CLI on nano alone, see fj-ai.
Installation
Full runtime (daemon + CLI):
pip install soothe soothe-daemon soothe-cli
Library only (this package):
pip install soothe
What's in this package
| Piece | Role |
|---|---|
SootheRunner |
Protocol orchestration + StrangeLoop stream (astream) |
create_soothe_agent |
Host CoreAgent factory (planner/policy/memory wired) |
SootheConfig |
Nano base + host overlay (nano.yml / soothe.yml) |
| StrangeLoop / Autopilot / CE / cron | Host orchestration (Autopilot needs the daemon) |
Quick example (StrangeLoop, non-autopilot)
In-process, fj-style one-shot — no daemon:
import asyncio
from soothe.config import SootheConfig
from soothe.runner import SootheRunner
async def main() -> None:
config = SootheConfig.from_yaml_file("~/.soothe/config/nano.yml")
runner = SootheRunner(config)
try:
async for _ns, mode, data in runner.astream("Summarize this repo"):
if mode == "messages":
print(data) # (message, metadata)
finally:
await runner.cleanup()
asyncio.run(main())
Runnable script (loads ~/.soothe/config, SQLite defaults, prints progress):
uv run python examples/01_strange_loop_example.py
Pass autopilot_job=... only when embedding a daemon-dispatched worker goal.
Interactive / library use should omit it so StrangeLoop runs the user query.
Related packages
| Package | Purpose |
|---|---|
soothe-daemon |
Long-running server (HTTP/WS, channels, Autopilot dispatch) |
soothe-cli |
Human CLI + Textual TUI |
soothe-sdk |
Shared wire contracts and types |
soothe-nano |
SootheNanoAgent (tools, skills, MCP) |
Testing
uv run pytest packages/soothe/tests/unit/ -v
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-0.10.24.tar.gz.
File metadata
- Download URL: soothe-0.10.24.tar.gz
- Upload date:
- Size: 445.7 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
uv/0.11.32 {"installer":{"name":"uv","version":"0.11.32","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 |
db0b9c7353de805f5e5cb9dcf60173dd6d3cdf24f4c85694e67f8257e4b6b8c9
|
|
| MD5 |
d24d911d55cd2f458173c8c959c0869a
|
|
| BLAKE2b-256 |
68fcd8e67755ae1e11a005de690eb242abfb05565e39597398a3da03498689d0
|
File details
Details for the file soothe-0.10.24-py3-none-any.whl.
File metadata
- Download URL: soothe-0.10.24-py3-none-any.whl
- Upload date:
- Size: 568.2 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
uv/0.11.32 {"installer":{"name":"uv","version":"0.11.32","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 |
b2579621beb594ded524849da339a0fe8dd0ec96b01f64c139a46694b8e5d0e2
|
|
| MD5 |
764eb0c64712f2800744563b5daa2dcb
|
|
| BLAKE2b-256 |
d6f5cce655059276f1aa76ac822a3200d0d9293290a9b582cb903c1f3472faed
|
