scout-runtime 0.1.0

The Python runtime that ships inside every Scout-generated agent. Memory, sub-agents, sandbox, channels, heartbeat, cron, standing orders, commitments — the substrate.

scout-runtime

The Python runtime that ships inside every Scout-generated agent.

What this is

scout-runtime is the substrate that Scout-generated agents run on. It provides:

• Cognitive loop — message handling, prompt assembly, tool dispatch
• Persistent memory — curated notes, daily log rotation, FTS5 session search
• Sub-agents — isolated child workers with their own memory slice
• Heartbeats — scheduled self-prompted checks (dream cycle, morning briefing, etc.)
• Cron — long-running scheduled jobs
• Standing orders — persistent rules across sessions
• Commitments — durable promises with deadline tracking
• Sandbox — Docker-isolated execution for risky actions
• Channels — multi-target output (TUI, gateway, Telegram, Discord, email)
• Skills — markdown-based procedural memory the agent can read/write/patch
• Tools — terminal, filesystem, workspace, memory, skills, discover
• LLM providers — Anthropic (Claude), OpenAI, Gemini, Ollama (direct HTTP, no SDKs)
• ACP — Agent Client Protocol for subprocess-based integrations

Who uses this

You probably don't install scout-runtime directly. Scout-generated agents declare it as a dependency, so when you pip install an agent, you get the runtime as a transitive dep.

If you want to build agents yourself, the cleanest path is to use myagentos.ai to design them and let the generator emit a configured project — but the runtime is also usable standalone.

Install

pip install scout-runtime

With optional channel adapters:

pip install "scout-runtime[telegram,discord]"

# Or everything:
pip install "scout-runtime[all]"

Available extras: telegram, discord, email, tts, ws, acp, all.

Quick start

Scout-runtime is designed to be wrapped by a generated agent package, not driven directly. That said, here's the minimal shape of an agent that uses it:

from scout_runtime.cognitive.agent import Agent, AgentConfig
from scout_runtime.identity import IdentityConfig

config = AgentConfig(
    identity=IdentityConfig(
        name="Example",
        purpose="A minimal demonstration",
    ),
    # ... memory, heartbeat, tools, etc.
)

agent = Agent(config=config)
agent.run()

Real agents come fully configured by Scout's generator; this is what's underneath them.

Architecture

See the scout-platform repository for full architecture docs, design history, and the agent generator. The runtime ships across waves 1-3 of the platform; see design/ in the repo for the design docs that produced this code.

License

MIT. See LICENSE.