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

Project links

Data verified by PyPI on Aug 17, 2026
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Newer release available (0.10.35)

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for Xiaming.Chen from gravatar.com Xiaming.Chen

GitHub Statistics

Data verified by PyPI on Aug 17, 2026
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

License

MIT License (MIT)

Requires

Python <3.14, >=3.11

Provides Extra

dev

Tags

agents ai langchain langgraph llm multi-agent soothe subagents

Classifiers

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

soothe-0.10.16.tar.gz (502.3 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

soothe-0.10.16-py3-none-any.whl (637.5 kB view details)

Uploaded Python 3

File details

Details for the file soothe-0.10.16.tar.gz.

File metadata

  • Download URL: soothe-0.10.16.tar.gz
  • Upload date:
  • Size: 502.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for soothe-0.10.16.tar.gz
Algorithm Hash digest
SHA256 8b4fdf0cb5c558a9127ffce2df7623eda510724648c19b66068f80e6ad4cf53a
MD5 70c41c0af3865d042c6f5542edbafdfd
BLAKE2b-256 13bcb6f41ad531e77bf071bda8b4b52a650a8ce61470630ae8a1d9f8cebba3d0

See more details on using hashes here.

Provenance

The following attestation bundles were made for soothe-0.10.16.tar.gz:

Publisher: release.yml on mirasoth/soothe

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file soothe-0.10.16-py3-none-any.whl.

File metadata

  • Download URL: soothe-0.10.16-py3-none-any.whl
  • Upload date:
  • Size: 637.5 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for soothe-0.10.16-py3-none-any.whl
Algorithm Hash digest
SHA256 c37a76595f4cf270b28e399227eae5daf3fb07aab522a407758f53492c4ab97f
MD5 c0df3351687031cc234da2cbd0b1c438
BLAKE2b-256 5362b04d8f854821e577290daf8596e59a2ac98bc11ad4528655b86eaf856ea7

See more details on using hashes here.

Provenance

The following attestation bundles were made for soothe-0.10.16-py3-none-any.whl:

Publisher: release.yml on mirasoth/soothe

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

0.10.35

2 files

0.10.33

2 files

0.10.31

2 files

0.10.29

2 files

0.10.28

2 files

0.10.26

2 files

0.10.25

2 files

0.10.24

2 files

0.10.22

2 files

0.10.19

2 files

0.10.18

2 files

0.10.17

2 files

This release

0.10.16 This release

2 files

0.10.13

2 files

0.10.12

2 files

0.10.11

2 files

0.10.10

2 files

0.10.9

2 files

0.10.8

2 files

0.10.7

2 files

0.10.6

2 files

0.10.5

2 files

0.10.4

2 files

0.10.2

2 files

0.10.1

2 files

0.10.0

2 files

0.9.16

2 files

0.9.15

2 files

0.9.14

2 files

0.9.13

2 files

0.9.12

2 files

0.9.11

2 files

0.9.10

2 files

0.9.8

2 files

0.9.7

2 files

0.9.6

2 files

0.9.5

2 files

0.9.4

2 files

0.9.2

2 files

0.9.0

2 files

0.8.5

2 files

0.8.4

2 files

0.8.3

2 files

0.8.2

2 files

0.8.1

2 files

0.8.0

2 files

0.7.18

2 files

0.7.17

2 files

0.7.16

2 files

0.7.15

2 files

0.7.14

2 files

0.7.13

2 files

0.7.12

2 files

0.7.11

2 files

0.7.10

2 files

0.7.7

2 files

0.7.6

2 files

0.7.3

2 files

0.7.2

2 files

0.7.1

2 files

0.7.0

2 files

0.6.17

2 files

0.6.16

2 files

0.6.15

2 files

0.6.14

2 files

0.6.13

2 files

0.6.12

2 files

0.6.11

2 files

0.6.10

2 files

0.6.9

2 files

0.6.8

2 files

0.6.7

2 files

0.6.6

2 files

0.6.5

2 files

0.6.4

2 files

0.6.3

2 files

0.6.2

2 files

0.6.1

2 files

0.6.0

2 files

0.5.32

2 files

0.5.31

2 files

0.5.30

2 files

0.5.29

2 files

0.5.28

2 files

0.5.27

2 files

0.5.26

2 files

0.5.25

2 files

0.5.24

2 files

0.5.23

2 files

0.5.22

2 files

0.5.20

2 files

0.5.19

2 files

0.5.18

2 files

0.5.17

2 files

0.5.16

2 files

0.5.12

2 files

0.5.11

2 files

0.5.10

2 files

0.5.9

2 files

0.5.8

2 files

0.5.7

2 files

0.5.6

2 files

0.5.5

2 files

0.5.4

2 files

0.5.3

2 files

0.5.2

2 files

0.5.1

2 files

0.5.0

2 files

0.4.9

2 files

0.4.8

2 files

0.4.7

2 files

0.4.6

2 files

0.4.5

2 files

0.4.4

2 files

0.4.3

2 files

0.4.2

2 files

0.4.1

2 files

0.4.0

2 files

0.3.8

2 files

0.3.7

2 files

0.3.6

2 files

0.3.5

2 files

0.3.4

2 files

0.3.3

2 files

0.3.2

2 files

0.3.1

2 files

0.3.0

2 files

0.2.12

2 files

0.2.11

2 files

0.2.10

2 files

0.2.8

2 files

0.2.7

2 files

0.2.5

2 files

0.2.4

2 files

0.2.3

2 files

0.2.2

2 files

0.2.0

2 files

0.1.6

2 files

0.1.5

2 files

0.1.4

2 files

0.1.3

2 files

0.1.2

2 files

0.1.1

2 files

0.1.0

2 files

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page