Skip to main content

Agent Control Plane for Autonomous Systems — Runtime guards, loop detection, cost limits, and telemetry for AI agents.

Project description

SteerPlane SDK

Agent Control Plane for Autonomous Systems

"Agents don't fail in the dark anymore."

Quick Start

pip install steerplane

Decorator API (Minimal Integration)

from steerplane import guard

@guard(max_cost_usd=10, max_steps=50)
def run_agent():
    agent.run()

Context Manager API (Full Control)

from steerplane import SteerPlane

sp = SteerPlane(agent_id="my_bot")

with sp.run(max_cost_usd=10) as run:
    run.log_step("query_db", tokens=380, cost=0.002)
    run.log_step("generate_response", tokens=1240, cost=0.008)

Features

  • 🛡️ Policy Engine (New in v0.4.0) — Define strict allow/deny rules, rate limits (sliding windows), and human-in-the-loop approval workflows for agents.
  • 🌉 AI Gateway Proxy (New in v0.4.0) — Zero-code integration. Point your default LangChain/OpenAI client to the SteerPlane gateway, and every LLM call gets token tracking, cost evaluation, and policy enforcement automatically.
  • 🧩 First-Class LangChain & CrewAI Support — Drop in SteerPlaneCallbackHandler for total observability of your multi-agent networks without modifying agent chains.
  • 🔄 Infinite Loop Detection — Automatically detects repeating agent behavior and breaks loops before they drain API budgets.
  • 💰 Hard Cost Limits — Stop expensive agent runs the instant they cross a predefined USD ceiling. Tracks 25+ LLM models locally.
  • 🚫 Step Limits — Cap maximum execution steps to prevent runway execution.
  • 📊 Deep Telemetry — Full step-by-step execution tracking (tokens, latency, cost per step) synced instantly to the dashboard.

Advanced Usage: Policy Engine

from steerplane import guard

@guard(
    max_cost_usd=10, 
    denied_actions=["DROP TABLE*", "rm -rf *"],
    rate_limits=[{"pattern": "send_email", "max_count": 5, "window_seconds": 60}],
    require_approval=["execute_trade*"]
)
def autonomous_agent():
    agent.run()

Documentation

See docs.steerplane.ai for full documentation.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

steerplane-0.4.0.tar.gz (34.4 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

steerplane-0.4.0-py3-none-any.whl (38.9 kB view details)

Uploaded Python 3

File details

Details for the file steerplane-0.4.0.tar.gz.

File metadata

  • Download URL: steerplane-0.4.0.tar.gz
  • Upload date:
  • Size: 34.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.7

File hashes

Hashes for steerplane-0.4.0.tar.gz
Algorithm Hash digest
SHA256 ee0a2f6adcaef375ed25a3f335c437a45ce4552fd4af97a56ab1cc7442086a3e
MD5 0f860d2e897081cb4dcd8f6a3e6cb3de
BLAKE2b-256 8af36148ba6a61df3f2ebc0058c876cd98efb7591c52b977c83c3ea64600c340

See more details on using hashes here.

File details

Details for the file steerplane-0.4.0-py3-none-any.whl.

File metadata

  • Download URL: steerplane-0.4.0-py3-none-any.whl
  • Upload date:
  • Size: 38.9 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.7

File hashes

Hashes for steerplane-0.4.0-py3-none-any.whl
Algorithm Hash digest
SHA256 135bf6bb0dff07a8a0a38e5ad845f4a6e65557093d6df4c5ceb57bbe2a2c16f9
MD5 b031f1ac2c62c5b84095e35857e0a1c7
BLAKE2b-256 55181961e643c1cda85cf28415b4655286693c0b1f70fcb6411b6c876f697025

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page