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 Jul 29, 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 Jul 29, 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.15, >=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.9.7.tar.gz (511.6 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.9.7-py3-none-any.whl (655.2 kB view details)

Uploaded Python 3

File details

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

File metadata

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

File hashes

Hashes for soothe-0.9.7.tar.gz
Algorithm Hash digest
SHA256 90c6d847579af0a89c2a2a2a2f72c70ef645a38634f6db2299016758041fde04
MD5 cf4e15cbc0d0fd71c2849f7ae6e6af5e
BLAKE2b-256 20501ee647169a82aed5903b5c0d85e5c48b3403ff51e634d01a332b1fe9b5fb

See more details on using hashes here.

Provenance

The following attestation bundles were made for soothe-0.9.7.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.9.7-py3-none-any.whl.

File metadata

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

File hashes

Hashes for soothe-0.9.7-py3-none-any.whl
Algorithm Hash digest
SHA256 bc3d3d7190bb480112644f86eff99fb8413113c22c0fbf5604e13120ae86d327
MD5 25aa7f5db11d716c133a6e5fcd37fa2d
BLAKE2b-256 eb9ee2a01e6b60c4bfa689165acfdf0ea0e07e1356870621a5c35430ba0e8548

See more details on using hashes here.

Provenance

The following attestation bundles were made for soothe-0.9.7-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

0.10.16

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

This release

0.9.7 This release

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