Home
Softono
phoenix

phoenix

Open source Python
10.1K
Stars
912
Forks
586
Issues
55
Watchers
6 days
Last Commit

About phoenix

<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/1nfckwWaSbvWYYDnEsvCMJDNckhqu7GCMK ...

Platforms

Web Self-hosted

Languages

Python

phoenix banner

Add Arize Phoenix MCP server to Cursor

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 (Built-in Agent) - Debug traces, iterate on prompts, and navigate Phoenix with an opt-in, permission-gated agent built into 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 Version Docs MCP server implementation for Arize Phoenix providing unified interface to Phoenix's capabilities
@arizeai/phoenix-cli NPM Version Docs 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 | |:---:|---|---|---| | | OpenAI | openinference-instrumentation-openai | PyPI Version | | | OpenAI Agents | openinference-instrumentation-openai-agents | PyPI Version | | | LlamaIndex | openinference-instrumentation-llama-index | PyPI Version | | | DSPy | openinference-instrumentation-dspy | PyPI Version | | | AWS Bedrock | openinference-instrumentation-bedrock | PyPI Version | | | LangChain | openinference-instrumentation-langchain | PyPI Version | | | MistralAI | openinference-instrumentation-mistralai | PyPI Version | | | Google GenAI | openinference-instrumentation-google-genai | PyPI Version | | | Google ADK | openinference-instrumentation-google-adk | PyPI Version | | | Guardrails | openinference-instrumentation-guardrails | PyPI Version | | | VertexAI | openinference-instrumentation-vertexai | PyPI Version | | | CrewAI | openinference-instrumentation-crewai | PyPI Version | | | Haystack | openinference-instrumentation-haystack | PyPI Version | | | LiteLLM | openinference-instrumentation-litellm | PyPI Version | | | Groq | openinference-instrumentation-groq | PyPI Version | | | Instructor | openinference-instrumentation-instructor | PyPI Version | | | Anthropic | openinference-instrumentation-anthropic | PyPI Version | | | Smolagents | openinference-instrumentation-smolagents | PyPI Version | | | Agno | openinference-instrumentation-agno | PyPI Version | | | MCP | openinference-instrumentation-mcp | PyPI Version | | | Pydantic AI | openinference-instrumentation-pydantic-ai | PyPI Version | | | Autogen AgentChat | openinference-instrumentation-autogen-agentchat | PyPI Version | | | Portkey | openinference-instrumentation-portkey | PyPI Version | | | Agent Spec | openinference-instrumentation-agentspec | PyPI Version | | | Claude Agent SDK | openinference-instrumentation-claude-agent-sdk | PyPI Version |

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

JavaScript Integrations

Integration Package Version
OpenAI @arizeai/openinference-instrumentation-openai NPM Version
LangChain.js @arizeai/openinference-instrumentation-langchain NPM Version
Vercel AI SDK @arizeai/openinference-vercel NPM Version
BeeAI @arizeai/openinference-instrumentation-beeai NPM Version
Claude Agent SDK @arizeai/openinference-instrumentation-claude-agent-sdk NPM Version
Mastra @mastra/arize NPM Version
MCP @arizeai/openinference-instrumentation-mcp NPM Version

Java Integrations

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

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

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 𝕏.
  • πŸ’Ό Follow us on LinkedIn.
  • πŸ—ΊοΈ 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.