Profile
Back to NewsBack
GitHub Trending 5 min
Reader Mode
Arize-ai/phoenix: AI Observability & Evaluation

Arize-ai/phoenix: AI Observability & Evaluation

15 hours ago

phoenix banner

English · 简体中文

Add Arize Phoenix MCP server to Cursor

Arize Phoenix is Arize's open-source AI observability platform designed for experimentation, evaluation, and troubleshooting. For managed production workflows, Arize also offers Arize AX. Phoenix 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.
  • _PXI (Phoenix Intelligence)_ - An AI engineering agent built into Phoenix for debugging traces, iterating on prompts, and navigating the product.
  • _Remote MCP Server_ - Connect Claude Code, Cursor, and other MCP clients directly to your Phoenix instance's /mcp endpoint to query traces, datasets, experiments, and more.

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 containerized deployment, or in the cloud. See Environments for a walkthrough of each option, or jump straight into the Tracing Quickstart.

[!NOTE]
Phoenix is open-source and self-hosted. For a managed platform, Arize offers Arize AX — the same OpenTelemetry/OpenInference instrumentation works with both. See the full comparison.

Table of Contents

Run Locally

Install Phoenix via pip or conda and have a fully functional Phoenix. For all installation and hosting options, see the install guide.

pip install arize-phoenix
phoenix serve

Or run it with no install using uvx:

uvx arize-phoenix serve

Trace Your Application

The fastest way to send traces is to let your coding agent (Claude Code, Codex, Cursor, and others) instrument your app. From your project directory, run:

npx @arizeai/phoenix-cli setup

or, with Phoenix installed: px setup

Setup detects your framework and LLM provider, installs the right OpenInference instrumentation, and wires up trace export. Prefer to wire it up in code? See the tracing documentation.

Deploy

Phoenix container images are available via Docker Hub and can be deployed using Docker or Kubernetes via the Helm chart.

For Docker Compose, Kubernetes/Helm, and other deployment options, see the self-hosting documentation.

Deploy on Railway   Deploy to Render   Run on Google Cloud   Deploy to Azure   Deploy to AWS

[!NOTE]
The Google Cloud button builds Phoenix from source in Cloud Shell rather than deploying the prebuilt Docker Hub image. The Azure template serves plain HTTP (Azure Container Instances does not terminate TLS) — front it with a TLS proxy such as an Application Gateway before production use.

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 | PyPI Version</a> Docs</a> | Provides a lightweight wrapper around OpenTelemetry primitives with Phoenix-aware defaults | | arize-phoenix-client | PyPI Version</a> Docs</a> | Lightweight client for interacting with the Phoenix server via its OpenAPI REST interface | | arize-phoenix-evals | PyPI Version</a> Docs</a> | Tooling to evaluate LLM applications including RAG relevance, answer relevance, and more |

TypeScript Subpackages

| Package | Version & Docs | Description | | --------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------ | | @arizeai/phoenix-otel | NPM Version</a> Docs</a> | Provides a lightweight wrapper around OpenTelemetry primitives with Phoenix-aware defaults | | @arizeai/phoenix-client | NPM Version</a> Docs</a> | Client for the Arize Phoenix API | | @arizeai/phoenix-evals | NPM Version</a> Docs</a> | TypeScript evaluation library for LLM applications (alpha release) | | @arizeai/phoenix-mcp | NPM Version</a> Docs</a> | Standalone stdio MCP server for older Phoenix versions (maintenance mode — superseded by the remote MCP server built into Phoenix) | | @arizeai/phoenix-cli | NPM Version</a> Docs</a> | 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 and the integrations documentation.

