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 31, 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 31, 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.11.tar.gz (516.4 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.11-py3-none-any.whl (662.7 kB view details)

Uploaded Python 3

File details

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

File metadata

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

File hashes

Hashes for soothe-0.9.11.tar.gz
Algorithm Hash digest
SHA256 c594693f7aee1bfaa5bfd82472c801a8b908dc87b1fb7f2b158dcebea21b0d86
MD5 f1d1115f2c8c5dc09f7049574f791671
BLAKE2b-256 98e9311197e798a3a1902eac58d9ee27ebe5e29c0acfd014fd8dc15de8525c30

See more details on using hashes here.

Provenance

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

File metadata

  • Download URL: soothe-0.9.11-py3-none-any.whl
  • Upload date:
  • Size: 662.7 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.9.11-py3-none-any.whl
Algorithm Hash digest
SHA256 69ad99edbbd41c9e96e2876a07b0399fbfc7829922a59237eebd83d4b7c0ac7c
MD5 e4d8b7a2d4c9978a57c0d2e02ee7868a
BLAKE2b-256 3516c2be606883ee5902fccd8e698f63ec40e01e808d268ffc3abbe7fa329a56

See more details on using hashes here.

Provenance

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

This release

0.9.11 This release

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