---

---

What is traceAI?

Your agent calls an LLM, retrieves context, invokes a tool, and returns an answer. When that answer is wrong, you need to know exactly where it broke - which retrieval missed, which tool returned stale data, which prompt drifted.

traceAI captures every LLM call, prompt, token count, retrieval step, and agent decision as structured OpenTelemetry traces. Your traces live natively in Datadog, Grafana, Future AGI, Jaeger, or any OTel-compatible backend. No new vendor. No new dashboard.

• Drop-in instrumentation for 50+ AI frameworks across 4 languages
• OpenTelemetry-native - works with any OTel-compatible backend
• Semantic conventions for LLM calls, agents, tools, retrieval, and vector databases
• Python, TypeScript, Java, and C# with consistent APIs

---

Table of Contents

• Key Features
• Quickstart
  • Python
  • TypeScript
  • Java
  • C#
• Supported Frameworks
  • Python
  • TypeScript
  • Java
  • C#
• Compatibility Matrix
• Architecture
• Roadmap
• Contributing
• Contributors
• Resources
• Connect With Us

Key Features

Feature	Description
Standardized Tracing	Maps AI workflows to consistent OpenTelemetry spans and attributes
Drop-in Setup	Add 3 lines to your existing code - no refactoring needed
Multi-Framework	50+ integrations across Python, TypeScript, Java, and C#
Vendor Agnostic	Works with any OpenTelemetry-compatible backend
Rich Context	Captures prompts, completions, tokens, model params, tool calls, and more
Production-grade	Async support, streaming, error handling, and low-overhead tracing

---

Quickstart

Python Quickstart

1. Install

pip install traceai-openai

2. Instrument your application

import os
from fi_instrumentation import register
from fi_instrumentation.fi_types import ProjectType
from traceai_openai import OpenAIInstrumentor
import openai

# Set up environment variables
os.environ["FI_API_KEY"] = "<your-api-key>"
os.environ["FI_SECRET_KEY"] = "<your-secret-key>"
os.environ["OPENAI_API_KEY"] = "<your-openai-key>"

# Register tracer provider
trace_provider = register(
    project_type=ProjectType.OBSERVE,
    project_name="my_ai_app"
)

# Instrument OpenAI
OpenAIInstrumentor().instrument(tracer_provider=trace_provider)

# Use OpenAI as normal - traces are captured automatically
response = openai.chat.completions.create(
    model="gpt-4.1",
    messages=[{"role": "user", "content": "Hello!"}]
)

Tip: Swap traceai-openai for any supported framework (e.g., traceai-langchain, traceai-anthropic)

---

TypeScript Quickstart

1. Install

npm install @traceai/openai @traceai/fi-core

**2. Instrumen