Repository: Arize-ai/phoenix
Stars: 9318
CLAUDE.md
AGENTS.md
README.md
<p align="center">
<a target="_blank" href="https://phoenix.arize.com" style="background:none">
<img alt="phoenix banner" src="https://github.com/Arize-ai/phoenix-assets/blob/main/images/socal/github-large-banner-phoenix-v2.jpg?raw=true" width="auto" height="auto"></img>
</a>
<br/>
<br/>
<a href="https://arize.com/docs/phoenix/">
<img src="https://img.shields.io/static/v1?message=Docs&logo=data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAIAAAACACAYAAADDPmHLAAAG4ElEQVR4nO2d4XHjNhCFcTf+b3ZgdWCmgmMqOKUC0xXYrsBOBVEqsFRB7ApCVRCygrMriFQBM7h5mNlwKBECARLg7jeDscamSQj7sFgsQfBL27ZK4MtXsT1vRADMEQEwRwTAHBEAc0QAzBEBMEcEwBwRAHNEAMwRATBnjAByFGE+MqVUMcYOY24GVUqpb/h8VErVKAf87QNFcEcbd4WSw+D6803njHscO5sATmGEURGBiCj6yUlv1uX2gv91FsDViArbcA2RUKF8QhAV8RQc0b15DcOt0VaTE1oAfWj3dYdCBfGGsmSM0XX5HsP3nEMAXbqCeCdiOERQPx9og5exGJ0S4zRQN9KrUupfpdQWjZciure/YIj7K0bjqwTyAHdovA805iqCOg2xgnB1nZ97IvaoSCURdIPG/IHGjTH/YAz/A8KdJai7lBQzgbpx/0Hg6DT18UzWMXxSjMkDrElPNEmKfAbl6znwI3IMU/OCa0/1nfckwWaSbvWYYDnEsvCMJDNckhqu7GCMKWYOBXp9yPGd5kvqUAKf6rkAk7M2SY9QDXdEr9wEOr9x96EiejMFnixBNteDISsyNw7hHRqc22evWcP4vt39O85bzZH30AKg4+eo8cQRI4bHAJ7hyYM3CNHrG9RrimSXuZmUkZjN/O6nAPpcwCcJNmipAle2QM/1GU3vITCXhvY91u9geN/jOY27VuTnYL1PCeAcRhwh7/Bl8Ai+IuxPiOCShtfX/sPDtY8w+sZjby86dw6dBeoigD7obd/Ko6fI4BF8DA9HnGdrcU0fLt+n4dfE6H5jpjYcVdu2L23b5lpjHoo+18FDbcszddF1rUee/4C6ZiO+80rHZmjDoIQUQLdRtm3brkcKIUPjjqVPBIUHgW1GGN4YfawAL2IqAVB8iEE31tvIelARlCPPVaFOLoIupzY6xVcM4MoRUyHXyHhslH6PaPl5RP1Lh4UsOeKR2e8dzC0Aiuvc2Nx3fwhfxf/hknouUYbWUk5GTAIwmOh5e+H0cor8vEL91hfOdEqINLq1AV+RKImJ6869f9tFIBVc6y7gd3lHfWyNX0LEr7EuDElhRdAlQjig0e/RU31xxDltM4pF7IY3pLIgxAhhgzF/iC2M0Hi4dkOGlyGMd/g7dsMbUlsR9ICe9WhxbA3DjRkSdjiHzQzlBSKNJsCzIcUlYdfI0dcWS8LMkPDkcJ0n/O+Qyy/IAtDkSPnp4Fu4WpthQR/zm2VcoI/51fI28iYld9/HEh4Pf7D0Bm845pwIPnHMUJSf45pT5x68s5T9AW6INzhHDeP1BYcNMew5SghkinWOwVnaBhHGG5ybMn70zBDe8buh8X6DqV0Sa/5tWOIOIbcWQ8KBiGBnMb/P0OuTd/lddCrY5jn/VLm3nL+fY4X4YREuv8vS9wh6HSkAExMs0viKySZRd44iyOH2FzPe98Fll7A7GNMmjay4GF9BAKGXesfCN0sRsDG+YrhP4O2ACFgZXzHdKPL2RMJoxc34ivFOod3AMMNUj5XxFfOtYrUIXvB5MandS+G+V/AzZ+MrEcBPlpoFtUIEwBwRAG+OIgDe1CIA5ogAmCMCYI4IgDkiAOaIAJgjAmCOCIA5IgDmiACYIwJgjgiAOSIA5ogAmCMCYI4IgDkiAOaIAJgjAmCOCIA5IgDmiACYIwJgjgiAOSIA5ogAmCMCYI4IgDkiAOaIAJgjAmDOVYBXvwvxQV8NWJOd0esvJ94babZaz7B5ovldxnlDpYhp0JFr/KTlLKcEMMQKpcDPXIQxGXsYmhZnXAXQh/EWBQrr3bc80mATyyrEvs4+BdBHgbdxFOIhrDkSg1/6Iu2LCS0AyoqI4ftUF00EY/Q3h1fRj2JKAVCMGErmnsH1lfnemEsAlByvgl0z2qx5B8OPCuB8EIMADBlEEOV79j1whNE3c/X2PmISAGUNr7CEmUSUhjfEKgBDAY+QohCiNrwhdgEYzPv7UxkadvBg0RrekMrNoAozh3vLN4DPhc7S/WL52vkoSO1u4BZC+DOCulC0KJ/gqWaP7C8hlSGgjxyCmDuPsEePT/KuasrrAcyr4H+f6fq01yd7Sz1lD0CZ2hs06PVJufs+lrIiyLwufjfBtXYpjvWnWIoHoJSYe4dIK/t4HX1ULFEACkPCm8e8wXFJvZ6y1EWhJkDcWxw7RINzLc74auGrgg8e4oIm9Sh/CA7LwkvHqaIJ9pLI6Lmy1BigDy2EV8tjdzh+8XB6MGSLKH4INsZXDJ8MGhIBK+Mrpo+GnRIBO+MrZjFAFxoTNBwCvj6u4qvSZJiM3iNX4yvmHoA9Sh4PF0QAzBEBMEcEwBwRAHNEAMwRAXBGKfUfr5hKvglRfO4AAAAASUVORK5CYII=&labelColor=grey&color=blue&logoColor=white&label=%20"/>
</a>
<a target="_blank" href="https://join.slack.com/t/arize-ai/shared_invite/zt-3r07iavnk-ammtATWSlF0pSrd1DsMW7g">
<img src="https://img.shields.io/static/v1?message=Community&logo=slack&labelColor=grey&color=blue&logoColor=white&label=%20"/>
</a>
<a target="_blank" href="https://bsky.app/profile/arize-phoenix.bsky.social">
<img src="https://img.shields.io/badge/-phoenix-blue.svg?color=blue&labelColor=gray&logo=bluesky">
</a>
<a target="_blank" href="https://x.com/ArizePhoenix">
<img src="https://img.shields.io/badge/-ArizePhoenix-blue.svg?color=blue&labelColor=gray&logo=x">
</a>
<a target="_blank" href="https://pypi.org/project/arize-phoenix/">
<img src="https://img.shields.io/pypi/v/arize-phoenix?color=blue">
</a>
<a target="_blank" href="https://anaconda.org/conda-forge/arize-phoenix">
<img src="https://img.shields.io/conda/vn/conda-forge/arize-phoenix.svg?color=blue">
</a>
<a target="_blank" href="https://pypi.org/project/arize-phoenix/">
<img src="https://img.shields.io/pypi/pyversions/arize-phoenix">
</a>
<a target="_blank" href="https://hub.docker.com/r/arizephoenix/phoenix/tags">
<img src="https://img.shields.io/docker/v/arizephoenix/phoenix?sort=semver&logo=docker&label=image&color=blue">
</a>
<a target="_blank" href="https://hub.docker.com/r/arizephoenix/phoenix-helm">
<img src="https://img.shields.io/badge/Helm-blue?style=flat&logo=helm&labelColor=grey"/>
</a>
<a target="_blank" href="https://github.com/Arize-ai/phoenix/tree/main/js/packages/phoenix-mcp">
<img src="https://badge.mcpx.dev?status=on" title="MCP Enabled"/>
</a>
<a href="cursor://anysphere.cursor-deeplink/mcp/install?name=phoenix&config=eyJjb21tYW5kIjoibnB4IC15IEBhcml6ZWFpL3Bob2VuaXgtbWNwQGxhdGVzdCAtLWJhc2VVcmwgaHR0cHM6Ly9teS1waG9lbml4LmNvbSAtLWFwaUtleSB5b3VyLWFwaS1rZXkifQ%3D%3D"><img src="https://cursor.com/deeplink/mcp-install-dark.svg" alt="Add Arize Phoenix MCP server to Cursor" height=20 /></a>
<img referrerpolicy="no-referrer-when-downgrade" src="https://static.scarf.sh/a.png?x-pxid=8e8e8b34-7900-43fa-a38f-1f070bd48c64&page=README.md" />
</p>
Phoenix is an open-source AI observability platform designed for experimentation, evaluation, and troubleshooting. It provides:
- _Tracing_ - Trace your LLM application's runtime using OpenTelemetry-based instrumentation.
- _Evaluation_ - Leverage LLMs to benchmark your application's performance using response and retrieval evals.
- _Datasets_ - Create versioned datasets of examples for experimentation, evaluation, and fine-tuning.
- _Experiments_ - Track and evaluate changes to prompts, LLMs, and retrieval.
- _Playground_- Optimize prompts, compare models, adjust parameters, and replay traced LLM calls.
- _Prompt Management_- Manage and test prompt changes systematically using version control, tagging, and experimentation.
Phoenix is vendor and language agnostic with out-of-the-box support for popular frameworks (OpenAI Agents SDK, Claude Agent SDK, LangGraph, Vercel AI SDK, Mastra, CrewAI, LlamaIndex, DSPy) and LLM providers (OpenAI, Anthropic, Google GenAI, Google ADK, AWS Bedrock, OpenRouter, LiteLLM, and more). For details on auto-instrumentation, check out the OpenInference project.
Phoenix runs practically anywhere, including your local machine, a Jupyter notebook, a containerized deployment, or in the cloud.
Installation
Install Phoenix via pip or conda
pip install arize-phoenixPhoenix container images are available via Docker Hub and can be deployed using Docker or Kubernetes. Arize AI also provides cloud instances at app.phoenix.arize.com.
Packages
The arize-phoenix package includes the entire Phoenix platform. However, if you have deployed the Phoenix platform, there are lightweight Python sub-packages and TypeScript packages that can be used in conjunction with the platform.
Python Subpackages
| Package | Version & Docs | Description |
| --------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------ |
| arize-phoenix-otel |   | Provides a lightweight wrapper around OpenTelemetry primitives with Phoenix-aware defaults |
| arize-phoenix-client |   | Lightweight client for interacting with the Phoenix server via its OpenAPI REST interface |
| arize-phoenix-evals |   | Tooling to evaluate LLM applications including RAG relevance, answer relevance, and more |
TypeScript Subpackages
| Package | Version & Docs | Description |
| --------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------ |
| @arizeai/phoenix-otel |   | Provides a lightweight wrapper around OpenTelemetry primitives with Phoenix-aware defaults |
| @arizeai/phoenix-client |   | Client for the Arize Phoenix API |
| @arizeai/phoenix-evals |   | TypeScript evaluation library for LLM applications (alpha release) |
| @arizeai/phoenix-mcp |   | MCP server implementation for Arize Phoenix providing unified interface to Phoenix's capabilities |
| @arizeai/phoenix-cli |   | CLI for fetching traces, datasets, and experiments for use with Claude Code, Cursor, and other coding agents |
Tracing Integrations
Phoenix is built on top of OpenTelemetry and is vendor, language, and framework agnostic. For details about tracing integrations and example applications, see the OpenInference project.
Python Integrations
| | Integration | Package | Version |
|:---:|---|---|---|
| <picture><source media="(prefers-color-scheme: dark)" srcset="https://unpkg.com/@lobehub/icons-static-png@latest/dark/openai.png"><img height="14" src="https://unpkg.com/@lobehub/icons-static-png@latest/light/openai.png"></picture> | OpenAI | openinference-instrumentation-openai |  |
| <picture><source media="(prefers-color-scheme: dark)" srcset="https://unpkg.com/@lobehub/icons-static-png@latest/dark/openai.png"><img height="14" src="https://unpkg.com/@lobehub/icons-static-png@latest/light/openai.png"></picture> | OpenAI Agents | openinference-instrumentation-openai-agents |  |
| <img src="https://unpkg.com/@lobehub/icons-static-png@latest/dark/llamaindex-color.png" height="14"> | LlamaIndex | openinference-instrumentation-llama-index |  |
| | DSPy | openinference-instrumentation-dspy |  |
| <img src="https://unpkg.com/@lobehub/icons-static-png@latest/dark/bedrock-color.png" height="14"> | AWS Bedrock | openinference-instrumentation-bedrock |  |
| <img src="https://unpkg.com/@lobehub/icons-static-png@latest/dark/langchain-color.png" height="14"> | LangChain | openinference-instrumentation-langchain |  |
| <img src="https://unpkg.com/@lobehub/icons-static-png@latest/dark/mistral-color.png" height="14"> | MistralAI | openinference-instrumentation-mistralai |  |
| <img src="https://unpkg.com/@lobehub/icons-static-png@latest/dark/google-color.png" height="14"> | Google GenAI | openinference-instrumentation-google-genai |  |
| <img src="https://unpkg.com/@lobehub/icons-static-png@latest/dark/google-color.png" height="14"> | Google ADK | openinference-instrumentation-google-adk |  |
| | Guardrails | openinference-instrumentation-guardrails |  |
| <img src="https://unpkg.com/@lobehub/icons-static-png@latest/dark/vertexai-color.png" height="14"> | VertexAI | openinference-instrumentation-vertexai |  |
| <img src="https://unpkg.com/@lobehub/icons-static-png@latest/dark/crewai-color.png" height="14"> | CrewAI | openinference-instrumentation-crewai |  |
| | Haystack | openinference-instrumentation-haystack |  |
| | LiteLLM | openinference-instrumentation-litellm |  |
| <picture><source media="(prefers-color-scheme: dark)" srcset="https://unpkg.com/@lobehub/icons-static-png@latest/dark/groq.png"><img height="14" src="https://unpkg.com/@lobehub/icons-static-png@latest/light/groq.png"></picture> | Groq | openinference-instrumentation-groq |  |
| | Instructor | openinference-instrumentation-instructor |  |
| <picture><source media="(prefers-color-scheme: dark)" srcset="https://unpkg.com/@lobehub/icons-static-png@latest/dark/anthropic.png"><img height="14" src="https://unpkg.com/@lobehub/icons-static-png@latest/light/anthropic.png"></picture> | Anthropic | openinference-instrumentation-anthropic |  |
| <img src="https://unpkg.com/@lobehub/icons-static-png@latest/dark/huggingface-color.png" height="14"> | Smolagents | openinference-instrumentation-smolagents |  |
| | Agno | openinference-instrumentation-agno |  |
| <picture><source media="(prefers-color-scheme: dark)" srcset="https://unpkg.com/@lobehub/icons-static-png@latest/dark/mcp.png"><img height="14" src="https://unpkg.com/@lobehub/icons-static-png@latest/light/mcp.png"></picture> | MCP | openinference-instrumentation-mcp |  |
| <img src="https://unpkg.com/@lobehub/icons-static-png@latest/dark/pydanticai-color.png" height="14"> | Pydantic AI | openinference-instrumentation-pydantic-ai |  |
| | Autogen AgentChat | openinference-instrumentation-autogen-agentchat |  |
| | Portkey | openinference-instrumentation-portkey |  |
| | Agent Spec | openinference-instrumentation-agentspec |  |
| <img src="https://unpkg.com/@lobehub/icons-static-png@latest/dark/claude-color.png" height="14"> | Claude Agent SDK | openinference-instrumentation-claude-agent-sdk |  |
Span Processors
Normalize and convert data across other instrumentation libraries by adding span processors that unify data.
| Package | Description | Version |
| ----------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| openinference-instrumentation-openlit | OpenInference Span Processor for OpenLIT traces. |  |
| openinference-instrumentation-openllmetry | OpenInference Span Processor for OpenLLMetry (Traceloop) traces. |  |
JavaScript Integrations
| | Integration | Package | Version |
|:---:|---|---|---|
| <picture><source media="(prefers-color-scheme: dark)" srcset="https://unpkg.com/@lobehub/icons-static-png@latest/dark/openai.png"><img height="14" src="https://unpkg.com/@lobehub/icons-static-png@latest/light/openai.png"></picture> | OpenAI | @arizeai/openinference-instrumentation-openai |  |
| <img src="https://unpkg.com/@lobehub/icons-static-png@latest/dark/langchain-color.png" height="14"> | LangChain.js | @arizeai/openinference-instrumentation-langchain |  |
| <picture><source media="(prefers-color-scheme: dark)" srcset="https://unpkg.com/@lobehub/icons-static-png@latest/dark/vercel.png"><img height="14" src="https://unpkg.com/@lobehub/icons-static-png@latest/light/vercel.png"></picture> | Vercel AI SDK | @arizeai/openinference-vercel |  |
| | BeeAI | @arizeai/openinference-instrumentation-beeai |  |
| <img src="https://unpkg.com/@lobehub/icons-static-png@latest/dark/claude-color.png" height="14"> | Claude Agent SDK | @arizeai/openinference-instrumentation-claude-agent-sdk |  |
| <picture><source media="(prefers-color-scheme: dark)" srcset="https://unpkg.com/@lobehub/icons-static-png@latest/dark/mastra.png"><img height="14" src="https://unpkg.com/@lobehub/icons-static-png@latest/light/mastra.png"></picture> | Mastra | @mastra/arize |  |
| <picture><source media="(prefers-color-scheme: dark)" srcset="https://unpkg.com/@lobehub/icons-static-png@latest/dark/mcp.png"><img height="14" src="https://unpkg.com/@lobehub/icons-static-png@latest/light/mcp.png"></picture> | MCP | @arizeai/openinference-instrumentation-mcp |  |
Java Integrations
| | Integration | Package | Version |
|:---:|---|---|---|
| <img src="https://unpkg.com/@lobehub/icons-static-png@latest/dark/langchain-color.png" height="14"> | LangChain4j | openinference-instrumentation-langchain4j |  |
| | SpringAI | openinference-instrumentation-springAI |  |
| | Arconia | openinference-instrumentation-springAI |  |
Platforms
| | Platform | Description | Docs |
|:---:|---|---|---|
| | BeeAI | AI agent framework with built-in observability | Integration Guide |
| <img src="https://unpkg.com/@lobehub/icons-static-png@latest/dark/dify-color.png" height="14"> | Dify | Open-source LLM app development platform | Integration Guide |
| | Envoy AI Gateway | AI Gateway built on Envoy Proxy for AI workloads | Integration Guide |
| | LangFlow | Visual framework for building multi-agent and RAG applications | Integration Guide |
| | LiteLLM Proxy | Proxy server for LLMs | Integration Guide |
| | Flowise | Visual framework for building LLM applications | Integration Guide |
| | Prompt Flow | Microsoft's prompt flow orchestration tool | Integration Guide |
| <img src="https://unpkg.com/@lobehub/icons-static-png@latest/dark/nvidia-color.png" height="14"> | NVIDIA NeMo | NVIDIA NeMo Agent Toolkit for enterprise agents | Integration Guide |
| | Graphite | Multi-agent LLM workflow framework with visual builder | Integration Guide |
Coding Agent Skills
This repository includes skills that teach coding agents how to work with Phoenix. They are located in .agents/skills/ and can be used with Claude Code, Cursor, and other compatible tools.
| Skill | Description |
| ----- | ----------- |
| phoenix-cli | Debug LLM applications using the Phoenix CLI β fetch traces, analyze errors, review experiments, and query the GraphQL API |
| phoenix-evals | Build and run evaluators for AI/LLM applications using Phoenix |
| phoenix-tracing | OpenInference semantic conventions and instrumentation for tracing LLM applications |
Security & Privacy
We take data security and privacy very seriously. For more details, see our Security and Privacy documentation.
Telemetry
By default, Phoenix collects basic web analytics (e.g., page views, UI interactions) to help us understand how Phoenix is used and improve the product. None of your trace data, evaluation results, or any sensitive information is ever collected.
You can opt-out of telemetry by setting the environment variable: PHOENIX_TELEMETRY_ENABLED=false
Community
Join our community to connect with thousands of AI builders.
- π Join our Slack community.
- π Read our documentation.
- π‘ Ask questions and provide feedback in the _#phoenix-support_ channel.
- π Leave a star on our GitHub.
- π Report bugs with GitHub Issues.
- π Follow us on π.
- πΊοΈ Check out our roadmap to see where we're heading next.
- π§βπ« Deep dive into everything Agents and LLM Evaluations on Arize's Learning Hubs.
Breaking Changes
See the migration guide for a list of breaking changes.
Copyright, Patent, and License
Copyright 2025 Arize AI, Inc. All Rights Reserved.
Portions of this code are patent protected by one or more U.S. Patents. See the IP_NOTICE.
This software is licensed under the terms of the Elastic License 2.0 (ELv2). See LICENSE.