Python Integrations | | Integration | Package | Version | |:---:|---|---|---| | | OpenAI | openinference-instrumentation-openai | PyPI Version</a> | | | OpenAI Agents | openinference-instrumentation-openai-agents | PyPI Version</a> | | | LlamaIndex | openinference-instrumentation-llama-index | PyPI Version</a> | | | DSPy | openinference-instrumentation-dspy | PyPI Version</a> | | | AWS Bedrock | openinference-instrumentation-bedrock | PyPI Version</a> | | | LangChain | openinference-instrumentation-langchain | PyPI Version</a> | | | LangGraph | openinference-instrumentation-langchain | PyPI Version</a> | | | MistralAI | openinference-instrumentation-mistralai | PyPI Version</a> | | | Cohere | openinference-instrumentation-cohere | PyPI Version</a> | | | Together AI | openinference-instrumentation-together | PyPI Version</a> | | | Ollama | openinference-instrumentation-ollama | PyPI Version</a> | | | Google GenAI | openinference-instrumentation-google-genai | PyPI Version</a> | | | Google ADK | openinference-instrumentation-google-adk | PyPI Version</a> | | | Guardrails | openinference-instrumentation-guardrails | PyPI Version</a> | | | VertexAI | openinference-instrumentation-vertexai | PyPI Version</a> | | | CrewAI | openinference-instrumentation-crewai | PyPI Version</a> | | | Haystack | openinference-instrumentation-haystack | PyPI Version</a> | | | LiteLLM | openinference-instrumentation-litellm | PyPI Version</a> | | | OpenRouter | openinference-instrumentation-openai | PyPI Version</a> | | | OrcaRouter | openinference-instrumentation-openai | PyPI Version</a> | | | Groq | openinference-instrumentation-groq | PyPI Version</a> | | | Instructor | openinference-instrumentation-instructor | PyPI Version</a> | | | Anthropic | openinference-instrumentation-anthropic | PyPI Version</a> | | | Smolagents | openinference-instrumentation-smolagents | PyPI Version</a> | | | Agno | openinference-instrumentation-agno | PyPI Version</a> | | | BeeAI | openinference-instrumentation-beeai | PyPI Version</a> | | | Strands Agents | openinference-instrumentation-strands-agents | PyPI Version</a> | | | Restate | openinference-instrumentation-openai-agents | PyPI Version</a> | | | MCP | openinference-instrumentation-mcp | PyPI Version</a> | | | Pydantic AI | openinference-instrumentation-pydantic-ai | PyPI Version</a> | | | AG2 | openinference-instrumentation-ag2 | PyPI Version</a> | | | Autogen AgentChat | openinference-instrumentation-autogen-agentchat | PyPI Version</a> | | | Portkey | openinference-instrumentation-portkey | PyPI Version</a> | | | Agent Spec | openinference-instrumentation-agentspec | PyPI Version</a> | | | Claude Agent SDK | openinference-instrumentation-claude-agent-sdk | PyPI Version</a> |

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. | PyPI Version</a> | | openinference-instrumentation-openllmetry | OpenInference Span Processor for OpenLLMetry (Traceloop) traces. | PyPI Version</a> |

JavaScript Integrations

| | Integration | Package | Version | | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | ------------------------------------------------------------------------------------------- | --------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | | OpenAI | @arizeai/openinference-instrumentation-openai | NPM Version</a> | | | OpenAI Agents | @arizeai/openinference-instrumentation-openai-agents | NPM Version</a> | | | LangChain.js | @arizeai/openinference-instrumentation-langchain | NPM Version</a> | | | TanStack AI | @arizeai/openinference-tanstack-ai | NPM Version</a> | | | Vercel AI SDK | @arizeai/openinference-vercel | NPM Version</a> | | | BeeAI | @arizeai/openinference-instrumentation-beeai | NPM Version</a> | | | Claude Agent SDK | @arizeai/openinference-instrumentation-claude-agent-sdk | NPM Version</a> | | | Mastra | @mastra/arize | NPM Version</a> | | | MCP | @arizeai/openinference-instrumentation-mcp | NPM Version</a> |

Java Integrations

| | Integration | Package | Version | | :-------------------------------------------------------------------------------------------------: | --------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | | LangChain4j | openinference-instrumentation-langchain4j | Maven Central</a> | | | SpringAI | openinference-instrumentation-springAI | Maven Central</a> | | | Arconia for Spring AI | io.arconia:arconia-openinference-semantic-conventions | Maven Central</a> |

Go Integrations

| | Integration | Package | Version | | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | ------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | | OpenAI | github.com/Arize-ai/openinference/go/openinference-instrumentation-openai-go | Go Reference</a> | | | Anthropic | github.com/Arize-ai/openinference/go/openinference-instrumentation-anthropic-sdk-go | Go Reference</a> |

Platforms

| | Platform | Description | Docs | | :----------------------------------------------------------------------------------------------: | -------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------- | | | BeeAI | AI agent framework with built-in observability | Integration Guide | | | 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 | | | NVIDIA NeMo | NVIDIA NeMo Agent Toolkit for enterprise agents | Integration Guide | | | Graphite | Multi-agent LLM workflow framework with visual builder | Integration Guide |

Sandboxes

Run Phoenix [cod

... (README truncated for length)

Chat with me