soothe 0.2.8

Multi-agent harness built on deepagents and langchain/langgraph.

✨ Soothe — Beyond Yet-Another Agent

Soothe is not another Claude Code / OpenClaw clone.

Its ambition is to become an agent-harnessing framework, an Agentic OS, designed to push humans out of the execution loop.

After months of real-world "vibe coding" with coding agents, a clear pain emerged:
humans are still responsible for holding everything together, driving agents across sessions, verifying intermediate results, recovering lost context, re-aligning goals, and manually relaying critical information between tools and skills. This constant supervision creates a heavy cognitive burden.

Soothe was built to eliminate that loop.

Instead of treating agents as isolated executors, Soothe introduces a higher-order orchestration layer. Built on top of LangChain / DeepAgents, it adds a persistent agentic loop and goal engine that can:

• maintain context across sessions
• sustain and recover long-running goals
• coordinate multiple objectives simultaneously
• autonomously steer complex, long-horizon tasks

In short, Soothe shifts the paradigm from human-in-the-loop to agent-in-the-loop systems—where humans define intent, and the system handles execution, continuity, and adaptation.

---

🚀 Key Features

• ✨ Thinks Ahead — Plans multi-step workflows and adapts dynamically based on outcomes
• 🚀 Acts Autonomously — Executes tasks across research, coding, file ops, and browser automation
• 🧠 Learns & Remembers — Persistent memory across sessions—no more repeating yourself
• 🔒 Stays Secure — Enforces least-privilege access and keeps data under your control
• 🔌 Extends Easily — Plugin system for custom tools and specialized sub-agents
• 🌐 Works Anywhere — Multi-transport daemon (Unix, WebSocket, HTTP REST)

Architecture

Design Philosophy

Plan → Execute: Autonomous execution loop that plans, acts, evaluates, and adapts without manual intervention.

Persistent Memory: Sessions accumulate knowledge. Resume threads, recall context, and track long-running goals across conversations.

Security First: Local execution with least-privilege policies. Your infrastructure, your data, your control.

Plugin Architecture: Built-in tools for web search, code execution, and browser automation. Extend with custom plugins via decorator APIs.

What Can Soothe Do?

Deep Research: Multi-source web search, academic papers, document analysis with automatic synthesis and citations.

Autonomous Execution: Multi-step workflows with automatic planning, file operations, code execution, and browser automation.

Long-Running Operations: Background daemon mode with thread management, persistent state, and resume capabilities.

Custom Plugins: Extend with decorator-based tools, specialized subagents, and MCP server integration.

Milestones

• ✅ Single-Session Autonomy — Solve a complex goal end-to-end within a single session, fully out of the human loop
• ⏳ Cross-Session Continuity — Sustain and complete complex tasks across multiple sessions with persistent context
• ⏳ Multi-Goal Orchestration — Handle multiple interdependent goals over long-horizon workflows
• ⏳ Benchmark Reproduction — Reproduce the Anthropic C Compiler experiment

Getting Started

Quick Start

1. Install Soothe:

   pip install soothe
   

2. Initialize config:

   # Create Soothe home directory
   mkdir -p ~/.soothe/config
   
   # Copy minimal config template
   cp config.minimal.yml ~/.soothe/config/config.yml
   
   # Edit with your preferred provider and models
   vim ~/.soothe/config/config.yml  # or use your favorite editor
   

   The minimal config file contains just the essentials: provider settings and model router. All other settings use sensible defaults.

3. Run your first task:

   # Interactive TUI mode (default)
   soothe -p "Research the top 5 Python web frameworks and create a comparison table"
   
   # Or just launch TUI and type your query
   soothe
   

Background Daemon

For long-running operations and remote access:

# Start daemon
soothe daemon start

# Attach from any terminal
soothe daemon attach

# Or connect via WebSocket/HTTP
soothe daemon start --enable-websocket --enable-http

Learn More

📚 Documentation

• Wiki - End-user guides organized by topic

  • Getting Started - Installation and first steps
  • CLI Reference - Complete command documentation
  • Configuration - Environment variables and YAML config
  • Troubleshooting - Common issues and solutions

• User Guide - Comprehensive usage guide with examples

• RFCs & Specs - Technical specifications and architecture design

  • RFC-000 - System conceptual design
  • RFC-201 - Execution architecture
  • RFC-600 - Plugin system design

🛠️ For Developers

• CLAUDE.md - Development guide for AI agents
• Implementation Guides - Detailed implementation documentation

License

MIT