Continuum v0.2.2: now on PyPI

The agent runtime for builders who ship. Build, run, and deploy reliable AI agents at enterprise scale — multi-LLM routing, persistent memory, MCP-native tools, durable workflows, and full observability, behind one small, type-safe API.

shyftlabs-continuum is now published on PyPI, so you no longer need to clone the repo to get started.

📦 Install

pip install shyftlabs-continuum

Optional extras: pip install "shyftlabs-continuum[temporal]" (durable workflows), "[eval]" (evaluation), "[embeddings]" (local embeddings).

🚀 Quick start

Requirements: Python 3.13+ and Docker (for Redis · Qdrant/Milvus · Langfuse).

python3.13 -m venv .venv && source .venv/bin/activate
pip install shyftlabs-continuum

continuum up                          # start local infra (Redis + Qdrant); writes ./.env
echo "OPENAI_API_KEY=sk-…" >> .env     # add your provider key(s)

continuum up ships with the package and starts the bundled Docker stack for you — no compose file to find or copy. Pick a bigger profile with continuum up standard (adds Langfuse tracing) or continuum up full (adds Temporal + Milvus).

import asyncio
from continuum.agent import BaseAgent, AgentRunner

async def main():
    agent = BaseAgent(
        name="hello-agent",
        instructions="You are a friendly assistant.",
        model="gpt-4o-mini",
    )
    runner = AgentRunner()
    response = await runner.run(agent, "Hi!")
    print(response.content)

asyncio.run(main())

✨ What's inside

• 🤖 Agentic core & orchestration — a strongly-typed agent primitive with lifecycle hooks, schema-validated structured outputs, and nine composable multi-agent patterns (sequential, parallel, loop, routing, planning, reflection, debate, scatter, supervised).
• 🔀 Smart Inference — cost-aware routing that classifies each request and dispatches it to the cheapest capable model, with cross-provider failover and zero lock-in.
• 🧠 Stateful memory — persistent long-term recall plus low-latency working memory, with multi-tenant isolation scopes and built-in PII redaction.
• 🔌 Open tool calling — Model Context Protocol (MCP) across multiple transports, with capability scoping, context capture/injection, and generative-UI artifacts.
• 🔁 Durable execution — crash- and restart-safe workflows with human-in-the-loop approval gates.
• 🔭 Full observability — distributed tracing, token/latency/error telemetry, and one-line instrumentation.
• 🌐 Model-agnostic — target frontier or open-weight models through a single model string; swap providers without touching agent code.
• 🤝 Multi-agent handoffs — context-preserving delegation with history summarization, cycle detection, and depth control.
• 📡 Real-time streaming — token-, tool-, handoff-, and memory-level events as they happen.
• ✅ Built-in evaluation — turn production traces into golden datasets and regression-test agent quality.

🔗 Links

• PyPI: https://pypi.org/project/shyftlabs-continuum/
• Documentation: https://docs.continuum.shyftlabs.io/
• Repository: https://github.com/shyftlabs/continuum

Built by ShyftLabs. Licensed under Apache-2.0.