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

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