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 5, 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 5, 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.16.tar.gz (574.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.16-py3-none-any.whl (734.8 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: soothe-0.9.16.tar.gz
  • Upload date:
  • Size: 574.6 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.16.tar.gz
Algorithm Hash digest
SHA256 caaa887bc3ae0f18b06e94a4c5b3de2cf6ce90f0a6fbe83ae331c3b3239fff15
MD5 340b36ac68afab2d4aec88f445a9428b
BLAKE2b-256 d770636b705beeea3d728ff24280a700f35e4670377c16f870de99549893cb4e

See more details on using hashes here.

Provenance

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

File metadata

  • Download URL: soothe-0.9.16-py3-none-any.whl
  • Upload date:
  • Size: 734.8 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.16-py3-none-any.whl
Algorithm Hash digest
SHA256 45aa4c5a630eba79c7206b90b4cb77f0a4bf5863735cde62385b014886265154
MD5 d7281bb481f2337f67f8bd27e79017ca
BLAKE2b-256 acfa32a60c0ab56d2bc3271c832b155167aa91a45b9c86206d74370f33aa8428

See more details on using hashes here.

Provenance

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

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

This release

0.9.16 This release

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