Setup Install the Braintrust SDK and CrewAI, then set your API keys. The examples below use OpenAI. ```bash uv theme={"theme":{"light":"github-light","dark":"github-dark-dimmed"}} uv add braintrust crewai ``` ```bash pip theme={"theme":{"light":"github-light","dark":"github-dark-dimmed"}} pip install braintrust crewai ``` ```bash title=".env" theme={"theme":{"light":"github-light","dark":"github-dark-dimmed"}} BRAINTRUST_API_KEY= OPENAI_API_KEY= ``` Auto-instrumentation To trace CrewAI alongside Braintrust’s other supported libraries, call `braintrust.auto_instrument()` before creating your crew. ```python Python theme={"theme":{"light":"github-light","dark":"github-dark-dimmed"}} import os import braintrust from crewai import Agent, Crew, Task from crewai.llm import LLM braintrust.auto_instrument() braintrust.init_logger( api_key=os.environ["BRAINTRUST_API_KEY"], project="crewai-example", # Replace with your project name ) llm = LLM(model="gpt-4o-mini") coder = Agent( role="Software developer", goal="Write clear, concise code on demand", backstory="An expert coder with a keen eye for software trends.", llm=llm, ) task = Task( description="Write a minimal HTML page with a heading that says Hello Braintrust.", expected_output="A concise HTML document", agent=coder, ) crew = Crew(agents=[coder], tasks=[task]) result = crew.kickoff() print(result) ``` To trace CrewAI without auto-instrumenting other libraries, use `setup_crewai()` instead of `braintrust.auto_instrument()`. ```python Python theme={"theme":{"light":"github-light","dark":"github-dark-dimmed"}} from braintrust.integrations.crewai import setup_crewai from crewai import Agent, Crew, Task from crewai.llm import LLM setup_crewai(project_name="crewai-example") llm = LLM(model="gpt-4o-mini") coder = Agent( role="Software developer", goal="Write clear, concise code on demand", backstory="An expert coder with a keen eye for software trends.", llm=llm, ) task = Task( description="Write a minimal HTML page with a heading that says Hello Braintrust.", expected_output="A concise HTML document", agent=coder, ) print(Crew(agents=[coder], tasks=[task]).kickoff()) ``` Already running CrewAI with OpenTelemetry? Keep that setup and route spans to Braintrust using the [Braintrust OpenTelemetry guide](/integrations/sdk-integrations/opentelemetry#python-sdk-configuration). What Braintrust traces Braintrust traces CrewAI runs as nested spans that mirror the actual execution flow. Captured spans: * Crew kickoff spans (`crewai.kickoff`), with crew inputs, name, process, and fingerprint. * Task spans (`crewai.task`), with description, expected output, assigned agent, and execution context. * Agent execution spans (`crewai.agent`), with task prompt, role/goal/backstory, and available tools. * LLM call spans (`crewai.llm`), with messages, model, tools, and provider config (temperature, max tokens, top p, response format, and so on); response on completion. * Tool call spans (`crewai.tool.`), with tool arguments, output, run attempts, and cache hits. * Token usage metrics for LLM calls (input, output, total, plus cached and reasoning tokens when the provider reports them), captured on `crewai.llm` spans by default, or on the LiteLLM completion child span when LiteLLM is also auto-instrumented (to avoid double-counting). * Time-to-first-token metric for streaming LLM calls. * Errors on failed kickoffs, tasks, agents, LLM calls, and tool calls. * Causal nesting via CrewAI event IDs, nested under any enclosing Braintrust span. Resources * [CrewAI documentation](https://docs.crewai.com/) * [Braintrust Python SDK reference](/reference/sdks/python/latest) * [Braintrust OpenTelemetry guide](/integrations/sdk-integrations/opentelemetry)