MCPcopy Index your code
hub / github.com/Arize-ai/phoenix

github.com/Arize-ai/phoenix @arize-phoenix-v17.16.0 sqlite

repository ↗ · DeepWiki ↗ · release arize-phoenix-v17.16.0 ↗
21,084 symbols 86,982 edges 4,364 files 5,338 documented · 25%
README
<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>






<a href="https://arize.com/docs/phoenix/">
    <img src="https://img.shields.io/static/v1?message=Docs&logo=data:image/png;base64,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&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://www.linkedin.com/showcase/113218220">
    <img src="https://img.shields.io/badge/-ArizePhoenix-blue.svg?color=blue&labelColor=gray&logo=linkedin">
</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="https://github.com/Arize-ai/phoenix/raw/arize-phoenix-v17.16.0/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" />

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.
  • PXI (Phoenix Intelligence) - An AI engineering agent built into Phoenix for debugging traces, iterating on prompts, and navigating the product.

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-phoenix

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

TypeScript Subpackages

Package Version & Docs Description
@arizeai/phoenix-otel NPM Version Docs Provides a lightweight wrapper around OpenTelemetry primitives with Phoenix-aware defaults
@arizeai/phoenix-client NPM Version Docs Client for the Arize Phoenix API
@arizeai/phoenix-evals NPM Version Docs TypeScript evaluation library for LLM applications (alpha release)
@arizeai/phoenix-mcp [![NPM

Extension points exported contracts — how you extend this code

RateLimiter (Interface)
(no doc) [16 implementers]
scripts/mock-llm-server/src/rate-limiting/types.ts
Sender (Interface)
* Internal type for blocked senders waiting to deliver values
js/packages/phoenix-client/src/utils/channel.ts
IAdditionalSpansRow (Interface)
* An indicator that this row is an additional row, not a span
app/src/pages/project/TracesTable.tsx
AuthQueryParams (Interface)
OAuth/OIDC query params from authorization or user-selection requests.
scripts/docker/devops/oidc-server/src/oidc/server.ts
Message (Interface)
(no doc)
js/examples/apps/tracing-tutorial/support-agent.ts
LabelAccumulator (Interface)
(no doc)
js/benchmarks/evals-benchmarks/src/aggregateMetrics.ts
StackedBarChartProps (Interface)
(no doc)
app/stories/StackedTimeSeriesBarChart.stories.tsx
Actor (Interface)
(no doc)
scripts/gh-comment-watch/src/discussions.ts

Core symbols most depended-on inside this repo

get
called by 1969
src/phoenix/server/jwt_store.py
pop
called by 1212
src/phoenix/server/jwt_store.py
append
called by 1200
src/phoenix/server/api/types/Segments.py
where
called by 1131
src/phoenix/trace/dsl/query.py
getState
called by 738
scripts/mock-llm-server/src/rate-limiting/types.ts
get
called by 539
packages/phoenix-client/src/phoenix/client/resources/prompts/__init__.py
filter
called by 423
src/phoenix/logging/_filter.py
graphql
called by 422
scripts/gh-comment-watch/src/github.ts

Shape

Function 9,541
Method 7,432
Class 3,240
Interface 604
Route 252
Enum 14
Struct 1

Languages

Python71%
TypeScript29%
Go1%

Modules by API surface

packages/phoenix-client/src/phoenix/client/__generated__/v1/__init__.py253 symbols
src/phoenix/db/models.py199 symbols
packages/phoenix-evals/tests/phoenix/evals/test_evaluators.py165 symbols
scripts/ci/test_helm.py164 symbols
tests/integration/_helpers.py162 symbols
tests/unit/server/api/helpers/test_evaluators.py157 symbols
tests/integration/auth/test_auth.py139 symbols
src/phoenix/server/api/helpers/playground_clients.py135 symbols
app/src/components/core/icon/Icons.tsx135 symbols
src/phoenix/config.py134 symbols
tests/unit/test_config.py133 symbols
tests/unit/server/agents/test_agent_factory.py126 symbols

Dependencies from manifests, versioned

@ai-sdk/anthropic3.0.81 · 1×
@ai-sdk/anthropic-v5
@ai-sdk/google3.0.84 · 1×
@ai-sdk/mcp1.0.53 · 1×
@ai-sdk/openai3.0.75 · 1×
@ai-sdk/react3.0.213 · 1×
@anthropic-ai/sdk0.102.0 · 1×
@apollo/client4.2.3 · 1×
@arizeai/openinference-core2.4.0 · 1×
@arizeai/openinference-instrumentation-langchain0.2.0 · 1×
@arizeai/openinference-instrumentation-openai4.1.4 · 1×
@arizeai/openinference-semantic-conventions2.5.0 · 1×

Datastores touched

postgresDatabase · 1 repos
phoenixDatabase · 1 repos
dbnameDatabase · 1 repos
users_prodDatabase · 1 repos

For agents

$ claude mcp add phoenix \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact