Soothe Documentation

Goal-driven orchestration framework for building 24/7 long-running autonomous agents

Soothe is an agent-harnessing framework — an Agentic OS that pushes humans out of the execution loop. Built on LangChain / DeepAgents, it adds a persistent agentic loop and goal engine that maintains context across sessions, sustains long-running goals, coordinates multiple objectives, and autonomously steers complex tasks.

Quick Start 

# Install the complete stack
pip install -U soothe soothe-cli soothe-daemon

# Set your API key
export OPENAI_API_KEY=sk-...

# Initialize configuration
soothe config init

# Run your first query
soothe -p "List all Python files in the current directory and count lines of code"

Documentation

Browse the full documentation in the Soothe Wiki:

Section What you’ll find
Getting Started Installation, quick start, basic concepts
Architecture System design, three-level execution model
Core Modules Agent factory, runner, strange loop, goal engine
Configuration YAML reference, environment variables, providers
Backends Memory, durability, vector store, persistence
Capabilities Subagents, tools, MCP integration
Protocols Protocol definitions and taxonomy
Deployment Production setup, monitoring, security, scaling
API Reference Core, daemon, and SDK package APIs
Troubleshooting Common issues and solutions
FAQ Frequently asked questions
Changelog Version history and release notes

Resources