Skip to content

Same agent Smaller bill. The tools and infrastructure to get more work from your AI. Fewer tokens. Less compute. Lower cost.

docs: redesign README with agent-focused hero and demo trace image (#1532)

Aman Agarwal6d226ac85cd1
diff --git a/README.md b/README.md
index 72f61ce6..9b26efcc 100644
--- a/README.md
+++ b/README.md
@@ -1,396 +1,564 @@
<div align="center">
+
<img src="https://github.com/openlit/.github/blob/main/profile/assets/wide-logo-no-bg.png?raw=true" alt="OpenLIT Logo" width="30%">
-#### Observability, Evaluations, Rule Engine, Guardrails, Prompts, Vault, Playground
+# Open-source observability & evaluation for AI agents
-# Open Source Platform for AI Engineering
+**Trace, evaluate, debug, and optimize AI applications and coding agents with OpenTelemetry.**
-**[Documentation](https://docs.openlit.io/) | [Quickstart](-getting-started-with-llm-observability) | [Python SDK](https://github.com/openlit/openlit/tree/main/sdk/python) | [Typescript SDK](https://github.com/openlit/openlit/tree/main/sdk/typescript) | [Go SDK](https://github.com/openlit/openlit/tree/main/sdk/go) |**
+<a href="https://docs.openlit.io/latest/features/agent-observability">
+ <img src="docs/images/readme-hero-coding-agent-trace.png" alt="OpenLIT coding agent trace view" width="90%">
+</a>
-**❤️ [Sponsor this project](https://opencollective.com/openlit) ❤️**
+<p>
+<a href="https://github.com/openlit/openlit/stargazers"><b>⭐ Star</b></a>&nbsp;&nbsp;&nbsp;&nbsp;
+<a href="#-get-started-in-5-minutes"><b>🚀 Quickstart</b></a>&nbsp;&nbsp;&nbsp;&nbsp;
+<a href="https://docs.openlit.io/"><b>📚 Docs</b></a>
+</p>
-[![OpenLIT](https://img.shields.io/badge/OpenLIT-orange)](https://openlit.io/)
-[![License](https://img.shields.io/github/license/openlit/openlit?label=License&logo=github&color=f80&logoColor=white)](https://github.com/openlit/openlit/blob/main/LICENSE)
+[![Documentation](https://img.shields.io/badge/docs-openlit.io-blue)](https://docs.openlit.io/)
+[![License](https://img.shields.io/github/license/openlit/openlit)](https://github.com/openlit/openlit/blob/main/LICENSE)
[![Downloads](https://static.pepy.tech/badge/openlit/month)](https://pepy.tech/project/openlit)
-[![GitHub Last Commit](https://img.shields.io/github/last-commit/openlit/openlit)](https://github.com/openlit/openlit/pulse)
-[![GitHub Contributors](https://img.shields.io/github/contributors/openlit/openlit)](https://github.com/openlit/openlit/graphs/contributors)
+[![Slack](https://img.shields.io/badge/Slack-join-purple?logo=slack)](https://join.slack.com/t/openlit/shared_invite/zt-2etnfttwg-TjP_7BZXfYg84oAukY8QRQ)
+[![X](https://img.shields.io/badge/follow-%40openlit__io-black?logo=x)](https://twitter.com/openlit_io)
+
+**[Documentation](https://docs.openlit.io/) · [Quickstart](https://docs.openlit.io/) · [Examples](https://github.com/openlit/openlit/tree/main/examples) · [Join Slack](https://join.slack.com/t/openlit/shared_invite/zt-2etnfttwg-TjP_7BZXfYg84oAukY8QRQ)**
-[![Slack](https://img.shields.io/badge/Slack-4A154B?logo=slack&logoColor=white)](https://join.slack.com/t/openlit/shared_invite/zt-2etnfttwg-TjP_7BZXfYg84oAukY8QRQ)
-[![X](https://img.shields.io/badge/follow-%40openlit__io-1DA1F2?logo=x&style=social)](https://twitter.com/openlit_io)
</div>
---
-<https://github.com/user-attachments/assets/6909bf4a-f5b4-4060-bde3-95e91fa36168>
+## See what your AI agents are actually doing
-**OpenLIT** allows you to simplify your AI development workflow, especially for Generative AI and LLMs. It streamlines essential tasks like experimenting with LLMs, organizing and versioning prompts, and securely handling API keys. With just one line of code, you can enable **OpenTelemetry-native** observability, offering full-stack monitoring that includes LLMs, vector databases, and GPUs. This enables developers to confidently build AI features and applications, transitioning smoothly from testing to production.
+AI applications are no longer just LLM calls.
-This project proudly follows and maintains the [Semantic Conventions](https://github.com/open-telemetry/semantic-conventions/tree/main/docs/gen-ai) with the OpenTelemetry community, consistently updating to align with the latest standards in Observability.
+A production agent can involve:
-## ⚡ Features
+```mermaid
+flowchart TD
+ U([User]) --> A[AI Agent]
+ A --> L[LLM calls]
+ A --> T[Tool calls]
+ A --> R[Retrieval]
+ A --> M[Memory]
+ A --> S[Sub-agents]
+ A --> P[Prompts]
+ A --> C[Code changes]
+ L & T & R & M & S & P & C --> E{{Evaluation}}
+ E --> O[["Cost / Quality / Errors"]]
+
+ style U fill:#F97316,stroke:#7C2D12,color:#fff
+ style A fill:#111827,stroke:#F97316,stroke-width:2px,color:#fff
+ style E fill:#111827,stroke:#F97316,stroke-width:2px,color:#fff
+ style O fill:#F97316,stroke:#7C2D12,color:#fff
+```
-![OpenLIT Banner](https://github.com/openlit/.github/blob/main/profile/assets/openlit-feature-banner.png?raw=true)
+**OpenLIT gives you visibility across the entire workflow.**
-- 📈 **Analytics Dashboard**: Monitor your AI application's and GPUs health and performance with detailed dashboards that track metrics, costs, and user interactions, providing a clear view of overall efficiency.
+Trace every LLM call, tool invocation, prompt, agent step, token, cost, error, and evaluation — using OpenTelemetry.
-- 🔌 **OpenTelemetry-native Observability SDKs**: Vendor-neutral SDKs (Python, TypeScript, Go) to send traces and metrics to your existing observability tools.
+---
-- 🛡️ **11 Built-in Evaluation Types**: Automated LLM-as-a-Judge evaluation with hallucination, bias, toxicity, safety, instruction following, completeness, conciseness, sensitivity, relevance, coherence, and faithfulness detection. Context-aware evaluation that treats provided context as the source of truth.
+## ⚡ Get started in 5 minutes
-- ⚙️ **Rule Engine**: Define conditional rules with AND/OR logic to match runtime trace attributes and dynamically retrieve contexts, prompts, and evaluation configs. SDK support across Python, TypeScript, and Go.
+### 1. Start OpenLIT
-- 💲 **Cost Tracking for Custom and Fine-Tuned Models**: Tailor cost estimations for specific models using custom pricing files for precise budgeting.
+```bash
+git clone https://github.com/openlit/openlit.git
+cd openlit
-- 🐛 **Exceptions Monitoring Dashboard**: Quickly spot and resolve issues by tracking common exceptions and errors with a dedicated monitoring dashboard.
+docker compose up -d
+```
-- 💭 **Prompt Management**: Manage and version prompts using Prompt Hub for consistent and easy access across applications.
+Open:
-- 🔑 **API Keys and Secrets Management**: Securely handle your API keys and secrets centrally, avoiding insecure practices.
+```text
+http://127.0.0.1:3000
+```
-- 🎮 **Experiment with different LLMs**: Use OpenGround to explore, test and compare various LLMs side by side.
+### 2. Install the SDK
-## 🚀 Getting Started with LLM Observability
+Python:
-```mermaid
-flowchart TB;
- subgraph " "
- direction LR;
- subgraph " "
- direction LR;
- OpenLIT_SDK[OpenLIT SDK] -->|Sends Traces & Metrics| OTC[OpenTelemetry Collector];
- OTC -->|Stores Data| ClickHouseDB[ClickHouse];
- end
- subgraph " "
- direction RL;
- OpenLIT_UI[OpenLIT] -->|Pulls Data| ClickHouseDB;
- end
- end
+```bash
+pip install openlit
```
-### Step 1: Deploy OpenLIT Stack
+TypeScript:
-1. Git Clone OpenLIT Repository
+```bash
+npm install openlit
+```
- Open your command line or terminal and run:
+### 3. Instrument your application
- ```shell
- git clone [email protected]:openlit/openlit.git
- ```
+Python:
-2. Self-host using Docker
-
- Deploy and run OpenLIT with the following command:
+```python
+import openlit
- ```shell
- docker compose up -d
- ```
+openlit.init()
+```
-> For instructions on installing in Kubernetes using Helm, refer to the [Kubernetes Helm installation guide](https://docs.openlit.io/latest/openlit/installation#kubernetes).
+That's it.
-### Step 2: Install OpenLIT SDK
+OpenLIT automatically instruments supported LLM providers, frameworks, vector databases, and other AI infrastructure and exports OpenTelemetry traces and metrics.
-Open your command line or terminal and run:
+### 4. Send telemetry
+
+By default, configure the OTLP endpoint:
```bash
-pip install openlit
+export OTEL_EXPORTER_OTLP_ENDPOINT="http://127.0.0.1:4318"
```
-> For instructions on using the TypeScript SDK, visit the [TypeScript SDK Installation guide](https://github.com/openlit/openlit/tree/main/sdk/typescript#-installation).
-
-### Step 3: Initialize OpenLIT in your Application
-
-Integrate OpenLIT into your AI applications by adding the following lines to your code.
+Or:
```python
import openlit
-openlit.init()
+openlit.init(
+ otlp_endpoint="http://127.0.0.1:4318"
+)
+```
+
+Open your dashboard and start exploring your AI application's traces, metrics, costs, and performance.
+
+---
+
+# 🤖 Observe Claude Code, Cursor & Codex
+
+AI coding agents are powerful — but understanding what they actually did can be difficult.
+
+OpenLIT gives you an OpenTelemetry-native view of coding-agent sessions.
+
+Install the CLI:
+
+### macOS / Linux
+
+```bash
+curl -fsSL https://raw.githubusercontent.com/openlit/openlit/main/cli/scripts/install.sh | sh
+```
+
+### Windows
+
+```powershell
+iwr -useb https://raw.githubusercontent.com/openlit/openlit/main/cli/scripts/install.ps1 | iex
+```
+
+Configure OpenLIT:
+
+```bash
+openlit configure --endpoint http://127.0.0.1:4318
+```
+
+Install coding-agent instrumentation:
+
+```bash
+openlit coding install --vendor=all
+```
+
+Or install individual integrations:
+
+```bash
+openlit coding install --vendor=cursor
+openlit coding install --vendor=claude-code
+openlit coding install --vendor=codex
```
-Configure the telemetry data destination as follows:
+Check your installation:
-| Purpose | Parameter/Environment Variable | For Sending to OpenLIT |
-| ---------------------------------- | ------------------------------------------------ | ------------------------- |
-| Send data to an HTTP OTLP endpoint | `otlp_endpoint` or `OTEL_EXPORTER_OTLP_ENDPOINT` | `"http://127.0.0.1:4318"` |
-| Authenticate telemetry backends | `otlp_headers` or `OTEL_EXPORTER_OTLP_HEADERS` | Not required by default |
+```bash
+openlit doctor
+```
-> 💡 Info: If the `otlp_endpoint` or `OTEL_EXPORTER_OTLP_ENDPOINT` is not provided, the OpenLIT SDK will output traces directly to your console, which is recommended during the development phase.
+Now OpenLIT can capture:
-#### Example
+```mermaid
+flowchart LR
+ S([Coding Agent Session]) --> P[User prompt]
+ S --> L[LLM calls]
+ S --> T[Tool calls]
+ T --> T1[File reads]
+ T --> T2[File edits]
+ T --> T3[Shell commands]
+ T --> T4[Search]
+ S --> SA[Sub-agent activity]
+ S --> TU[Token usage]
+ S --> CO[Cost]
+ S --> CI[Code impact]
+
+ style S fill:#111827,stroke:#F97316,stroke-width:2px,color:#fff
+ style T fill:#111827,stroke:#F97316,stroke-width:2px,color:#fff
+```
+
+Explore the resulting sessions in the **Coding Agents** dashboard.
---
-<details>
- <summary>Initialize using Function Arguments</summary>
+# 🔍 What OpenLIT gives you
+
+## Traces
+
+Understand exactly what happened during an AI request.
- Add the following two lines to your application code:
-
- ```python
- import openlit
-
- openlit.init(
- otlp_endpoint="http://127.0.0.1:4318",
- )
- ```
+<p>
+<img src="https://img.shields.io/badge/-LLM_calls-1F2937?style=flat-square" alt="LLM calls"> <img src="https://img.shields.io/badge/-Prompts_and_responses-1F2937?style=flat-square" alt="Prompts & responses"> <img src="https://img.shields.io/badge/-Tool_calls-1F2937?style=flat-square" alt="Tool calls"> <img src="https://img.shields.io/badge/-Retrieval-1F2937?style=flat-square" alt="Retrieval"> <img src="https://img.shields.io/badge/-Embeddings-1F2937?style=flat-square" alt="Embeddings"> <img src="https://img.shields.io/badge/-Vector_DB_ops-1F2937?style=flat-square" alt="Vector DB ops"> <img src="https://img.shields.io/badge/-Agent_steps-1F2937?style=flat-square" alt="Agent steps"> <img src="https://img.shields.io/badge/-Latency-1F2937?style=flat-square" alt="Latency"> <img src="https://img.shields.io/badge/-Token_usage-1F2937?style=flat-square" alt="Token usage"> <img src="https://img.shields.io/badge/-Errors-1F2937?style=flat-square" alt="Errors">
+</p>
-</details>
+All represented using OpenTelemetry.
---
-<details>
+## 💰 AI cost observability
- ---
+Track the cost of your AI applications across:
- <summary>Initialize using Environment Variables</summary>
-
- Add the following two lines to your application code:
+<p>
+<img src="https://img.shields.io/badge/-Models-1F2937?style=flat-square" alt="Models"> <img src="https://img.shields.io/badge/-Providers-1F2937?style=flat-square" alt="Providers"> <img src="https://img.shields.io/badge/-Users-1F2937?style=flat-square" alt="Users"> <img src="https://img.shields.io/badge/-Sessions-1F2937?style=flat-square" alt="Sessions"> <img src="https://img.shields.io/badge/-Agents-1F2937?style=flat-square" alt="Agents"> <img src="https://img.shields.io/badge/-Environments-1F2937?style=flat-square" alt="Environments">
+</p>
- ```python
- import openlit
+Support custom pricing for custom and fine-tuned models.
- openlit.init()
- ```
-
- Then, configure the your OTLP endpoint using environment variable:
+---
+
+## 🧪 AI evaluations
- ```env
- export OTEL_EXPORTER_OTLP_ENDPOINT = "http://127.0.0.1:4318"
- ```
+Automatically evaluate LLM and agent outputs using LLM-as-a-Judge evaluations.
-</details>
+Built-in evaluation types include:
+
+<p>
+<img src="https://img.shields.io/badge/-Hallucination-1F2937?style=flat-square" alt="Hallucination"> <img src="https://img.shields.io/badge/-Bias-1F2937?style=flat-square" alt="Bias"> <img src="https://img.shields.io/badge/-Toxicity-1F2937?style=flat-square" alt="Toxicity"> <img src="https://img.shields.io/badge/-Safety-1F2937?style=flat-square" alt="Safety"> <img src="https://img.shields.io/badge/-Instruction_following-1F2937?style=flat-square" alt="Instruction following"> <img src="https://img.shields.io/badge/-Completeness-1F2937?style=flat-square" alt="Completeness"> <img src="https://img.shields.io/badge/-Conciseness-1F2937?style=flat-square" alt="Conciseness"> <img src="https://img.shields.io/badge/-Sensitivity-1F2937?style=flat-square" alt="Sensitivity"> <img src="https://img.shields.io/badge/-Relevance-1F2937?style=flat-square" alt="Relevance"> <img src="https://img.shields.io/badge/-Coherence-1F2937?style=flat-square" alt="Coherence"> <img src="https://img.shields.io/badge/-Faithfulness-1F2937?style=flat-square" alt="Faithfulness">
+</p>
+
+Use evaluations to move from:
+
+**"The agent produced an answer."**
+
+to:
+
+**"The agent produced a good answer."**
---
-### Step 4: Visualize and Optimize
+## 🐛 Debug production AI
-With the Observability data now being collected and sent to OpenLIT, the next step is to visualize and analyze this data to get insights into your AI application's performance, behavior, and identify areas of improvement.
+Find the requests that matter.
-Just head over to OpenLIT at `127.0.0.1:3000` on your browser to start exploring. You can login using the default credentials:
+Investigate:
-- **Email**: `[email protected]`
-- **Password**: `openlituser`
+<p>
+<img src="https://img.shields.io/badge/-Failed_LLM_calls-1F2937?style=flat-square" alt="Failed LLM calls"> <img src="https://img.shields.io/badge/-Exceptions-1F2937?style=flat-square" alt="Exceptions"> <img src="https://img.shields.io/badge/-Latency_spikes-1F2937?style=flat-square" alt="Latency spikes"> <img src="https://img.shields.io/badge/-Unexpected_costs-1F2937?style=flat-square" alt="Unexpected costs"> <img src="https://img.shields.io/badge/-Bad_evaluations-1F2937?style=flat-square" alt="Bad evaluations"> <img src="https://img.shields.io/badge/-Problematic_prompts-1F2937?style=flat-square" alt="Problematic prompts"> <img src="https://img.shields.io/badge/-Agent_tool_failures-1F2937?style=flat-square" alt="Agent/tool failures">
+</p>
-![](https://github.com/openlit/.github/blob/main/profile/assets/openlit-client-1.png?raw=true)
-![](https://github.com/openlit/.github/blob/main/profile/assets/openlit-client-2.png?raw=true)
+Go from:
-## 🤖 AI Coding Agents (Claude Code, Cursor, Codex)
+> `Something went wrong.`
-OpenLIT also ships a CLI that brings the same observability story to your
-**local coding agents** — Claude Code, Cursor, and Codex. No SDK to import:
-the CLI installs vendor hooks that emit OpenTelemetry traces for every
-session, prompt, tool call, file edit, subagent spawn, and code-impact event.
+to a fully traced root cause:
-### Install the CLI
+```mermaid
+flowchart TD
+ A[Agent] --> P[Prompt] --> L1[LLM] --> T[Tool call] --> R[Retrieval] --> L2[LLM] --> E([Error])
-```bash
-# macOS + Linux
-curl -fsSL https://raw.githubusercontent.com/openlit/openlit/main/cli/scripts/install.sh | sh
+ style E fill:#DC2626,stroke:#7F1D1D,color:#fff
+ style A fill:#111827,stroke:#F97316,stroke-width:2px,color:#fff
+```
-# Windows (PowerShell)
-iwr -useb https://raw.githubusercontent.com/openlit/openlit/main/cli/scripts/install.ps1 | iex
+---
+
+# 📸 See OpenLIT in action
+
+<table>
+<tr>
+<td width="33%" align="center">
+<img src="docs/images/docs-ai-observability-trace.png" alt="Traces view with full agent conversation, spans, and cost breakdown" width="100%"><br/>
+<sub><b>Traces</b> — full agent conversation, spans &amp; cost</sub>
+</td>
+<td width="33%" align="center">
+<img src="docs/images/auto-evals-dashboard.png" alt="Automated evaluation dashboard with hallucination, bias, and toxicity metrics" width="100%"><br/>
+<sub><b>Evaluations</b> — hallucination, bias &amp; toxicity checks</sub>
+</td>
+<td width="33%" align="center">
+<img src="docs/images/organisation/connectors-list.png" alt="Connectors catalog with ClickHouse, Grafana Tempo, Loki, Prometheus, and Jaeger" width="100%"><br/>
+<sub><b>Connectors</b> — plug in ClickHouse, Tempo, Loki, Prometheus &amp; more</sub>
+</td>
+</tr>
+<tr>
+<td width="33%" align="center">
+<img src="docs/images/docs-prompt-hub-details.png" alt="Prompt Hub prompt detail page with versions and linked rules" width="100%"><br/>
+<sub><b>Prompt Hub</b> — versioned, centrally managed prompts</sub>
+</td>
+<td width="33%" align="center">
+<img src="docs/images/rule-engine-conditions.png" alt="Rule Engine rule detail page with condition groups and live rule preview" width="100%"><br/>
+<sub><b>Rule Engine</b> — conditional rules on trace attributes</sub>
+</td>
+<td width="33%" align="center">
+<img src="docs/images/docs-ui-banner.jpeg" alt="OpenLIT dashboard preview with cost, latency, and usage charts" width="100%"><br/>
+<sub><b>Dashboards</b> — cost, latency &amp; usage charts at a glance</sub>
+</td>
+</tr>
+</table>
+
+---
+
+# 🧠 Prompt management
+
+Use **Prompt Hub** to:
+
+<p>
+<img src="https://img.shields.io/badge/-Create_prompts-1F2937?style=flat-square" alt="Create prompts"> <img src="https://img.shields.io/badge/-Version_prompts-1F2937?style=flat-square" alt="Version prompts"> <img src="https://img.shields.io/badge/-Retrieve_from_apps-1F2937?style=flat-square" alt="Retrieve from apps"> <img src="https://img.shields.io/badge/-Compare_versions-1F2937?style=flat-square" alt="Compare versions"> <img src="https://img.shields.io/badge/-Consistent_across_environments-1F2937?style=flat-square" alt="Consistent across environments">
+</p>
+
+Example:
+
+```python
+prompt = openlit.prompts.get(
+ "customer-support"
+)
+```
+
+Keep prompt management separate from application code while maintaining version control and observability.
+
+---
+
+# ⚙️ Rule Engine
+
+Define runtime rules based on trace attributes.
+
+Use rules to dynamically control:
+
+<p>
+<img src="https://img.shields.io/badge/-Prompts-1F2937?style=flat-square" alt="Prompts"> <img src="https://img.shields.io/badge/-Evaluations-1F2937?style=flat-square" alt="Evaluations"> <img src="https://img.shields.io/badge/-Contexts-1F2937?style=flat-square" alt="Contexts"> <img src="https://img.shields.io/badge/-Runtime_behavior-1F2937?style=flat-square" alt="Runtime behavior">
+</p>
+
+Example:
+
+```text
+IF
+ environment = production
+ AND
+ model = expensive-model
+
+THEN
+ run cost evaluation
+ + retrieve production prompt
+```
+
+---
+
+# 🔌 OpenTelemetry-native
+
+OpenLIT is built around **OpenTelemetry**, rather than creating a proprietary telemetry format.
+
+Your telemetry can flow through the OpenTelemetry ecosystem:
+
+```mermaid
+flowchart TD
+ A["AI App / AI Agent"] -->|OpenTelemetry| C[OpenTelemetry Collector]
+ C --> B[OpenLIT Backend]
+ C --> O["Other OTel backends<br/>(Datadog, Grafana, Honeycomb, ...)"]
+ B --> D[OpenLIT Dashboard]
+
+ style A fill:#111827,stroke:#F97316,stroke-width:2px,color:#fff
+ style C fill:#111827,stroke:#F97316,stroke-width:2px,color:#fff
+ style B fill:#F97316,stroke:#7C2D12,color:#fff
+ style D fill:#F97316,stroke:#7C2D12,color:#fff
```
-### Wire it into your agents
+This means you can integrate OpenLIT into an existing OpenTelemetry architecture instead of replacing it.
+
+---
+
+# 🧩 70+ integrations
+
+OpenLIT auto-instruments a growing ecosystem of AI providers, frameworks, vector databases, and GPU infrastructure with a single line of code. Click any badge to view its integration guide.
+
+**LLM Providers**
+
+<a href="https://docs.openlit.io/latest/sdk/integrations/openai"><img src="https://img.shields.io/badge/OpenAI-1F2937?style=flat-square&logo=openai&logoColor=white" alt="OpenAI"></a> <a href="https://docs.openlit.io/latest/sdk/integrations/ollama"><img src="https://img.shields.io/badge/Ollama-1F2937?style=flat-square&logo=ollama&logoColor=white" alt="Ollama"></a> <a href="https://docs.openlit.io/latest/sdk/integrations/anthropic"><img src="https://img.shields.io/badge/Anthropic-1F2937?style=flat-square&logo=anthropic&logoColor=white" alt="Anthropic"></a> <a href="https://docs.openlit.io/latest/sdk/integrations/deepseek"><img src="https://img.shields.io/badge/DeepSeek-1F2937?style=flat-square&logo=deepseek&logoColor=white" alt="DeepSeek"></a> <a href="https://docs.openlit.io/latest/sdk/integrations/gpt4all"><img src="https://img.shields.io/badge/GPT4All-1F2937?style=flat-square&logo=gpt4all&logoColor=white" alt="GPT4All"></a> <a href="https://docs.openlit.io/latest/sdk/integrations/cohere"><img src="https://img.shields.io/badge/Cohere-1F2937?style=flat-square&logo=cohere&logoColor=white" alt="Cohere"></a> <a href="https://docs.openlit.io/latest/sdk/integrations/mistral"><img src="https://img.shields.io/badge/Mistral-1F2937?style=flat-square&logo=mistralai&logoColor=white" alt="Mistral"></a> <a href="https://docs.openlit.io/latest/sdk/integrations/github-models"><img src="https://img.shields.io/badge/GitHub_Models-1F2937?style=flat-square&logo=github&logoColor=white" alt="GitHub Models"></a> <a href="https://docs.openlit.io/latest/sdk/integrations/vllm"><img src="https://img.shields.io/badge/vLLM-1F2937?style=flat-square&logo=vllm&logoColor=white" alt="vLLM"></a> <a href="https://docs.openlit.io/latest/sdk/integrations/azure-openai"><img src="https://img.shields.io/badge/Azure_OpenAI-1F2937?style=flat-square&logo=azureopenai&logoColor=white" alt="Azure OpenAI"></a> <a href="https://docs.openlit.io/latest/sdk/integrations/azure-ai-inference"><img src="https://img.shields.io/badge/Azure_AI_Inference-1F2937?style=flat-square&logo=azureaiinference&logoColor=white" alt="Azure AI Inference"></a> <a href="https://docs.openlit.io/latest/sdk/integrations/huggingface"><img src="https://img.shields.io/badge/HuggingFace-1F2937?style=flat-square&logo=huggingface&logoColor=white" alt="HuggingFace"></a> <a href="https://docs.openlit.io/latest/sdk/integrations/bedrock"><img src="https://img.shields.io/badge/Amazon_Bedrock-1F2937?style=flat-square&logo=amazonbedrock&logoColor=white" alt="Amazon Bedrock"></a> <a href="https://docs.openlit.io/latest/sdk/integrations/vertexai"><img src="https://img.shields.io/badge/Vertex_AI-1F2937?style=flat-square&logo=googlecloud&logoColor=white" alt="Vertex AI"></a> <a href="https://docs.openlit.io/latest/sdk/integrations/google-ai-studio"><img src="https://img.shields.io/badge/Google_AI_Studio-1F2937?style=flat-square&logo=googlegemini&logoColor=white" alt="Google AI Studio"></a> <a href="https://docs.openlit.io/latest/sdk/integrations/groq"><img src="https://img.shields.io/badge/Groq-1F2937?style=flat-square&logo=groq&logoColor=white" alt="Groq"></a> <a href="https://docs.openlit.io/latest/sdk/integrations/nvidia-nim"><img src="https://img.shields.io/badge/NVIDIA_NIM-1F2937?style=flat-square&logo=nvidianim&logoColor=white" alt="NVIDIA NIM"></a> <a href="https://docs.openlit.io/latest/sdk/integrations/xai"><img src="https://img.shields.io/badge/xAI-1F2937?style=flat-square&logo=xai&logoColor=white" alt="xAI"></a> <a href="https://docs.openlit.io/latest/sdk/integrations/elevenlabs"><img src="https://img.shields.io/badge/ElevenLabs-1F2937?style=flat-square&logo=elevenlabs&logoColor=white" alt="ElevenLabs"></a> <a href="https://docs.openlit.io/latest/sdk/integrations/ai21"><img src="https://img.shields.io/badge/AI21-1F2937?style=flat-square&logo=ai21&logoColor=white" alt="AI21"></a> <a href="https://docs.openlit.io/latest/sdk/integrations/together"><img src="https://img.shields.io/badge/Together_AI-1F2937?style=flat-square&logo=togetherai&logoColor=white" alt="Together AI"></a> <a href="https://docs.openlit.io/latest/sdk/integrations/digitalocean"><img src="https://img.shields.io/badge/DigitalOcean_(pydo)-1F2937?style=flat-square&logo=digitalocean&logoColor=white" alt="DigitalOcean (pydo)"></a> <a href="https://docs.openlit.io/latest/sdk/integrations/digitalocean-gradient"><img src="https://img.shields.io/badge/DigitalOcean_Gradient-1F2937?style=flat-square&logo=digitalocean&logoColor=white" alt="DigitalOcean Gradient"></a> <a href="https://docs.openlit.io/latest/sdk/integrations/assemblyai"><img src="https://img.shields.io/badge/Assembly_AI-1F2937?style=flat-square&logo=assemblyai&logoColor=white" alt="Assembly AI"></a> <a href="https://docs.openlit.io/latest/sdk/integrations/featherless"><img src="https://img.shields.io/badge/Featherless-1F2937?style=flat-square&logo=featherless&logoColor=white" alt="Featherless"></a> <a href="https://docs.openlit.io/latest/sdk/integrations/reka"><img src="https://img.shields.io/badge/Reka_AI-1F2937?style=flat-square&logo=rekaai&logoColor=white" alt="Reka AI"></a> <a href="https://docs.openlit.io/latest/sdk/integrations/krutrim"><img src="https://img.shields.io/badge/OLA_Krutrim-1F2937?style=flat-square&logo=olakrutrim&logoColor=white" alt="OLA Krutrim"></a> <a href="https://docs.openlit.io/latest/sdk/integrations/titan-ml"><img src="https://img.shields.io/badge/Titan_ML-1F2937?style=flat-square&logo=titanml&logoColor=white" alt="Titan ML"></a> <a href="https://docs.openlit.io/latest/sdk/integrations/sarvam"><img src="https://img.shields.io/badge/Sarvam_AI-1F2937?style=flat-square&logo=sarvamai&logoColor=white" alt="Sarvam AI"></a> <a href="https://docs.openlit.io/latest/sdk/integrations/premai"><img src="https://img.shields.io/badge/Prem_AI-1F2937?style=flat-square&logo=premai&logoColor=white" alt="Prem AI"></a> <a href="https://docs.openlit.io/latest/sdk/integrations/replicate"><img src="https://img.shields.io/badge/Replicate-1F2937?style=flat-square&logo=replicate&logoColor=white" alt="Replicate"></a> <a href="https://docs.openlit.io/latest/sdk/integrations/oci"><img src="https://img.shields.io/badge/OCI_GenAI-1F2937?style=flat-square&logo=ocigenai&logoColor=white" alt="OCI GenAI"></a>
+
+**Vector & Data Stores**
+
+<a href="https://docs.openlit.io/latest/sdk/integrations/chromadb"><img src="https://img.shields.io/badge/ChromaDB-1F2937?style=flat-square&logo=chromadb&logoColor=white" alt="ChromaDB"></a> <a href="https://docs.openlit.io/latest/sdk/integrations/pinecone"><img src="https://img.shields.io/badge/Pinecone-1F2937?style=flat-square&logo=pinecone&logoColor=white" alt="Pinecone"></a> <a href="https://docs.openlit.io/latest/sdk/integrations/qdrant"><img src="https://img.shields.io/badge/Qdrant-1F2937?style=flat-square&logo=qdrant&logoColor=white" alt="Qdrant"></a> <a href="https://docs.openlit.io/latest/sdk/integrations/milvus"><img src="https://img.shields.io/badge/Milvus-1F2937?style=flat-square&logo=milvus&logoColor=white" alt="Milvus"></a> <a href="https://docs.openlit.io/latest/sdk/integrations/astradb"><img src="https://img.shields.io/badge/AstraDB-1F2937?style=flat-square&logo=datastax&logoColor=white" alt="AstraDB"></a> <a href="https://docs.openlit.io/latest/sdk/integrations/psycopg"><img src="https://img.shields.io/badge/PostgreSQL_(psycopg3)-1F2937?style=flat-square&logo=postgresql&logoColor=white" alt="PostgreSQL (psycopg3)"></a>
+
+**AI Frameworks & Agents**
+
+<a href="https://docs.openlit.io/latest/sdk/integrations/langchain"><img src="https://img.shields.io/badge/LangChain-1F2937?style=flat-square&logo=langchain&logoColor=white" alt="LangChain"></a> <a href="https://docs.openlit.io/latest/sdk/integrations/openai-agents"><img src="https://img.shields.io/badge/OpenAI_Agents-1F2937?style=flat-square&logo=openaiagents&logoColor=white" alt="OpenAI Agents"></a> <a href="https://docs.openlit.io/latest/sdk/integrations/litellm"><img src="https://img.shields.io/badge/LiteLLM-1F2937?style=flat-square&logo=litellm&logoColor=white" alt="LiteLLM"></a> <a href="https://docs.openlit.io/latest/sdk/integrations/crewai"><img src="https://img.shields.io/badge/CrewAI-1F2937?style=flat-square&logo=crewai&logoColor=white" alt="CrewAI"></a> <a href="https://docs.openlit.io/latest/sdk/integrations/llama-index"><img src="https://img.shields.io/badge/LlamaIndex-1F2937?style=flat-square&logo=llamaindex&logoColor=white" alt="LlamaIndex"></a> <a href="https://docs.openlit.io/latest/sdk/integrations/browser-use"><img src="https://img.shields.io/badge/Browser_Use-1F2937?style=flat-square&logo=browseruse&logoColor=white" alt="Browser Use"></a> <a href="https://docs.openlit.io/latest/sdk/integrations/pydantic"><img src="https://img.shields.io/badge/Pydantic_AI-1F2937?style=flat-square&logo=pydantic&logoColor=white" alt="Pydantic AI"></a> <a href="https://docs.openlit.io/latest/sdk/integrations/dspy"><img src="https://img.shields.io/badge/DSPy-1F2937?style=flat-square&logo=dspy&logoColor=white" alt="DSPy"></a> <a href="https://docs.openlit.io/latest/sdk/integrations/ag2"><img src="https://img.shields.io/badge/AutoGen_(AG2)-1F2937?style=flat-square&logo=autogen&logoColor=white" alt="AutoGen (AG2)"></a> <a href="https://docs.openlit.io/latest/sdk/integrations/haystack"><img src="https://img.shields.io/badge/Haystack-1F2937?style=flat-square&logo=haystack&logoColor=white" alt="Haystack"></a> <a href="https://docs.openlit.io/latest/sdk/integrations/mem0"><img src="https://img.shields.io/badge/mem0-1F2937?style=flat-square&logo=mem0&logoColor=white" alt="mem0"></a> <a href="https://docs.openlit.io/latest/sdk/integrations/guardrails"><img src="https://img.shields.io/badge/Guardrails_AI-1F2937?style=flat-square&logo=guardrailsai&logoColor=white" alt="Guardrails AI"></a> <a href="https://docs.openlit.io/latest/sdk/integrations/phidata"><img src="https://img.shields.io/badge/Phidata-1F2937?style=flat-square&logo=phidata&logoColor=white" alt="Phidata"></a> <a href="https://docs.openlit.io/latest/sdk/integrations/multion"><img src="https://img.shields.io/badge/MultiOn-1F2937?style=flat-square&logo=multion&logoColor=white" alt="MultiOn"></a> <a href="https://docs.openlit.io/latest/sdk/integrations/julep-ai"><img src="https://img.shields.io/badge/Julep_AI-1F2937?style=flat-square&logo=julepai&logoColor=white" alt="Julep AI"></a> <a href="https://docs.openlit.io/latest/sdk/integrations/letta"><img src="https://img.shields.io/badge/Letta-1F2937?style=flat-square&logo=letta&logoColor=white" alt="Letta"></a> <a href="https://docs.openlit.io/latest/sdk/integrations/crawl4ai"><img src="https://img.shields.io/badge/Crawl4AI-1F2937?style=flat-square&logo=crawl4ai&logoColor=white" alt="Crawl4AI"></a> <a href="https://docs.openlit.io/latest/sdk/integrations/firecrawl"><img src="https://img.shields.io/badge/FireCrawl-1F2937?style=flat-square&logo=firecrawl&logoColor=white" alt="FireCrawl"></a> <a href="https://docs.openlit.io/latest/sdk/integrations/dynamiq"><img src="https://img.shields.io/badge/Dynamiq-1F2937?style=flat-square&logo=dynamiq&logoColor=white" alt="Dynamiq"></a> <a href="https://docs.openlit.io/latest/sdk/integrations/controlflow"><img src="https://img.shields.io/badge/ControlFlow-1F2937?style=flat-square&logo=controlflow&logoColor=white" alt="ControlFlow"></a> <a href="https://docs.openlit.io/latest/sdk/integrations/swarmzero"><img src="https://img.shields.io/badge/SwarmZero-1F2937?style=flat-square&logo=swarmzero&logoColor=white" alt="SwarmZero"></a> <a href="https://docs.openlit.io/latest/sdk/integrations/langgraph"><img src="https://img.shields.io/badge/LangGraph-1F2937?style=flat-square&logo=langgraph&logoColor=white" alt="LangGraph"></a> <a href="https://docs.openlit.io/latest/sdk/integrations/strands"><img src="https://img.shields.io/badge/Strands_Agents-1F2937?style=flat-square&logo=strandsagents&logoColor=white" alt="Strands Agents"></a> <a href="https://docs.openlit.io/latest/sdk/integrations/google-adk"><img src="https://img.shields.io/badge/Google_ADK-1F2937?style=flat-square&logo=google&logoColor=white" alt="Google ADK"></a> <a href="https://docs.openlit.io/latest/sdk/integrations/claude-agent-sdk"><img src="https://img.shields.io/badge/Claude_Agent_SDK-1F2937?style=flat-square&logo=anthropic&logoColor=white" alt="Claude Agent SDK"></a> <a href="https://docs.openlit.io/latest/sdk/integrations/vercel-ai"><img src="https://img.shields.io/badge/Vercel_AI_SDK-1F2937?style=flat-square&logo=vercel&logoColor=white" alt="Vercel AI SDK"></a> <a href="https://docs.openlit.io/latest/sdk/integrations/agent-framework"><img src="https://img.shields.io/badge/Agent_Framework-1F2937?style=flat-square&logo=agentframework&logoColor=white" alt="Agent Framework"></a> <a href="https://docs.openlit.io/latest/sdk/integrations/smolagents"><img src="https://img.shields.io/badge/smolagents-1F2937?style=flat-square&logo=huggingface&logoColor=white" alt="smolagents"></a>
+
+**Governance & Protocols**
+
+<a href="https://docs.openlit.io/latest/sdk/integrations/agent-governance-toolkit"><img src="https://img.shields.io/badge/Agent_Governance_Toolkit-1F2937?style=flat-square&logo=agentgovernancetoolkit&logoColor=white" alt="Agent Governance Toolkit"></a> <a href="https://docs.openlit.io/latest/sdk/integrations/mcp"><img src="https://img.shields.io/badge/MCP-1F2937?style=flat-square&logo=mcp&logoColor=white" alt="MCP"></a>
+
+**GPU Monitoring**
+
+<a href="https://docs.openlit.io/latest/sdk/integrations/nvidia-gpu"><img src="https://img.shields.io/badge/NVIDIA_GPUs-1F2937?style=flat-square&logo=nvidia&logoColor=white" alt="NVIDIA GPUs"></a> <a href="https://docs.openlit.io/latest/sdk/integrations/amd-gpu"><img src="https://img.shields.io/badge/AMD_GPUs-1F2937?style=flat-square&logo=amd&logoColor=white" alt="AMD GPUs"></a> <a href="https://docs.openlit.io/latest/sdk/integrations/intel-gpu"><img src="https://img.shields.io/badge/Intel_GPUs-1F2937?style=flat-square&logo=intel&logoColor=white" alt="Intel GPUs"></a>
+
+See the complete integration list in the [documentation](https://docs.openlit.io/).
+
+---
+
+# 🛠️ SDKs
+
+OpenLIT provides OpenTelemetry-native SDKs for:
+
+### Python
```bash
-openlit configure --endpoint http://127.0.0.1:4318 [--api-key <key>]
-openlit coding install --vendor=all # or: cursor / claude-code / codex
+pip install openlit
```
-### Inspect what's running
+[Python SDK →](https://github.com/openlit/openlit/tree/main/sdk/python)
+
+### TypeScript
```bash
-openlit doctor # config + OTLP reachability + installed plugins
+npm install openlit
```
-Sessions, prompts, costs, and per-vendor breakdowns appear in the OpenLIT
-dashboard at `http://127.0.0.1:3000/coding-agents`. To detach later:
+[TypeScript SDK →](https://github.com/openlit/openlit/tree/main/sdk/typescript)
+
+### Go
+
+[Go SDK →](https://github.com/openlit/openlit/tree/main/sdk/go)
+
+---
+
+# 🏗️ Architecture
+
+OpenLIT is designed to run in your infrastructure.
+
+A typical deployment looks like:
+
+```mermaid
+flowchart TD
+ subgraph App["Your application"]
+ direction LR
+ Agent --> LLM --> Tools --> RAG --> DB
+ end
+ App -->|OpenTelemetry| Collector[OpenTelemetry Collector]
+ Collector --> CH[(ClickHouse)]
+ CH --> Dash[OpenLIT Dashboard]
+
+ style App fill:#1F2937,stroke:#F97316,stroke-width:2px,color:#fff
+ style Collector fill:#111827,stroke:#F97316,stroke-width:2px,color:#fff
+ style CH fill:#111827,stroke:#F97316,stroke-width:2px,color:#fff
+ style Dash fill:#F97316,stroke:#7C2D12,color:#fff
+```
+
+---
+
+# 🔐 Self-hosted by default
+
+Run OpenLIT inside your own infrastructure using Docker or Kubernetes.
+
+Your telemetry stays under your control.
```bash
-openlit coding uninstall --vendor=all
+docker compose up -d
```
-> Coding-agent observability is OTel-native end-to-end: traces use the
-> [`gen_ai.*`](https://opentelemetry.io/docs/specs/semconv/gen-ai/) semantic
-> conventions alongside an `coding_agent.*` extension namespace. Anything
-> that speaks OTLP (Datadog, Honeycomb, Grafana Tempo, raw OTel Collector)
-> can consume the same data — OpenLIT is just one possible viewer.
+For Kubernetes, see the [installation documentation](https://docs.openlit.io/latest/openlit/installation#kubernetes).
-## 📦 Supported Integrations
+---
-OpenLIT auto-instruments **50+ LLM providers, AI frameworks, and vector databases** with a single line of code. Each integration produces [OpenTelemetry-native](https://opentelemetry.io/) traces and metrics. Click any card to view the integration docs.
+# 🚀 From trace to optimization
-<sub>
-<img src="https://img.shields.io/badge/Python-3776AB?logo=python&logoColor=white&style=flat-square" height="16"> Python SDK &nbsp;&nbsp;
-<img src="https://img.shields.io/badge/TypeScript-3178C6?logo=typescript&logoColor=white&style=flat-square" height="16"> TypeScript SDK
-</sub>
+Observability is only the beginning.
-### LLM Providers
+OpenLIT is designed around a continuous AI engineering loop:
-<table>
-<tr>
-<td align="center" width="160"><a href="https://docs.openlit.io/latest/sdk/integrations/openai"><b>OpenAI</b></a><br/><img src="https://img.shields.io/badge/Python-3776AB?logo=python&logoColor=white&style=flat-square" height="18"> <img src="https://img.shields.io/badge/TypeScript-3178C6?logo=typescript&logoColor=white&style=flat-square" height="18"></td>
-<td align="center" width="160"><a href="https://docs.openlit.io/latest/sdk/integrations/anthropic"><b>Anthropic</b></a><br/><img src="https://img.shields.io/badge/Python-3776AB?logo=python&logoColor=white&style=flat-square" height="18"> <img src="https://img.shields.io/badge/TypeScript-3178C6?logo=typescript&logoColor=white&style=flat-square" height="18"></td>
-<td align="center" width="160"><a href="https://docs.openlit.io/latest/sdk/integrations/cohere"><b>Cohere</b></a><br/><img src="https://img.shields.io/badge/Python-3776AB?logo=python&logoColor=white&style=flat-square" height="18"> <img src="https://img.shields.io/badge/TypeScript-3178C6?logo=typescript&logoColor=white&style=flat-square" height="18"></td>
-<td align="center" width="160"><a href="https://docs.openlit.io/latest/sdk/integrations/mistral"><b>Mistral AI</b></a><br/><img src="https://img.shields.io/badge/Python-3776AB?logo=python&logoColor=white&style=flat-square" height="18"> <img src="https://img.shields.io/badge/TypeScript-3178C6?logo=typescript&logoColor=white&style=flat-square" height="18"></td>
-</tr>
-<tr>
-<td align="center" width="160"><a href="https://docs.openlit.io/latest/sdk/integrations/groq"><b>Groq</b></a><br/><img src="https://img.shields.io/badge/Python-3776AB?logo=python&logoColor=white&style=flat-square" height="18"> <img src="https://img.shields.io/badge/TypeScript-3178C6?logo=typescript&logoColor=white&style=flat-square" height="18"></td>
-<td align="center" width="160"><a href="https://docs.openlit.io/latest/sdk/integrations/google-ai-studio"><b>Google AI Studio</b></a><br/><img src="https://img.shields.io/badge/Python-3776AB?logo=python&logoColor=white&style=flat-square" height="18"> <img src="https://img.shields.io/badge/TypeScript-3178C6?logo=typescript&logoColor=white&style=flat-square" height="18"></td>
-<td align="center" width="160"><a href="https://docs.openlit.io/latest/sdk/integrations/together"><b>Together AI</b></a><br/><img src="https://img.shields.io/badge/Python-3776AB?logo=python&logoColor=white&style=flat-square" height="18"> <img src="https://img.shields.io/badge/TypeScript-3178C6?logo=typescript&logoColor=white&style=flat-square" height="18"></td>
-<td align="center" width="160"><a href="https://docs.openlit.io/latest/sdk/integrations/ollama"><b>Ollama</b></a><br/><img src="https://img.shields.io/badge/Python-3776AB?logo=python&logoColor=white&style=flat-square" height="18"> <img src="https://img.shields.io/badge/TypeScript-3178C6?logo=typescript&logoColor=white&style=flat-square" height="18"></td>
-</tr>
-<tr>
-<td align="center" width="160"><a href="https://docs.openlit.io/latest/sdk/integrations/bedrock"><b>AWS Bedrock</b></a><br/><img src="https://img.shields.io/badge/Python-3776AB?logo=python&logoColor=white&style=flat-square" height="18"> <img src="https://img.shields.io/badge/TypeScript-3178C6?logo=typescript&logoColor=white&style=flat-square" height="18"></td>
-<td align="center" width="160"><a href="https://docs.openlit.io/latest/sdk/integrations/azure-ai-inference"><b>Azure AI Inference</b></a><br/><img src="https://img.shields.io/badge/Python-3776AB?logo=python&logoColor=white&style=flat-square" height="18"> <img src="https://img.shields.io/badge/TypeScript-3178C6?logo=typescript&logoColor=white&style=flat-square" height="18"></td>
-<td align="center" width="160"><a href="https://docs.openlit.io/latest/sdk/integrations/vertexai"><b>Vertex AI</b></a><br/><img src="https://img.shields.io/badge/Python-3776AB?logo=python&logoColor=white&style=flat-square" height="18"></td>
-<td align="center" width="160"><a href="https://docs.openlit.io/latest/sdk/integrations/vllm"><b>vLLM</b></a><br/><img src="https://img.shields.io/badge/Python-3776AB?logo=python&logoColor=white&style=flat-square" height="18"></td>
-</tr>
-<tr>
-<td align="center" width="160"><a href="https://docs.openlit.io/latest/sdk/integrations/reka"><b>Reka</b></a><br/><img src="https://img.shields.io/badge/Python-3776AB?logo=python&logoColor=white&style=flat-square" height="18"></td>
-<td align="center" width="160"><a href="https://docs.openlit.io/latest/sdk/integrations/litellm"><b>LiteLLM</b></a><br/><img src="https://img.shields.io/badge/Python-3776AB?logo=python&logoColor=white&style=flat-square" height="18"></td>
-<td align="center" width="160"><a href="https://docs.openlit.io/latest/sdk/integrations/huggingface"><b>Hugging Face</b></a><br/><img src="https://img.shields.io/badge/Python-3776AB?logo=python&logoColor=white&style=flat-square" height="18"> <img src="https://img.shields.io/badge/TypeScript-3178C6?logo=typescript&logoColor=white&style=flat-square" height="18"></td>
-<td align="center" width="160"><a href="https://docs.openlit.io/latest/sdk/integrations/ai21"><b>AI21</b></a><br/><img src="https://img.shields.io/badge/Python-3776AB?logo=python&logoColor=white&style=flat-square" height="18"></td>
-</tr>
-<tr>
-<td align="center" width="160"><a href="https://docs.openlit.io/latest/sdk/integrations/gpt4all"><b>GPT4All</b></a><br/><img src="https://img.shields.io/badge/Python-3776AB?logo=python&logoColor=white&style=flat-square" height="18"></td>
-<td align="center" width="160"><a href="https://docs.openlit.io/latest/sdk/integrations/premai"><b>PremAI</b></a><br/><img src="https://img.shields.io/badge/Python-3776AB?logo=python&logoColor=white&style=flat-square" height="18"></td>
-<td align="center" width="160"><a href="https://docs.openlit.io/latest/sdk/integrations/sarvam"><b>Sarvam AI</b></a><br/><img src="https://img.shields.io/badge/Python-3776AB?logo=python&logoColor=white&style=flat-square" height="18"></td>
-<td align="center" width="160"><a href="https://docs.openlit.io/latest/sdk/integrations/julep-ai"><b>Julep</b></a><br/><img src="https://img.shields.io/badge/Python-3776AB?logo=python&logoColor=white&style=flat-square" height="18"></td>
-</tr>
-<tr>
-<td align="center" width="160"><a href="https://docs.openlit.io/latest/sdk/integrations/multion"><b>MultiOn</b></a><br/><img src="https://img.shields.io/badge/Python-3776AB?logo=python&logoColor=white&style=flat-square" height="18"></td>
-<td align="center" width="160"><a href="https://docs.openlit.io/latest/sdk/integrations/replicate"><b>Replicate</b></a><br/><img src="https://img.shields.io/badge/TypeScript-3178C6?logo=typescript&logoColor=white&style=flat-square" height="18"></td>
-<td align="center" width="160"><a href="https://docs.openlit.io/latest/sdk/integrations/digitalocean"><b>DigitalOcean (pydo)</b></a><br/><img src="https://img.shields.io/badge/Python-3776AB?logo=python&logoColor=white&style=flat-square" height="18"></td>
-<td align="center" width="160"><a href="https://docs.openlit.io/latest/sdk/integrations/digitalocean-gradient"><b>DigitalOcean Gradient</b></a><br/><img src="https://img.shields.io/badge/Python-3776AB?logo=python&logoColor=white&style=flat-square" height="18"></td>
-</tr>
-</table>
+```mermaid
+flowchart LR
+ T[Trace] --> E[Evaluate] --> A[Analyze] --> O[Optimize] --> M[Manage] -.-> T
+
+ style T fill:#F97316,stroke:#7C2D12,color:#fff
+ style E fill:#111827,stroke:#F97316,stroke-width:2px,color:#fff
+ style A fill:#111827,stroke:#F97316,stroke-width:2px,color:#fff
+ style O fill:#111827,stroke:#F97316,stroke-width:2px,color:#fff
+ style M fill:#111827,stroke:#F97316,stroke-width:2px,color:#fff
+```
-### AI Frameworks
+The goal is simple:
-<table>
-<tr>
-<td align="center" width="160"><a href="https://docs.openlit.io/latest/sdk/integrations/langchain"><b>LangChain</b></a><br/><img src="https://img.shields.io/badge/Python-3776AB?logo=python&logoColor=white&style=flat-square" height="18"> <img src="https://img.shields.io/badge/TypeScript-3178C6?logo=typescript&logoColor=white&style=flat-square" height="18"></td>
-<td align="center" width="160"><a href="https://docs.openlit.io/latest/sdk/integrations/llama-index"><b>LlamaIndex</b></a><br/><img src="https://img.shields.io/badge/Python-3776AB?logo=python&logoColor=white&style=flat-square" height="18"> <img src="https://img.shields.io/badge/TypeScript-3178C6?logo=typescript&logoColor=white&style=flat-square" height="18"></td>
-<td align="center" width="160"><a href="https://docs.openlit.io/latest/sdk/integrations/crewai"><b>CrewAI</b></a><br/><img src="https://img.shields.io/badge/Python-3776AB?logo=python&logoColor=white&style=flat-square" height="18"></td>
-<td align="center" width="160"><a href="https://docs.openlit.io/latest/sdk/integrations/pydantic"><b>Pydantic AI</b></a><br/><img src="https://img.shields.io/badge/Python-3776AB?logo=python&logoColor=white&style=flat-square" height="18"></td>
-</tr>
-<tr>
-<td align="center" width="160"><a href="https://docs.openlit.io/latest/sdk/integrations/agno"><b>Agno</b></a><br/><img src="https://img.shields.io/badge/Python-3776AB?logo=python&logoColor=white&style=flat-square" height="18"></td>
-<td align="center" width="160"><a href="https://docs.openlit.io/latest/sdk/integrations/browser-use"><b>Browser Use</b></a><br/><img src="https://img.shields.io/badge/Python-3776AB?logo=python&logoColor=white&style=flat-square" height="18"></td>
-<td align="center" width="160"><a href="https://docs.openlit.io/latest/sdk/integrations/haystack"><b>Haystack</b></a><br/><img src="https://img.shields.io/badge/Python-3776AB?logo=python&logoColor=white&style=flat-square" height="18"></td>
-<td align="center" width="160"><a href="https://docs.openlit.io/latest/sdk/integrations/letta"><b>Letta</b></a><br/><img src="https://img.shields.io/badge/Python-3776AB?logo=python&logoColor=white&style=flat-square" height="18"></td>
-</tr>
-<tr>
-<td align="center" width="160"><a href="https://docs.openlit.io/latest/sdk/integrations/mem0"><b>Mem0</b></a><br/><img src="https://img.shields.io/badge/Python-3776AB?logo=python&logoColor=white&style=flat-square" height="18"></td>
-<td align="center" width="160"><a href="https://docs.openlit.io/latest/sdk/integrations/ag2"><b>AG2 (AutoGen)</b></a><br/><img src="https://img.shields.io/badge/Python-3776AB?logo=python&logoColor=white&style=flat-square" height="18"></td>
-<td align="center" width="160"><a href="https://docs.openlit.io/latest/sdk/integrations/controlflow"><b>Controlflow</b></a><br/><img src="https://img.shields.io/badge/Python-3776AB?logo=python&logoColor=white&style=flat-square" height="18"></td>
-<td align="center" width="160"><a href="https://docs.openlit.io/latest/sdk/integrations/crawl4ai"><b>Crawl4AI</b></a><br/><img src="https://img.shields.io/badge/Python-3776AB?logo=python&logoColor=white&style=flat-square" height="18"></td>
-</tr>
-<tr>
-<td align="center" width="160"><a href="https://docs.openlit.io/latest/sdk/integrations/dynamiq"><b>Dynamiq</b></a><br/><img src="https://img.shields.io/badge/Python-3776AB?logo=python&logoColor=white&style=flat-square" height="18"></td>
-<td align="center" width="160"><a href="https://docs.openlit.io/latest/sdk/integrations/openai-agents"><b>OpenAI Agents</b></a><br/><img src="https://img.shields.io/badge/Python-3776AB?logo=python&logoColor=white&style=flat-square" height="18"> <img src="https://img.shields.io/badge/TypeScript-3178C6?logo=typescript&logoColor=white&style=flat-square" height="18"></td>
-<td align="center" width="160"><a href="https://docs.openlit.io/latest/sdk/integrations/firecrawl"><b>Firecrawl</b></a><br/><img src="https://img.shields.io/badge/Python-3776AB?logo=python&logoColor=white&style=flat-square" height="18"></td>
-<td align="center" width="160"><a href="https://docs.openlit.io/latest/sdk/integrations/google-adk"><b>Google ADK</b></a><br/><img src="https://img.shields.io/badge/Python-3776AB?logo=python&logoColor=white&style=flat-square" height="18"> <img src="https://img.shields.io/badge/TypeScript-3178C6?logo=typescript&logoColor=white&style=flat-square" height="18"></td>
-</tr>
-<tr>
-<td align="center" width="160"><a href="https://docs.openlit.io/latest/sdk/integrations/langgraph"><b>LangGraph</b></a><br/><img src="https://img.shields.io/badge/Python-3776AB?logo=python&logoColor=white&style=flat-square" height="18"> <img src="https://img.shields.io/badge/TypeScript-3178C6?logo=typescript&logoColor=white&style=flat-square" height="18"></td>
-<td align="center" width="160"><a href="https://docs.openlit.io/latest/sdk/integrations/smolagents"><b>Smolagents</b></a><br/><img src="https://img.shields.io/badge/Python-3776AB?logo=python&logoColor=white&style=flat-square" height="18"></td>
-<td align="center" width="160"><a href="https://docs.openlit.io/latest/sdk/integrations/strands"><b>Strands Agents</b></a><br/><img src="https://img.shields.io/badge/Python-3776AB?logo=python&logoColor=white&style=flat-square" height="18"> <img src="https://img.shields.io/badge/TypeScript-3178C6?logo=typescript&logoColor=white&style=flat-square" height="18"></td>
-<td align="center" width="160"><a href="https://docs.openlit.io/latest/sdk/integrations/claude-agent-sdk"><b>Claude Agent SDK</b></a><br/><img src="https://img.shields.io/badge/Python-3776AB?logo=python&logoColor=white&style=flat-square" height="18"> <img src="https://img.shields.io/badge/TypeScript-3178C6?logo=typescript&logoColor=white&style=flat-square" height="18"></td>
-</tr>
-<tr>
-<td align="center" width="160"><a href="https://docs.openlit.io/latest/sdk/integrations/agent-framework"><b>MS Agent Framework</b></a><br/><img src="https://img.shields.io/badge/Python-3776AB?logo=python&logoColor=white&style=flat-square" height="18"></td>
-<td align="center" width="160"><a href="https://docs.openlit.io/latest/sdk/integrations/vercel-ai"><b>Vercel AI</b></a><br/><img src="https://img.shields.io/badge/TypeScript-3178C6?logo=typescript&logoColor=white&style=flat-square" height="18"></td>
-</tr>
-</table>
+> **Make AI systems observable, measurable, debuggable, and continuously improvable.**
-### Vector Databases
+---
-<table>
-<tr>
-<td align="center" width="160"><a href="https://docs.openlit.io/latest/sdk/integrations/pinecone"><b>Pinecone</b></a><br/><img src="https://img.shields.io/badge/Python-3776AB?logo=python&logoColor=white&style=flat-square" height="18"> <img src="https://img.shields.io/badge/TypeScript-3178C6?logo=typescript&logoColor=white&style=flat-square" height="18"></td>
-<td align="center" width="160"><a href="https://docs.openlit.io/latest/sdk/integrations/chromadb"><b>ChromaDB</b></a><br/><img src="https://img.shields.io/badge/Python-3776AB?logo=python&logoColor=white&style=flat-square" height="18"> <img src="https://img.shields.io/badge/TypeScript-3178C6?logo=typescript&logoColor=white&style=flat-square" height="18"></td>
-<td align="center" width="160"><a href="https://docs.openlit.io/latest/sdk/integrations/qdrant"><b>Qdrant</b></a><br/><img src="https://img.shields.io/badge/Python-3776AB?logo=python&logoColor=white&style=flat-square" height="18"> <img src="https://img.shields.io/badge/TypeScript-3178C6?logo=typescript&logoColor=white&style=flat-square" height="18"></td>
-<td align="center" width="160"><a href="https://docs.openlit.io/latest/sdk/integrations/milvus"><b>Milvus</b></a><br/><img src="https://img.shields.io/badge/Python-3776AB?logo=python&logoColor=white&style=flat-square" height="18"> <img src="https://img.shields.io/badge/TypeScript-3178C6?logo=typescript&logoColor=white&style=flat-square" height="18"></td>
-</tr>
-<tr>
-<td align="center" width="160"><a href="https://docs.openlit.io/latest/sdk/integrations/astradb"><b>Astra DB</b></a><br/><img src="https://img.shields.io/badge/Python-3776AB?logo=python&logoColor=white&style=flat-square" height="18"></td>
-<td align="center" width="160"><a href="https://docs.openlit.io/latest/sdk/integrations/psycopg"><b>PostgreSQL</b></a><br/><img src="https://img.shields.io/badge/Python-3776AB?logo=python&logoColor=white&style=flat-square" height="18"></td>
-</tr>
-</table>
+# 🌎 Community
-### Specialized Tools
+OpenLIT is open source and built with the AI engineering community.
-<table>
-<tr>
-<td align="center" width="160"><a href="https://docs.openlit.io/latest/sdk/integrations/elevenlabs"><b>ElevenLabs</b></a><br/><img src="https://img.shields.io/badge/Python-3776AB?logo=python&logoColor=white&style=flat-square" height="18"> <img src="https://img.shields.io/badge/TypeScript-3178C6?logo=typescript&logoColor=white&style=flat-square" height="18"></td>
-<td align="center" width="160"><a href="https://docs.openlit.io/latest/sdk/integrations/assemblyai"><b>AssemblyAI</b></a><br/><img src="https://img.shields.io/badge/Python-3776AB?logo=python&logoColor=white&style=flat-square" height="18"></td>
-<td align="center" width="160"><a href="https://docs.openlit.io/latest/sdk/integrations/mcp"><b>MCP</b></a><br/><img src="https://img.shields.io/badge/Python-3776AB?logo=python&logoColor=white&style=flat-square" height="18"></td>
-</tr>
-</table>
+Join us:
-## 🛣️ Roadmap
+* [GitHub](https://github.com/openlit/openlit)
+* [Documentation](https://docs.openlit.io/)
+* [Slack](https://join.slack.com/t/openlit/shared_invite/zt-2etnfttwg-TjP_7BZXfYg84oAukY8QRQ)
+* [X / Twitter](https://twitter.com/openlit_io)
-We are dedicated to continuously improving OpenLIT. Here's a look at what's been accomplished and what's on the horizon:
+If OpenLIT is useful to you, **please consider giving the repository a ⭐**.
-| Feature | Status |
-| --------------------------------------------------------------------------------------------------------------------------------- | ------------- |
-| [OpenTelemetry-native Observability SDK for Tracing and Metrics](https://github.com/openlit/openlit/tree/text-upgrade/sdk/python) | ✅ Completed |
-| [OpenTelemetry-native GPU Monitoring](https://docs.openlit.io/latest/features/gpu) | ✅ Completed |
-| [Exceptions and Error Monitoring](https://docs.openlit.io/latest/features/exceptions) | ✅ Completed |
-| [Prompt Hub for Managing and Versioning Prompts](https://docs.openlit.io/latest/features/prompt-hub) | ✅ Completed |
-| [OpenGround for Testing and Comparing LLMs](https://docs.openlit.io/latest/features/openground) | ✅ Completed |
-| [Vault for Central Management of LLM API Keys and Secrets](https://docs.openlit.io/latest/features/vault) | ✅ Completed |
-| [Cost Tracking for Custom Models](https://docs.openlit.io/latest/features/pricing) | ✅ Completed |
-| [Real-Time Guardrails Implementation](https://docs.openlit.io/latest/features/guardrails) | ✅ Completed |
-| [Programmatic Evaluation for LLM Response](https://docs.openlit.io/latest/features/evaluations) | ✅ Completed |
-| [Auto-Evaluation Metrics Based on Usage](https://github.com/openlit/openlit/issues/470) | 🔜 Coming Soon |
-| [Human Feedback for LLM Events](https://github.com/openlit/openlit/issues/471) | 🔜 Coming Soon |
-| [Dataset Generation Based on LLM Events](https://github.com/openlit/openlit/issues/472) | 🔜 Coming Soon |
-| [Search over Traces]() | 🔜 Coming Soon |
+It helps other AI engineers discover the project.
-## 🌱 Contributing
+---
-Whether it's big or small, we love contributions 💚. Check out our [Contribution guide](./CONTRIBUTING.md) to get started
+# 🤝 Contributing
-Unsure where to start? Here are a few ways to get involved:
+Contributions are welcome.
-- Join our [Slack](https://join.slack.com/t/openlit/shared_invite/zt-2etnfttwg-TjP_7BZXfYg84oAukY8QRQ) or [Discord](https://discord.gg/rjvTm6zd) community to discuss ideas, share feedback, and connect with both our team and the wider OpenLIT community.
+You can contribute by:
-Your input helps us grow and improve, and we're here to support you every step of the way.
+* fixing bugs
+* adding integrations
+* improving documentation
+* creating examples
+* improving SDKs
+* adding evaluations
+* building dashboards
+* reporting issues
+* sharing OpenLIT with other developers
-[![OpenLIT - One click observability, evals for LLMs & GPUs | Product Hunt](https://api.producthunt.com/widgets/embed-image/v1/featured.svg?post_id=460690&theme=light)](https://www.producthunt.com/posts/openlit?embed=true&utm_source=badge-featured&utm_medium=badge&utm_souce=badge-openlit)
-<a href="https://fazier.com/launches/openlit-2" target="_blank" rel="noopener noreferrer"><img src="https://fazier.com/api/v1/public/badges/embed_image.svg?launch_id=779&badge_type=daily" width="270" alt="Example Image" class="d-inline-block mt-3 p-3 rounded img-fluid" /></a>
+Check the repository's issues for opportunities to contribute.
-## 💚 Community & Support
+---
-Connect with OpenLIT community and maintainers for support, discussions, and updates:
+# 📄 License
-- 🌟 If you like it, leave a star on our [GitHub](https://github.com/openlit/openlit/).
-- 🌍 Join our [Slack](https://join.slack.com/t/openlit/shared_invite/zt-2etnfttwg-TjP_7BZXfYg84oAukY8QRQ) or [Discord](https://discord.gg/CQnXwNT3) community for live interactions and questions.
-- 🐞 Report bugs on our [GitHub Issues](https://github.com/openlit/openlit/issues) to help us improve OpenLIT.
-- 𝕏 Follow us on [X](https://twitter.com/openlit_io) for the latest updates and news.
+OpenLIT is licensed under the Apache License 2.0.
-## License
+See [LICENSE](https://github.com/openlit/openlit/blob/main/LICENSE) for details.
-OpenLIT is available under the [Apache-2.0 license](LICENSE).
+---
+# 🙇 Acknowledgments
-## 🙇‍♂️ Acknowledgments
+This project is proudly supported by:
-<p>This project is proudly supported by:</p>
<p>
- <a href="https://www.testmuai.com/?utm_medium=sponsor&utm_source=openlit" target="_blank">
- <img src="docs/images/testmu-logo.png" style={{ verticalAlign: 'middle' }} height="80" />
- </a> &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
- <a href="https://www.digitalocean.com/">
- <img src="https://opensource.nyc3.cdn.digitaloceanspaces.com/attribution/assets/SVG/DO_Logo_horizontal_blue.svg" height="80px" width="200px">
- </a>
+<a href="https://www.testmuai.com/?utm_medium=sponsor&utm_source=openlit" target="_blank">
+ <img src="docs/images/testmu-logo.png" alt="TestMu" height="80">
+</a>
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
+<a href="https://www.digitalocean.com/">
+ <img src="https://opensource.nyc3.cdn.digitaloceanspaces.com/attribution/assets/SVG/DO_Logo_horizontal_blue.svg" alt="DigitalOcean" height="80" width="200">
+</a>
</p>
-## 💻 Contributors
+---
+
+# 💻 Contributors
<a href="https://github.com/openlit/openlit/graphs/contributors">
- <img src="https://contrib.rocks/image?repo=openlit/openlit" />
+ <img src="https://contrib.rocks/image?repo=openlit/openlit" alt="OpenLIT contributors">
</a>
+
+---
+
+<div align="center">
+
+### Build AI systems you can actually understand.
+
+**⭐ Star OpenLIT on GitHub**
+
+</div>
diff --git a/docs/images/readme-hero-coding-agent-trace.png b/docs/images/readme-hero-coding-agent-trace.png
new file mode 100644
index 00000000..f82c3d1d
Binary files /dev/null and b/docs/images/readme-hero-coding-agent-trace.png differ