soothe 0.3.0

Soothe - Protocol-driven multi-agent orchestration framework (daemon server)

Soothe Daemon Server

Agent runtime server with WebSocket/HTTP transport.

Installation

pip install soothe-daemon

Usage

The soothe-daemon command manages the server:

# Start daemon (foreground)
soothe-daemon start --foreground

# Start daemon (background)
soothe-daemon start

# Check status
soothe-daemon status

# Stop daemon
soothe-daemon stop

# Health checks
soothe-daemon doctor

Architecture

This package is the server component that runs the agent runtime:

• WebSocket transport - primary bidirectional streaming
• HTTP REST transport - optional REST API
• Full agent runtime - langchain, langgraph, tools, subagents
• Thread persistence - RocksDB, SQLite, PostgreSQL support

Dependencies

• soothe-sdk>=0.2.0 - Shared types, protocol
• deepagents>=0.4.10 - Agent orchestration
• langchain>=1.2.11 - LLM framework
• langgraph>=1.1.1 - Graph-based workflows

Configuration

Daemon uses config.yml (same as original Soothe):

daemon:
  transports:
    websocket:
      host: "localhost"
      port: 8765

providers:
  openai:
    api_key: "${OPENAI_API_KEY}"
    
tools: [...]
subagents: [...]

Related Packages

• soothe-cli: Client package (CLI/TUI)
• soothe-sdk: Shared SDK (types, client utilities)

Testing

Run daemon package unit tests from this package directory:

uv run pytest tests/unit/ -v