arize-phoenix 4.31.0__tar.gz → 4.32.0__tar.gz

{arize_phoenix-4.31.0 → arize_phoenix-4.32.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: arize-phoenix
-Version: 4.31.0
+Version: 4.32.0
 Summary: AI Observability and Evaluation
 Project-URL: Documentation, https://docs.arize.com/phoenix/
 Project-URL: Issues, https://github.com/Arize-ai/phoenix/issues
@@ -99,7 +99,10 @@ Requires-Dist: pytest==8.3.2; extra == 'dev'
 Requires-Dist: ruff==0.6.1; extra == 'dev'
 Requires-Dist: strawberry-graphql[debug-server,opentelemetry]==0.236.0; extra == 'dev'
 Requires-Dist: tabulate; extra == 'dev'
+Requires-Dist: tox; extra == 'dev'
+Requires-Dist: tox-uv; extra == 'dev'
 Requires-Dist: types-tabulate; extra == 'dev'
+Requires-Dist: uv; extra == 'dev'
 Requires-Dist: uvloop; (platform_system != 'Windows') and extra == 'dev'
 Provides-Extra: evals
 Provides-Extra: experimental
@@ -157,10 +160,10 @@ Phoenix runs practically anywhere, including your Jupyter notebook, local machin
 
 ## Installation
 
-Install Phoenix via `pip` or `conda` along with extra dependencies for running evals:
+Install Phoenix via `pip` or `conda`
 
 ```shell
-pip install 'arize-phoenix[evals]'
+pip install arize-phoenix
 ```
 
 Phoenix container images are available via [Docker Hub](https://hub.docker.com/r/arizephoenix/phoenix) and can be deployed using Docker or Kubernetes.
@@ -177,11 +180,6 @@ Join our community to connect with thousands of AI builders.
 -   💌️ Sign up for our [mailing list](https://phoenix.arize.com/#updates).
 -   🗺️ Check out our [roadmap](https://github.com/orgs/Arize-ai/projects/45) to see where we're heading next.
 
-## Thanks
-
--   [UMAP](https://github.com/lmcinnes/umap) For unlocking the ability to visualize and reason about embeddings
--   [HDBSCAN](https://github.com/scikit-learn-contrib/hdbscan) For providing a clustering algorithm to aid in the discovery of drift and performance degradation
-
 ## Breaking Changes
 
 See the [migration guide](./MIGRATION.md) for a list of breaking changes.

{arize_phoenix-4.31.0 → arize_phoenix-4.32.0}/README.md

@@ -40,10 +40,10 @@ Phoenix runs practically anywhere, including your Jupyter notebook, local machin
 
 ## Installation
 
-Install Phoenix via `pip` or `conda` along with extra dependencies for running evals:
+Install Phoenix via `pip` or `conda`
 
 ```shell
-pip install 'arize-phoenix[evals]'
+pip install arize-phoenix
 ```
 
 Phoenix container images are available via [Docker Hub](https://hub.docker.com/r/arizephoenix/phoenix) and can be deployed using Docker or Kubernetes.
@@ -60,11 +60,6 @@ Join our community to connect with thousands of AI builders.
 -   💌️ Sign up for our [mailing list](https://phoenix.arize.com/#updates).
 -   🗺️ Check out our [roadmap](https://github.com/orgs/Arize-ai/projects/45) to see where we're heading next.
 
-## Thanks
-
--   [UMAP](https://github.com/lmcinnes/umap) For unlocking the ability to visualize and reason about embeddings
--   [HDBSCAN](https://github.com/scikit-learn-contrib/hdbscan) For providing a clustering algorithm to aid in the discovery of drift and performance degradation
-
 ## Breaking Changes
 
 See the [migration guide](./MIGRATION.md) for a list of breaking changes.

{arize_phoenix-4.31.0 → arize_phoenix-4.32.0}/pyproject.toml

@@ -70,6 +70,9 @@ dynamic = ["version"]
 dev = [
   "gcsfs",
   "hatch",
+  "tox",
+  "tox-uv",
+  "uv",
   "jupyter",
   "nbqa",
   "ruff==0.6.1",

{arize_phoenix-4.31.0 → arize_phoenix-4.32.0}/src/phoenix/config.py

@@ -1,4 +1,5 @@
 import os
+import re
 import tempfile
 from logging import getLogger
 from pathlib import Path
@@ -231,6 +232,14 @@ def get_env_port() -> int:
         return PORT
     if port.isnumeric():
         return int(port)
+    if _KUBERNETES_PHOENIX_PORT_PATTERN.match(port) is not None:
+        raise ValueError(
+            'If you are deploying Phoenix with Kubernetes using a service named "phoenix", '
+            "Kubernetes will automatically generate an environment variable `PHOENIX_PORT` "
+            'of the form "tcp://<IP>:<PORT>" that is not the integer format Phoenix expects. '
+            "To resolve this issue, explicitly set the `PHOENIX_PORT` environment variable to "
+            "an integer value in your Kubernetes deployment configuration."
+        )
     raise ValueError(
         f"Invalid value for environment variable {ENV_PHOENIX_PORT}: "
         f"{port}. Value must be an integer."
@@ -313,3 +322,4 @@ def get_web_base_url() -> str:
 
 
 DEFAULT_PROJECT_NAME = "default"
+_KUBERNETES_PHOENIX_PORT_PATTERN = re.compile(r"^tcp://\d{1,3}[.]\d{1,3}[.]\d{1,3}[.]\d{1,3}:\d+$")

{arize_phoenix-4.31.0 → arize_phoenix-4.32.0}/src/phoenix/server/app.py

@@ -2,6 +2,8 @@ import asyncio
 import contextlib
 import json
 import logging
+from contextlib import AsyncExitStack
+from dataclasses import dataclass, field
 from datetime import datetime, timedelta, timezone
 from functools import cached_property
 from pathlib import Path
@@ -18,7 +20,6 @@ from typing import (
     List,
     NamedTuple,
     Optional,
-    Set,
     Tuple,
     Union,
     cast,
@@ -251,27 +252,36 @@ def _db(engine: AsyncEngine) -> Callable[[], AsyncContextManager[AsyncSession]]:
     return factory
 
 
+@dataclass(frozen=True)
+class ScaffolderConfig:
+    db: DbSessionFactory
+    tracing_fixture_names: Iterable[str] = field(default_factory=list)
+    force_fixture_ingestion: bool = False
+    scaffold_datasets: bool = False
+    phoenix_url: str = f"http://{get_env_host()}:{get_env_port()}"
+
+
 class Scaffolder(DaemonTask):
     def __init__(
         self,
-        db: DbSessionFactory,
+        config: ScaffolderConfig,
         queue_span: Callable[[Span, ProjectName], Awaitable[None]],
         queue_evaluation: Callable[[pb.Evaluation], Awaitable[None]],
-        tracing_fixture_names: Set[str] = set(),
-        force_fixture_ingestion: bool = False,
-        scaffold_datasets: bool = False,
     ) -> None:
         super().__init__()
-        self._db = db
+        self._db = config.db
         self._queue_span = queue_span
         self._queue_evaluation = queue_evaluation
-        self._tracing_fixtures = set(
-            get_trace_fixture_by_name(name) for name in tracing_fixture_names
-        )
-        self._force_fixture_ingestion = force_fixture_ingestion
-        self._scaffold_datasets = scaffold_datasets
+        self._tracing_fixtures = [
+            get_trace_fixture_by_name(name) for name in set(config.tracing_fixture_names)
+        ]
+        self._force_fixture_ingestion = config.force_fixture_ingestion
+        self._scaffold_datasets = config.scaffold_datasets
+        self._phoenix_url = config.phoenix_url
 
     async def __aenter__(self) -> None:
+        if not self._tracing_fixtures:
+            return
         await self.start()
 
     async def __aexit__(self, *args: Any, **kwargs: Any) -> None:
@@ -353,7 +363,7 @@ class Scaffolder(DaemonTask):
             await loop.run_in_executor(
                 None,
                 send_dataset_fixtures,
-                f"http://{get_env_host()}:{get_env_port()}",
+                self._phoenix_url,
                 dataset_fixtures,
             )
         except Exception as e:
@@ -370,32 +380,34 @@ def _lifespan(
     startup_callbacks: Iterable[Callable[[], None]] = (),
     shutdown_callbacks: Iterable[Callable[[], None]] = (),
     read_only: bool = False,
-    tracing_fixture_names: Set[str] = set(),
-    force_fixture_ingestion: bool = False,
-    scaffold_datasets: bool = False,
+    scaffolder_config: Optional[ScaffolderConfig] = None,
 ) -> StatefulLifespan[FastAPI]:
     @contextlib.asynccontextmanager
     async def lifespan(_: FastAPI) -> AsyncIterator[Dict[str, Any]]:
         global DB_MUTEX
         DB_MUTEX = asyncio.Lock() if db.dialect is SupportedSQLDialect.SQLITE else None
-        async with bulk_inserter as (
-            enqueue,
-            queue_span,
-            queue_evaluation,
-            enqueue_operation,
-        ), GrpcServer(
-            queue_span,
-            disabled=read_only,
-            tracer_provider=tracer_provider,
-            enable_prometheus=enable_prometheus,
-        ), dml_event_handler, Scaffolder(
-            db=db,
-            queue_span=queue_span,
-            queue_evaluation=queue_evaluation,
-            tracing_fixture_names=tracing_fixture_names,
-            force_fixture_ingestion=force_fixture_ingestion,
-            scaffold_datasets=scaffold_datasets,
-        ):
+        async with AsyncExitStack() as stack:
+            (
+                enqueue,
+                queue_span,
+                queue_evaluation,
+                enqueue_operation,
+            ) = await stack.enter_async_context(bulk_inserter)
+            grpc_server = GrpcServer(
+                queue_span,
+                disabled=read_only,
+                tracer_provider=tracer_provider,
+                enable_prometheus=enable_prometheus,
+            )
+            await stack.enter_async_context(grpc_server)
+            await stack.enter_async_context(dml_event_handler)
+            if scaffolder_config:
+                scaffolder = Scaffolder(
+                    config=scaffolder_config,
+                    queue_span=queue_span,
+                    queue_evaluation=queue_evaluation,
+                )
+                await stack.enter_async_context(scaffolder)
             for callback in startup_callbacks:
                 callback()
             yield {
@@ -587,9 +599,7 @@ def create_app(
     startup_callbacks: Iterable[Callable[[], None]] = (),
     shutdown_callbacks: Iterable[Callable[[], None]] = (),
     secret: Optional[str] = None,
-    tracing_fixture_names: Set[str] = set(),
-    force_fixture_ingestion: bool = False,
-    scaffold_datasets: bool = False,
+    scaffolder_config: Optional[ScaffolderConfig] = None,
 ) -> FastAPI:
     startup_callbacks_list: List[Callable[[], None]] = list(startup_callbacks)
     shutdown_callbacks_list: List[Callable[[], None]] = list(shutdown_callbacks)
@@ -675,9 +685,7 @@ def create_app(
             enable_prometheus=enable_prometheus,
             shutdown_callbacks=shutdown_callbacks_list,
             startup_callbacks=startup_callbacks_list,
-            tracing_fixture_names=tracing_fixture_names,
-            force_fixture_ingestion=force_fixture_ingestion,
-            scaffold_datasets=scaffold_datasets,
+            scaffolder_config=scaffolder_config,
         ),
         middleware=[
             Middleware(HeadersMiddleware),

{arize_phoenix-4.31.0 → arize_phoenix-4.32.0}/src/phoenix/server/main.py

@@ -37,6 +37,7 @@ from phoenix.pointcloud.umap_parameters import (
     UMAPParameters,
 )
 from phoenix.server.app import (
+    ScaffolderConfig,
     _db,
     create_app,
     create_engine_and_run_migrations,
@@ -228,6 +229,7 @@ if __name__ == "__main__":
 
     force_fixture_ingestion = False
     scaffold_datasets = False
+    tracing_fixture_names = set()
     if args.command == "datasets":
         primary_inferences_name = args.primary
         reference_inferences_name = args.reference
@@ -264,7 +266,6 @@ if __name__ == "__main__":
         simulate_streaming = args.simulate_streaming
     elif args.command == "serve":
         # We use sets to avoid duplicates
-        tracing_fixture_names = set()
         if args.with_fixture:
             primary_inferences, reference_inferences, corpus_inferences = get_inferences(
                 str(args.with_fixture),
@@ -344,17 +345,25 @@ if __name__ == "__main__":
         None if corpus_inferences is None else create_model_from_inferences(corpus_inferences)
     )
     # Print information about the server
+    root_path = urljoin(f"http://{host}:{port}", host_root_path)
     msg = _WELCOME_MESSAGE.format(
         version=version("arize-phoenix"),
-        ui_path=urljoin(f"http://{host}:{port}", host_root_path),
+        ui_path=root_path,
         grpc_path=f"http://{host}:{get_env_grpc_port()}",
-        http_path=urljoin(urljoin(f"http://{host}:{port}", host_root_path), "v1/traces"),
+        http_path=urljoin(root_path, "v1/traces"),
         storage=get_printable_db_url(db_connection_str),
     )
     if authentication_enabled:
         msg += _EXPERIMENTAL_WARNING.format(auth_enabled=True)
     if sys.platform.startswith("win"):
         msg = codecs.encode(msg, "ascii", errors="ignore").decode("ascii").strip()
+    scaffolder_config = ScaffolderConfig(
+        db=factory,
+        tracing_fixture_names=tracing_fixture_names,
+        force_fixture_ingestion=force_fixture_ingestion,
+        scaffold_datasets=scaffold_datasets,
+        phoenix_url=root_path,
+    )
     app = create_app(
         db=factory,
         export_path=export_path,
@@ -372,9 +381,7 @@ if __name__ == "__main__":
         startup_callbacks=[lambda: print(msg)],
         shutdown_callbacks=instrumentation_cleanups,
         secret=secret,
-        tracing_fixture_names=tracing_fixture_names,
-        force_fixture_ingestion=force_fixture_ingestion,
-        scaffold_datasets=scaffold_datasets,
+        scaffolder_config=scaffolder_config,
     )
     server = Server(config=Config(app, host=host, port=port, root_path=host_root_path))  # type: ignore
     Thread(target=_write_pid_file_when_ready, args=(server,), daemon=True).start()

arize_phoenix-4.32.0/src/phoenix/server/static/.vite/manifest.json

@@ -0,0 +1,78 @@
+{
+  "_components-Ddr-5VpM.js": {
+    "file": "assets/components-Ddr-5VpM.js",
+    "name": "components",
+    "imports": [
+      "_vendor-Dpio9q2e.js",
+      "_vendor-arizeai-DDzwX9A6.js",
+      "_pages-CU_QMYRP.js",
+      "_vendor-three-DwGkEfCM.js",
+      "_vendor-codemirror-xRvQKK1G.js"
+    ]
+  },
+  "_pages-CU_QMYRP.js": {
+    "file": "assets/pages-CU_QMYRP.js",
+    "name": "pages",
+    "imports": [
+      "_vendor-Dpio9q2e.js",
+      "_components-Ddr-5VpM.js",
+      "_vendor-arizeai-DDzwX9A6.js",
+      "_vendor-recharts-DoxlB_Wo.js",
+      "_vendor-codemirror-xRvQKK1G.js"
+    ]
+  },
+  "_vendor-!~{003}~.js": {
+    "file": "assets/vendor-DxkFTwjz.css",
+    "src": "_vendor-!~{003}~.js"
+  },
+  "_vendor-Dpio9q2e.js": {
+    "file": "assets/vendor-Dpio9q2e.js",
+    "name": "vendor",
+    "imports": [
+      "_vendor-three-DwGkEfCM.js"
+    ],
+    "css": [
+      "assets/vendor-DxkFTwjz.css"
+    ]
+  },
+  "_vendor-arizeai-DDzwX9A6.js": {
+    "file": "assets/vendor-arizeai-DDzwX9A6.js",
+    "name": "vendor-arizeai",
+    "imports": [
+      "_vendor-Dpio9q2e.js"
+    ]
+  },
+  "_vendor-codemirror-xRvQKK1G.js": {
+    "file": "assets/vendor-codemirror-xRvQKK1G.js",
+    "name": "vendor-codemirror",
+    "imports": [
+      "_vendor-Dpio9q2e.js"
+    ]
+  },
+  "_vendor-recharts-DoxlB_Wo.js": {
+    "file": "assets/vendor-recharts-DoxlB_Wo.js",
+    "name": "vendor-recharts",
+    "imports": [
+      "_vendor-Dpio9q2e.js"
+    ]
+  },
+  "_vendor-three-DwGkEfCM.js": {
+    "file": "assets/vendor-three-DwGkEfCM.js",
+    "name": "vendor-three"
+  },
+  "index.tsx": {
+    "file": "assets/index-BvNNAF8n.js",
+    "name": "index",
+    "src": "index.tsx",
+    "isEntry": true,
+    "imports": [
+      "_vendor-Dpio9q2e.js",
+      "_vendor-arizeai-DDzwX9A6.js",
+      "_pages-CU_QMYRP.js",
+      "_components-Ddr-5VpM.js",
+      "_vendor-three-DwGkEfCM.js",
+      "_vendor-recharts-DoxlB_Wo.js",
+      "_vendor-codemirror-xRvQKK1G.js"
+    ]
+  }
+}