Adapter Compatibility

Butterflow ships with registry entries for 24 adapters covering the most popular agent frameworks. Built-in adapters live in the core package; external adapters are installed separately.

Adapter	Framework	Cap.	Detection signals	Install command	Notes
`langgraph`	LangGraph	3	`langgraph`, `StateGraph`, `CompiledGraph`	`pip install butterflow[langgraph]`	Graph-node entry → `AgentSelected`; tool messages → `ToolCalled`
`langchain`	LangChain	3	`langchain`, `AgentExecutor`, `LLMChain`	`pip install butterflow[langchain]`	Chain/agent execution adapter
`openai_agents`	OpenAI Agents SDK	3	`openai`, `agents`, `Agent`	`pip install butterflow[openai-agents]`	`agent.run` spans map to lifecycle events
`pydantic_ai`	Pydantic AI	3	`pydantic_ai`, `Agent`	`pip install butterflow[pydantic-ai]`	Structured agent adapter
`crewai`	CrewAI	2	`crewai`, `Crew`, `Agent`	`pip install butterflow[crewai]`	Tasks → `AgentDelegated`; tools → `ToolCalled`
`autogen`	AutoGen	2	`autogen`, `ConversableAgent`, `GroupChat`	`pip install butterflow[autogen]`	Group-chat broadcasts may produce multiple `MessageSent` events
`llamaindex`	LlamaIndex	2	`llama_index`, `llamaindex`, `AgentRunner`	`pip install butterflow[llamaindex]`	Agent and query-engine adapter
`anthropic_agents`	Anthropic	2	`anthropic`, `Claude`, `client`	`pip install butterflow[anthropic-agents]`	Claude agent tooling adapter
`python`	Built-in	2	`butterflow`	`pip install butterflow`	In-memory synthetic events; no external deps
`subprocess`	Built-in	2	`subprocess`	`pip install butterflow[subprocess]`	Subprocess-based execution adapter
`ms_agent`	Microsoft Agent	1	`msagent`, `microsoft`	`pip install butterflow[ms-agent]`	Ingest-only placeholder
`semantic_kernel`	Semantic Kernel	1	`semantic_kernel`, `Kernel`, `sk`	`pip install butterflow[semantic-kernel]`	Orchestration adapter
`haystack`	Haystack	1	`haystack`, `Pipeline`, `Agent`	`pip install butterflow[haystack]`	Pipeline adapter
`smolagents`	smolagents	1	`smolagents`, `CodeAgent`, `ToolCallingAgent`	`pip install butterflow[smolagents]`	Lightweight code-agent adapter
`mastra`	Mastra	1	`mastra`, `Agent`	`pip install butterflow[mastra]`	TypeScript-first framework adapter
`vercel_ai`	Vercel AI SDK	1	`ai`, `vercel`, `generateText`, `streamText`	`pip install butterflow[vercel-ai]`	JS/TS project adapter
`llama_stack`	Llama Stack	1	`llama_stack`, `LlamaStack`	`pip install butterflow[llama-stack]`	Meta-agent framework adapter
`dspy`	DSPy	1	`dspy`, `DSPy`, `Module`	`pip install butterflow[dspy]`	Declarative LM programming adapter
`bedrock`	Amazon Bedrock	1	`boto3`, `bedrock`	`pip install butterflow[bedrock]`	Bedrock Agents adapter
`vertex_adk`	Vertex AI ADK	1	`google`, `vertexai`, `adk`	`pip install butterflow[vertex-adk]`	Google Vertex AI adapter
`azure_foundry`	Azure AI Foundry	1	`azure`, `azure-ai`	`pip install butterflow[azure-foundry]`	Azure AI Foundry agents adapter
`jsonl`	Built-in	1	`jsonl`, `ndjson`	`pip install butterflow[jsonl]`	Generic JSONL trace ingestion
`agno`	Agno (Phidata)	1	`agno`, `phidata`, `Agent`	`pip install butterflow[agno]`	Agno agent framework adapter
`opentelemetry`	OpenTelemetry	1	`opentelemetry`, `otel`, `trace`	`pip install butterflow[opentelemetry]`	OTel span ingestion adapter

Capability levels

1 — Ingest traces only
2 — Execute flows
3 — Normalize tool calls, state, artifacts, handoffs
4 — Token fingerprints + scheduler metadata
5 — Repair hints + spec generation from traces

No adapter currently claims capability 4 or 5. These are reserved for future premium adapters.