Environments

The Phoenix app can be run in various notebook environments such as colab and SageMaker as well as be served via the terminal or a docker container

In the notebook

Run phoenix in the notebook as you run experiments

As a Container

Start a long-running collector

From the Terminal

Run phoenix via the CLI

Notebooks

To start phoenix in the notebook environment, run:

import phoenix as px

session = px.launch_app()

This will start a local Phoenix server. You can initialize the phoenix server with various kinds of data (traces, inferences). Check out the API for details

By default, Phoenix does not persist your data when run in a notebook.

Container

Phoenix server images are available via Docker Hub. The hosted phoenix server runs as a trace collector and can be used if you want observability for LLM traces via docker compose or simply want a long-running phoenix instance. Below are examples of how to run phoenix va Docker for a specific version.

First pull the image you want to run (note you can use the tag latest if you would just like the latest version)

docker pull arizephoenix/phoenix:latest

Now you can run the image you pulled (note you must expose the port 6006 so you can view the UI).

docker run -p 6006:6006 arizephoenix/phoenix:latest

The Phoenix UI will be available at localhost:6006.

If you deploy the Phoenix server (collector) to a remote machine, you will have to make sure to configure the remote endpoint as the collector endpoint.

Set Endpoint Environment Variable

import os

os.environ["PHOENIX_COLLECTOR_ENDPOINT"] = "http://123.456.789:6006"

Note that the above is only necessary if your application is running in a Jupyter notebook. If you are trying to deploy your application and have phoenix collect traces via a container, please consult the deployment guide.

Terminal

If you want to start a phoenix server to collect traces, you can also run phoenix directly from the command line

v5.2.0 or later

phoenix serve

Pre-v5.2.0

python3 -m phoenix.server.main serve

This will start the phoenix server on port 6006. If you are running your instrumented notebook or application on the same machine, traces should automatically be exported to http://127.0.0.1:6006 so no additional configuration is needed. However if the server is running remotely, you will have to modify the environment variable PHOENIX_COLLECTOR_ENDPOINT to point to that machine (e.g. http://<my-remote-machine>:<port>)