Skip to content

README.md

Latest commit

 

History

History
39 lines (27 loc) · 1.84 KB

README.md

File metadata and controls

39 lines (27 loc) · 1.84 KB
Raw

Agentspan Python SDK

Ships as part of conductor-python — install with the agents extra (pip install 'conductor-python[agents]') — you're in the right place.

Long-running, dynamic plan-execute, and event-driven AI agents in Python. You write plain Python; Agentspan compiles your agent into a Conductor workflow that runs on a server — with automatic retries, durable state, human-in-the-loop pauses, streaming, scheduling, dynamic plan-execute, and full execution history.

from conductor.ai.agents import Agent, AgentRuntime

agent = Agent(name="greeter", model="anthropic/claude-sonnet-4-6",
              instructions="You are a friendly assistant.")

with AgentRuntime() as runtime:
    result = runtime.run(agent, "Say hello.")
    print(result.output)

Docs

  • Getting started — install, env vars, and a running agent in under 30 seconds.
  • Writing agents — the Agent class and @agent, tools, multi-agent strategies, handoffs, guardrails, termination, callbacks, streaming + HITL, schedules, stateful and instance agents.
  • Framework agents — run agents authored in the OpenAI Agents SDK, LangChain, LangGraph, or the Claude Agent SDK.
  • Advanced — runtime config, the control-plane AgentClient, deploy vs serve vs run vs plan, structured output, credentials, plans (PLAN_EXECUTE), skills.
  • API reference — the public API surface in one place.

Import surface

Everything public is importable from conductor.ai.agents:

from conductor.ai.agents import Agent, AgentRuntime, tool, agent

A small OpenAI-Agents-compatible shim is also exposed at the top level:

from conductor.ai import Runner, function_tool   # drop-in for `agents.Runner`