Skip to main content
Omium instruments CrewAI at runtime. Once enabled, your kickoff() runs are traced without restructuring agents or tasks.

​
Quickstart

Install dependencies: 
pip install omium crewai
Enable CrewAI instrumentation once at startup: 
import omium

omium.init()
omium.instrument_crewai()
Run your crew normally: 
from crewai import Crew, Agent, Task

researcher = Agent(role="Researcher", goal="Find AI news", backstory="You research quickly.")
task = Task(description="Summarize the latest AI agent news.", agent=researcher)

crew = Crew(agents=[researcher], tasks=[task])
result = crew.kickoff()
Open app.omium.ai to view the execution.

​
What Omium captures

SignalNotes
Execution IDOne per kickoff() run.
Agent & task metadataCounts, roles, and step events.
OutputsFinal run output and intermediate events (where available).
ErrorsExceptions and failure context.

​
Instrumentation lifecycle

​
Enable instrumentation

import omium

omium.init()
omium.instrument_crewai()

​
Disable instrumentation

import omium

omium.uninstrument_crewai()

​
Async and batch execution

CrewAI async runs are traced: 
# result = await crew.kickoff_async()
Batch runs are also captured: 
inputs = [{"topic": "Agents"}, {"topic": "RAG"}]
results = crew.kickoff_for_each(inputs)

​
Configuration

import omium
from omium import OmiumConfig

omium.configure(
    OmiumConfig(
        api_key="omium_xxx",
        project="my-crewai-app",
        auto_trace=True,
        auto_checkpoint=True,
    )
)

omium.instrument_crewai()

​
Troubleshooting

​
Traces not appearing

  • Ensure omium.init() is called before instrument_crewai().
  • Confirm your API key and URL with Configure.
  • Verify connectivity to https://api.omium.ai.

​
ImportError: CrewAI is not installed

pip install crewai

​
Next steps

LangGraph

Auto-instrument graph runs and streaming.

Python SDK

Full SDK reference for tracing and checkpoints.