arize-phoenix 8.23.0__py3-none-any.whl → 8.24.1__py3-none-any.whl

{arize_phoenix-8.23.0.dist-info → arize_phoenix-8.24.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: arize-phoenix
-Version: 8.23.0
+Version: 8.24.1
 Summary: AI Observability and Evaluation
 Project-URL: Documentation, https://docs.arize.com/phoenix/
 Project-URL: Issues, https://github.com/Arize-ai/phoenix/issues

{arize_phoenix-8.23.0.dist-info → arize_phoenix-8.24.1.dist-info}/RECORD

@@ -1,12 +1,12 @@
 phoenix/__init__.py,sha256=X3eUEwd2rG8KKWWYVNNDJoqo08ihfjgHhlP29dcdNJE,5481
 phoenix/auth.py,sha256=VVMHrWN31tln3Zo4z6ofecrV4daiqJjLd8r85mqlxek,10939
-phoenix/config.py,sha256=nHOYg2rjnyn1ZtRlTRf9D0fMndgkXaH0cQ7Y0-wXDAM,36300
+phoenix/config.py,sha256=SNBMUEo6lNn5WXP-x6B85UmADZfGEkhfeHDDfW3Af5Y,38090
 phoenix/datetime_utils.py,sha256=iJzNG6YJ6V7_u8B2iA7P2Z26FyxYbOPtx0dhJ7kNDHA,3398
 phoenix/exceptions.py,sha256=n2L2KKuecrdflB9MsCdAYCiSEvGJptIsfRkXMoJle7A,169
 phoenix/py.typed,sha256=AbpHGcgLb-kRsJGnwFEktk7uzpZOCcBY74-YBdrKVGs,1
 phoenix/services.py,sha256=kpW1WL0kiB8XJsO6XycvZVJ-lBkNoenhQ7atCvBoSe8,5365
 phoenix/settings.py,sha256=x87BX7hWGQQZbrW_vrYqFR_izCGfO9gFc--JXUG4Tdk,754
-phoenix/version.py,sha256=OqhTRaQmesPSFG4mF1UGkRjba6vbZjTINuaPSRGPg64,23
+phoenix/version.py,sha256=Ay9oO96i2YGmx2lcWChBnshhqL44Hxy1NdOIEHzoMOw,23
 phoenix/core/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 phoenix/core/embedding_dimension.py,sha256=zKGbcvwOXgLf-yrJBpQyKtd-LEOPRKHnUToyAU8Owis,87
 phoenix/core/model.py,sha256=qBFraOtmwCCnWJltKNP18DDG0mULXigytlFsa6YOz6k,4837
@@ -18,8 +18,8 @@ phoenix/db/alembic.ini,sha256=GIS6HpHaKaJbbuahZg1Rc1D2_QqyCkV9r58wdARGf6w,3262
 phoenix/db/bulk_inserter.py,sha256=faNjuwLqqsw4ky8sa4D0h9u5TvEDTOjrccUW89L008E,12725
 phoenix/db/engines.py,sha256=gxcP2aNy_JyKHv1MO4d2UM47GTMy1jDcN-FQETZ3iNA,7348
 phoenix/db/enums.py,sha256=tt7iovXLhVTLZ3_LbHNGgcI44SnNjXfkKtLAZG57T54,428
-phoenix/db/facilitator.py,sha256=nteTD8XQSQ7a6aZBOw7ZKiJ72-_1TZXKVF4HS3fHdas,5675
-phoenix/db/helpers.py,sha256=daKbpY2QhTPo9a_T1xNHKI4WzWHkMmmrGIws7Hw-RZ4,4884
+phoenix/db/facilitator.py,sha256=-uzv3Wr4YuUtVff4_0bLTcIFvzWzWOA3IPq8s2RA_bc,6821
+phoenix/db/helpers.py,sha256=rbbHcl-STzcEpcXCYx6jbKzko7r3ggrWHHsXjZ48HsM,5352
 phoenix/db/migrate.py,sha256=oUrXH8yEbcpL4eh09aSCuUiSrhFli0eT5D_j4ZmYChY,2797
 phoenix/db/models.py,sha256=TbHgtT7WWdkQK-OtLsUqp3MwP23HGV1IaSAWTqCf5ac,45707
 phoenix/db/insertion/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -80,13 +80,13 @@ phoenix/pointcloud/pointcloud.py,sha256=SN_1wXZcwKrtSnHGZLDZGx71orqE1WyVF7E-D58d
 phoenix/pointcloud/projectors.py,sha256=TQgwc9cJDjJkin1WZyZzgl3HsYrLLiyWD7Czy4jNW3U,1088
 phoenix/pointcloud/umap_parameters.py,sha256=db_WEPoamuWtopZx7tQfAXPnoE0MS8FkAV0_ThjEx_Q,1735
 phoenix/server/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-phoenix/server/app.py,sha256=zrDEF-ojWyxgNjvTTGstfLr3vWSwjmjnevVtHPpBU4U,39826
+phoenix/server/app.py,sha256=f9H8ekaGiMwCMbSf2kbQIUFKywY2VmaIuJgPlrC7obU,40221
 phoenix/server/bearer_auth.py,sha256=0UudvkAS_dxna5JEJJhGUYwB6Ny-e22ssX5Mm79QwCk,5907
 phoenix/server/dml_event.py,sha256=MjJmVEKytq75chBOSyvYDusUnEbg1pHpIjR3pZkUaJA,2838
 phoenix/server/dml_event_handler.py,sha256=EZLXmCvx4pJrCkz29gxwKwmvmUkTtPCHw6klR-XM8qE,8258
 phoenix/server/grpc_server.py,sha256=SknR-iLIUqU9swiAyLhbCUREA1obOM6w49xgdK1AQDs,3839
 phoenix/server/jwt_store.py,sha256=asxzY4_ZBM2FWAMstHvhvnKUP_0AA3v3xPTL2IOgNqY,16831
-phoenix/server/main.py,sha256=wqK9xDPrveNAacdTEuZO1dCX7l3TWsS9vtZ2wrNl0Mg,16646
+phoenix/server/main.py,sha256=qJcqXudiY65UeOWOaxP1-dqzrV-BBnbZu_IDd-qMKMk,16720
 phoenix/server/oauth2.py,sha256=EV4wcCwG0N7cJRcfGNURdP5rZgRVCeRDvXyle19A27Y,2064
 phoenix/server/prometheus.py,sha256=1KjvSfjSa2-BPjDybVMM_Kag316CsN-Zwt64YNr_snc,7825
 phoenix/server/rate_limiters.py,sha256=cFc73D2NaxqNZZDbwfIDw4So-fRVOJPBtqxOZ8Qky_s,7155
@@ -96,12 +96,12 @@ phoenix/server/types.py,sha256=gJJPBcDRkQ9VHZIt_aLqG_OBbGt1oWp4e3W3Jp61oKs,7409
 phoenix/server/api/README.md,sha256=Pyq1PLPgTzXAswrfIhGXrjI3Skq8it2jTVnanT6Ba4Q,1162
 phoenix/server/api/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 phoenix/server/api/auth.py,sha256=nywpmfMI1trZTbZRD3oBj4kFjzg_vnxDljcM431T1eY,1246
-phoenix/server/api/context.py,sha256=OopBkMnY48TzulTtfuay3MXmhbFIWPtPoAsbhCW-Pl0,6459
+phoenix/server/api/context.py,sha256=gB9bNgdqqD4Bn-6V4zlKeILl6L76jynPtOuM_5UZBNw,6557
 phoenix/server/api/exceptions.py,sha256=TA0JuY2YRnj35qGuMSQ8d0ToHum9gWm9W--3fSKHrX0,1171
 phoenix/server/api/interceptor.py,sha256=ykDnoC_apUd-llVli3m1CW18kNSIgjz2qZ6m5JmPDu8,1294
-phoenix/server/api/queries.py,sha256=Xd1K-6bu_DuUxczyXzf0M6EiRL7Ahnx47QVqPmo2-58,36167
+phoenix/server/api/queries.py,sha256=WNH1LxB7bobfOMdBJts-9_ncfVhv2LThAKu14MRPMpk,35810
 phoenix/server/api/schema.py,sha256=fcs36xQwFF_Qe41_5cWR8wYpDvOrnbcyTeo5WNMbDsA,1702
-phoenix/server/api/subscriptions.py,sha256=DSIgQF6lQqkbc7D0AaI5R4g3hIHbU04H5Y2UIpwmpy0,22989
+phoenix/server/api/subscriptions.py,sha256=TnZhdoNHMXp1NkUVLA-eB54woll7FvxtsB2pLt1dO0w,23001
 phoenix/server/api/utils.py,sha256=quCBRcusc6PUq9tJq7M8PgwFZp7nXgVAxtbw8feribY,833
 phoenix/server/api/dataloaders/__init__.py,sha256=LiOF9d95TPOD3pYuE906trLq-_q1VP8JQ9B6SHicbbM,4360
 phoenix/server/api/dataloaders/annotation_summaries.py,sha256=2sHmIDX7n8tuPeBTs9bMKtlMKWn_Ph9awTZqmwn2Owc,5505
@@ -201,7 +201,7 @@ phoenix/server/api/mutations/prompt_version_tag_mutations.py,sha256=t77osYb5he2A
 phoenix/server/api/mutations/span_annotations_mutations.py,sha256=sumBLUqRKlgMASWdWwYItmIJ2l7AyAp_PlIYeXYfguc,5970
 phoenix/server/api/mutations/trace_annotations_mutations.py,sha256=sEcEt8hbMt8YMiRX5o3xcJ5rWWZbDeBPMNz2teZoi3U,5945
 phoenix/server/api/mutations/trace_mutations.py,sha256=D5h2HYdlTo6yYZNq-O-PjaS9GeiZHxxVaOxDdh7fwjw,2957
-phoenix/server/api/mutations/user_mutations.py,sha256=FgZXQjCqmJ_0dyqiXv6NoGF7TjOO2a0aX7xDMDKtl-A,13603
+phoenix/server/api/mutations/user_mutations.py,sha256=5pgtNKZwOnP1pbuegnNMwPn5u4teeWJ6vZSIcjDSCUg,14055
 phoenix/server/api/openapi/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 phoenix/server/api/openapi/main.py,sha256=yKdzJYI4cxy_1mFcK4_7YObIcuRviBIfwNjB23RG14k,461
 phoenix/server/api/openapi/schema.py,sha256=WGmHWSIyJhtc5EIh_M3vlXU-EgHkFuTlyVofgS0kj1I,529
@@ -217,7 +217,7 @@ phoenix/server/api/routers/v1/experiment_evaluations.py,sha256=vx4CKlE84sAL1vtPi
 phoenix/server/api/routers/v1/experiment_runs.py,sha256=bInuasRv7ogiYf8fq-LwpJ5tptmMQsBNDlJAqwdymko,6378
 phoenix/server/api/routers/v1/experiments.py,sha256=V9_sxqLTE1MKGFu9H3FEdGKr70lYMbGZx813MGaavfQ,20430
 phoenix/server/api/routers/v1/models.py,sha256=r0nM2kFJ3mxDqgc5vFr1cjNuyOPs3RIKE_DS2VMdF48,1749
-phoenix/server/api/routers/v1/projects.py,sha256=OqUSsGlqalnwjZjFEg8f2rEq10IK41S3lIBjlInbJGA,12468
+phoenix/server/api/routers/v1/projects.py,sha256=qv4RffYVGCJQuJ3FzaTVkueY8qKY0-GUbG9eSdm7oRY,14181
 phoenix/server/api/routers/v1/prompts.py,sha256=aBOUBwLDzZDIzJQkxJcR8ZKnakNJOLMwzsLKINSs1mA,26545
 phoenix/server/api/routers/v1/spans.py,sha256=uoU_bwIgz86fuvPjP5sX8goDyuCcnsTig-x3f17p60U,9625
 phoenix/server/api/routers/v1/traces.py,sha256=hSv35QIB4mwFgp53rOpz3zWIiSwbZzQnjafD790QuJU,7908
@@ -300,10 +300,11 @@ phoenix/server/api/types/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZ
 phoenix/server/api/types/node.py,sha256=BLl_IOFr0zrqUxaAtGLGui5aeM5VNVXFTzGeAKrztr0,822
 phoenix/server/api/types/pagination.py,sha256=BXm46gXZfrBS4hpiLvVSEdsbb29ctUMVJYjKXlOLxUA,9064
 phoenix/server/email/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-phoenix/server/email/sender.py,sha256=Df-fZKbK_01KEkjo8UnDiYSuU69YfknyI1neZK_kmwA,3388
-phoenix/server/email/types.py,sha256=URLIMwtQWbbDEKLWjZTw9snCxsfxqRyoXNyByttbVWE,213
+phoenix/server/email/sender.py,sha256=eC6RcLANVJH0mh20mGZ2qr-bU-OWo9po2e5og2tMzJw,4127
+phoenix/server/email/types.py,sha256=IO2bTtCh-1cve-xiM4MWnunCCVNOQ3Z2cqTqF7vH-do,466
 phoenix/server/email/templates/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 phoenix/server/email/templates/password_reset.html,sha256=jv0Pe-06JloPZcubRWxPdAFHYEn9eDj_4SjmuoIwshI,441
+phoenix/server/email/templates/welcome.html,sha256=AyVsIOtpmyYwWmmkXjuEgXwkbsag4YHHKfkmOTiNo-M,316
 phoenix/server/openapi/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 phoenix/server/static/apple-touch-icon-114x114.png,sha256=xtFVXAYQnJkpUApg2D1hltSTuyO4Is4sD4A0ZkikiVU,9486
 phoenix/server/static/apple-touch-icon-120x120.png,sha256=iqZVAk634BbjJMozA8aHYyw15JjhIlIrG41FA2DFFaE,9957
@@ -315,10 +316,10 @@ phoenix/server/static/apple-touch-icon-76x76.png,sha256=CT_xT12I0u2i0WU8JzBZBuOQ
 phoenix/server/static/apple-touch-icon.png,sha256=fOfpjqGpWYbJ0eAurKsyoZP1EAs6ZVooBJ_SGk2ZkDs,3801
 phoenix/server/static/favicon.ico,sha256=bY0vvCKRftemZfPShwZtE93DiiQdaYaozkPGwNFr6H8,34494
 phoenix/server/static/modernizr.js,sha256=mvK-XtkNqjOral-QvzoqsyOMECXIMu5BQwSVN_wcU9c,2564
-phoenix/server/static/.vite/manifest.json,sha256=auJ0xZVwoBgNFZNn01_tvXU6xEq3MqpZojcaf0DOfJI,2165
-phoenix/server/static/assets/components-D8xtf7Q6.js,sha256=WQDwjJguBK1kHf3Ol-jJVsc2iOLOVJQQnzwn4x6N04Y,455620
-phoenix/server/static/assets/index-CGfsCafL.js,sha256=VJZGNtCcMeFtI0WkioE-HKzTzH8kL19MkmlP_Fa9nBg,60397
-phoenix/server/static/assets/pages-BiUq97Df.js,sha256=hBVLxHD0YfqscIRhv3UOvw51-4pNdlqFyrUBTxR5MF0,863007
+phoenix/server/static/.vite/manifest.json,sha256=HoxYrYg2l2nq5chl9GKo0pnga42JFMShSC0Kr4wLX5o,2165
+phoenix/server/static/assets/components-B6cljCxu.js,sha256=VQZ_xj8sB55iva4mG-oFIPElEaArjo0-GF8hWOQ7L8c,455620
+phoenix/server/static/assets/index-DfHKoAV9.js,sha256=OmqicccaM0lPOLABn3D6U-igVTGSREXbM4ZFiKWYGMI,60397
+phoenix/server/static/assets/pages-Dhitcl5V.js,sha256=CdjHOTXth5jc1mqFO-ofYgFTglKUtVlBwiYEK8SBRJE,863027
 phoenix/server/static/assets/vendor-C3H3sezv.js,sha256=Ask2DJPiTV2k5gNIopK_nOQFKCysUP5Z7h1gWVsFB3c,2510162
 phoenix/server/static/assets/vendor-Cg6lcjUC.css,sha256=nZrkr0u6NNElFGvpWHk9GTHeGoibCXCli1bE7mXZGZg,1816
 phoenix/server/static/assets/vendor-arizeai-DT8pwHfH.js,sha256=JraS2i2tsj4ToS_KGjq9BWS5zv4_FohPgF-vPV3MxEE,193248
@@ -365,9 +366,9 @@ phoenix/utilities/project.py,sha256=auVpARXkDb-JgeX5f2aStyFIkeKvGwN9l7qrFeJMVxI,
 phoenix/utilities/re.py,sha256=6YyUWIkv0zc2SigsxfOWIHzdpjKA_TZo2iqKq7zJKvw,2081
 phoenix/utilities/span_store.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 phoenix/utilities/template_formatters.py,sha256=gh9PJD6WEGw7TEYXfSst1UR4pWWwmjxMLrDVQ_CkpkQ,2779
-arize_phoenix-8.23.0.dist-info/METADATA,sha256=aKyIILwAF-pzlVLUCEB4T74-6RF7z_WxDU5Unqb-hEI,24495
-arize_phoenix-8.23.0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-arize_phoenix-8.23.0.dist-info/entry_points.txt,sha256=Pgpn8Upxx9P8z8joPXZWl2LlnAlGc3gcQoVchb06X1Q,94
-arize_phoenix-8.23.0.dist-info/licenses/IP_NOTICE,sha256=JBqyyCYYxGDfzQ0TtsQgjts41IJoa-hiwDrBjCb9gHM,469
-arize_phoenix-8.23.0.dist-info/licenses/LICENSE,sha256=HFkW9REuMOkvKRACuwLPT0hRydHb3zNg-fdFt94td18,3794
-arize_phoenix-8.23.0.dist-info/RECORD,,
+arize_phoenix-8.24.1.dist-info/METADATA,sha256=u080-Lqu15myFGIszydtax26yxvITRhiE_WXHsaQTtY,24495
+arize_phoenix-8.24.1.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+arize_phoenix-8.24.1.dist-info/entry_points.txt,sha256=Pgpn8Upxx9P8z8joPXZWl2LlnAlGc3gcQoVchb06X1Q,94
+arize_phoenix-8.24.1.dist-info/licenses/IP_NOTICE,sha256=JBqyyCYYxGDfzQ0TtsQgjts41IJoa-hiwDrBjCb9gHM,469
+arize_phoenix-8.24.1.dist-info/licenses/LICENSE,sha256=HFkW9REuMOkvKRACuwLPT0hRydHb3zNg-fdFt94td18,3794
+arize_phoenix-8.24.1.dist-info/RECORD,,

phoenix/config.py

@@ -8,10 +8,11 @@ from enum import Enum
 from importlib.metadata import version
 from pathlib import Path
 from typing import Any, Optional, Union, cast, overload
-from urllib.parse import quote_plus, urlparse
+from urllib.parse import quote_plus, urljoin, urlparse
 
 import wrapt
 from email_validator import EmailNotValidError, validate_email
+from starlette.datastructures import URL
 
 from phoenix.utilities.logging import log_a_list
 
@@ -182,6 +183,19 @@ If the username or email address already exists in the database, the user record
 modified, e.g., changed from non-admin to admin. Changing this environment variable for the next
 startup will not undo any records created in previous startups.
 """
+ENV_PHOENIX_ROOT_URL = "PHOENIX_ROOT_URL"
+"""
+This is the full URL used to access Phoenix from a web browser. This setting is important when
+you have a reverse proxy in front of Phoenix. If the reverse proxy exposes Phoenix through a
+sub-path, add that sub-path to the end of this URL setting.
+
+WARNING: When a sub-path is needed, you must also specify the sub-path via the environment
+variable PHOENIX_HOST_ROOT_PATH. Setting just this URL setting is not enough.
+
+Examples:
+    - With a sub-path: "https://example.com/phoenix"
+    - Without a sub-path: "https://phoenix.example.com"
+"""
 
 
 # SMTP settings
@@ -828,7 +842,7 @@ def get_env_host() -> str:
 
 
 def get_env_host_root_path() -> str:
-    if (host_root_path := getenv(ENV_PHOENIX_HOST_ROOT_PATH)) is None:
+    if not (host_root_path := getenv(ENV_PHOENIX_HOST_ROOT_PATH)):
         return HOST_ROOT_PATH
     if not host_root_path.startswith("/"):
         raise ValueError(
@@ -894,7 +908,33 @@ def get_env_client_headers() -> dict[str, str]:
     return headers
 
 
+def get_env_root_url() -> URL:
+    """
+    Get the URL used to access Phoenix from a web browser
+
+    Returns:
+        URL: The root URL of the Phoenix server
+
+    Note:
+        This is intended to replace the legacy `get_base_url()` helper function. In
+        particular, `get_env_collector_endpoint()` is really for the client and should be
+        deprecated on the server side.
+    """
+    if root_url := getenv(ENV_PHOENIX_ROOT_URL):
+        result = urlparse(root_url)
+        if not result.scheme or not result.netloc:
+            raise ValueError(
+                f"The environment variable `{ENV_PHOENIX_ROOT_URL}` must be a valid URL."
+            )
+        return URL(root_url)
+    host = get_env_host()
+    if host == "0.0.0.0":
+        host = "127.0.0.1"
+    return URL(urljoin(f"http://{host}:{get_env_port()}", get_env_host_root_path()))
+
+
 def get_base_url() -> str:
+    """Deprecated: Use get_env_root_url() instead, but note the difference in behavior."""
     host = get_env_host()
     if host == "0.0.0.0":
         host = "127.0.0.1"
@@ -1065,4 +1105,10 @@ def get_env_allowed_origins() -> Optional[list[str]]:
     return allowed_origins.split(",")
 
 
+def verify_server_environment_variables() -> None:
+    """Verify that the environment variables are set correctly. Raises an error otherwise."""
+    get_env_root_url()
+
+
 SKLEARN_VERSION = cast(tuple[int, int], tuple(map(int, version("scikit-learn").split(".", 2)[:2])))
+PLAYGROUND_PROJECT_NAME = "playground"

phoenix/db/facilitator.py

@@ -1,15 +1,17 @@
 from __future__ import annotations
 
 import asyncio
+import logging
 import secrets
+from asyncio import gather
 from functools import partial
+from typing import Optional
 
 from sqlalchemy import (
     distinct,
     insert,
     select,
 )
-from sqlalchemy.ext.asyncio import AsyncSession
 
 from phoenix.auth import (
     DEFAULT_ADMIN_EMAIL,
@@ -25,8 +27,11 @@ from phoenix.config import (
 )
 from phoenix.db import models
 from phoenix.db.enums import COLUMN_ENUMS, UserRole
+from phoenix.server.email.types import WelcomeEmailSender
 from phoenix.server.types import DbSessionFactory
 
+logger = logging.getLogger(__name__)
+
 
 class Facilitator:
     """
@@ -36,20 +41,25 @@ class Facilitator:
     carried out as callbacks at the very beginning of Starlette's lifespan process.
     """
 
-    def __init__(self, *, db: DbSessionFactory) -> None:
+    def __init__(
+        self,
+        *,
+        db: DbSessionFactory,
+        email_sender: Optional[WelcomeEmailSender] = None,
+    ) -> None:
         self._db = db
+        self._email_sender = email_sender
 
     async def __call__(self) -> None:
         for fn in (
             _ensure_enums,
             _ensure_user_roles,
-            _ensure_admins,
+            partial(_ensure_admins, email_sender=self._email_sender),
         ):
-            async with self._db() as session:
-                await fn(session)
+            await fn(self._db)
 
 
-async def _ensure_enums(session: AsyncSession) -> None:
+async def _ensure_enums(db: DbSessionFactory) -> None:
     """
     Ensure that all enum values are present in their respective tables. If any values are missing,
     they will be added. If any values are present in the database but not in the enum, an error will
@@ -57,99 +67,122 @@ async def _ensure_enums(session: AsyncSession) -> None:
     """
     for column, enum in COLUMN_ENUMS.items():
         table = column.class_
-        existing = set([_ async for _ in await session.stream_scalars(select(distinct(column)))])
-        expected = set(e.value for e in enum)
-        if unexpected := existing - expected:
-            raise ValueError(f"Unexpected values in {table.name}.{column.key}: {unexpected}")
-        if not (missing := expected - existing):
-            continue
-        await session.execute(insert(table), [{column.key: v} for v in missing])
+        async with db() as session:
+            existing = set(
+                [_ async for _ in await session.stream_scalars(select(distinct(column)))]
+            )
+            expected = set(e.value for e in enum)
+            if unexpected := existing - expected:
+                raise ValueError(f"Unexpected values in {table.name}.{column.key}: {unexpected}")
+            if not (missing := expected - existing):
+                continue
+            await session.execute(insert(table), [{column.key: v} for v in missing])
 
 
-async def _ensure_user_roles(session: AsyncSession) -> None:
+async def _ensure_user_roles(db: DbSessionFactory) -> None:
     """
     Ensure that the system and admin roles are present in the database. If they are not, they will
     be added. The system user will have the email "system@localhost" and the admin user will have
     the email "admin@localhost".
     """
-    role_ids = {
-        name: id_
-        async for name, id_ in await session.stream(
-            select(models.UserRole.name, models.UserRole.id)
-        )
-    }
-    existing_roles = [
-        name
-        async for name in await session.stream_scalars(
-            select(distinct(models.UserRole.name)).join_from(models.User, models.UserRole)
-        )
-    ]
-    if (system_role := UserRole.SYSTEM.value) not in existing_roles and (
-        system_role_id := role_ids.get(system_role)
-    ) is not None:
-        system_user = models.User(
-            user_role_id=system_role_id,
-            username=DEFAULT_SYSTEM_USERNAME,
-            email=DEFAULT_SYSTEM_EMAIL,
-            reset_password=False,
-            password_salt=secrets.token_bytes(DEFAULT_SECRET_LENGTH),
-            password_hash=secrets.token_bytes(DEFAULT_SECRET_LENGTH),
-        )
-        session.add(system_user)
-    if (admin_role := UserRole.ADMIN.value) not in existing_roles and (
-        admin_role_id := role_ids.get(admin_role)
-    ) is not None:
-        salt = secrets.token_bytes(DEFAULT_SECRET_LENGTH)
-        password = get_env_default_admin_initial_password()
-        compute = partial(compute_password_hash, password=password, salt=salt)
-        loop = asyncio.get_running_loop()
-        hash_ = await loop.run_in_executor(None, compute)
-        admin_user = models.User(
-            user_role_id=admin_role_id,
-            username=DEFAULT_ADMIN_USERNAME,
-            email=DEFAULT_ADMIN_EMAIL,
-            password_salt=salt,
-            password_hash=hash_,
-            reset_password=True,
-        )
-        session.add(admin_user)
-    await session.flush()
+    async with db() as session:
+        role_ids = {
+            name: id_
+            async for name, id_ in await session.stream(
+                select(models.UserRole.name, models.UserRole.id)
+            )
+        }
+        existing_roles = [
+            name
+            async for name in await session.stream_scalars(
+                select(distinct(models.UserRole.name)).join_from(models.User, models.UserRole)
+            )
+        ]
+        if (system_role := UserRole.SYSTEM.value) not in existing_roles and (
+            system_role_id := role_ids.get(system_role)
+        ) is not None:
+            system_user = models.User(
+                user_role_id=system_role_id,
+                username=DEFAULT_SYSTEM_USERNAME,
+                email=DEFAULT_SYSTEM_EMAIL,
+                reset_password=False,
+                password_salt=secrets.token_bytes(DEFAULT_SECRET_LENGTH),
+                password_hash=secrets.token_bytes(DEFAULT_SECRET_LENGTH),
+            )
+            session.add(system_user)
+        if (admin_role := UserRole.ADMIN.value) not in existing_roles and (
+            admin_role_id := role_ids.get(admin_role)
+        ) is not None:
+            salt = secrets.token_bytes(DEFAULT_SECRET_LENGTH)
+            password = get_env_default_admin_initial_password()
+            compute = partial(compute_password_hash, password=password, salt=salt)
+            loop = asyncio.get_running_loop()
+            hash_ = await loop.run_in_executor(None, compute)
+            admin_user = models.User(
+                user_role_id=admin_role_id,
+                username=DEFAULT_ADMIN_USERNAME,
+                email=DEFAULT_ADMIN_EMAIL,
+                password_salt=salt,
+                password_hash=hash_,
+                reset_password=True,
+            )
+            session.add(admin_user)
+        await session.flush()
 
 
-async def _ensure_admins(session: AsyncSession) -> None:
+async def _ensure_admins(
+    db: DbSessionFactory,
+    *,
+    email_sender: Optional[WelcomeEmailSender] = None,
+) -> None:
     """
     Ensure that all startup admin users are present in the database. If any are missing, they will
     be added. Existing records will not be modified.
     """
     if not (admins := get_env_admins()):
         return
-    existing_emails = set(
-        await session.scalars(select(models.User.email).where(models.User.email.in_(admins.keys())))
-    )
-    admins = {email: username for email, username in admins.items() if email not in existing_emails}
-    if not admins:
-        return
-    existing_usernames = set(
-        await session.scalars(
-            select(models.User.username).where(models.User.username.in_(admins.values()))
+    async with db() as session:
+        existing_emails = set(
+            await session.scalars(
+                select(models.User.email).where(models.User.email.in_(admins.keys()))
+            )
         )
-    )
-    admins = {
-        email: username for email, username in admins.items() if username not in existing_usernames
-    }
-    if not admins:
-        return
-    admin_role_id = await session.scalar(
-        select(models.UserRole.id).filter_by(name=UserRole.ADMIN.value)
-    )
-    assert admin_role_id is not None, "Admin role not found in database"
-    for email, username in admins.items():
-        values = dict(
-            user_role_id=admin_role_id,
-            username=username,
-            email=email,
-            password_salt=secrets.token_bytes(DEFAULT_SECRET_LENGTH),
-            password_hash=secrets.token_bytes(DEFAULT_SECRET_LENGTH),
-            reset_password=True,
+        admins = {
+            email: username for email, username in admins.items() if email not in existing_emails
+        }
+        if not admins:
+            return
+        existing_usernames = set(
+            await session.scalars(
+                select(models.User.username).where(models.User.username.in_(admins.values()))
+            )
         )
-        await session.execute(insert(models.User).values(values))
+        admins = {
+            email: username
+            for email, username in admins.items()
+            if username not in existing_usernames
+        }
+        if not admins:
+            return
+        admin_role_id = await session.scalar(
+            select(models.UserRole.id).filter_by(name=UserRole.ADMIN.value)
+        )
+        assert admin_role_id is not None, "Admin role not found in database"
+        for email, username in admins.items():
+            values = dict(
+                user_role_id=admin_role_id,
+                username=username,
+                email=email,
+                password_salt=secrets.token_bytes(DEFAULT_SECRET_LENGTH),
+                password_hash=secrets.token_bytes(DEFAULT_SECRET_LENGTH),
+                reset_password=True,
+            )
+            await session.execute(insert(models.User).values(values))
+    if email_sender is None:
+        return
+    for exc in await gather(
+        *(email_sender.send_welcome_email(email, username) for email, username in admins.items()),
+        return_exceptions=True,
+    ):
+        if isinstance(exc, Exception):
+            logger.error(f"Failed to send welcome email: {exc}")

phoenix/db/helpers.py

@@ -19,6 +19,7 @@ from sqlalchemy import (
 )
 from typing_extensions import assert_never
 
+from phoenix.config import PLAYGROUND_PROJECT_NAME
 from phoenix.db import models
 
 
@@ -157,3 +158,18 @@ def get_dataset_example_revisions(
             ),
         )
     )
+
+
+_AnyTuple = TypeVar("_AnyTuple", bound=tuple[Any, ...])
+
+
+def exclude_experiment_projects(
+    stmt: Select[_AnyTuple],
+) -> Select[_AnyTuple]:
+    return stmt.outerjoin(
+        models.Experiment,
+        and_(
+            models.Project.name == models.Experiment.project_name,
+            models.Experiment.project_name != PLAYGROUND_PROJECT_NAME,
+        ),
+    ).where(models.Experiment.project_name.is_(None))

phoenix/server/api/context.py

@@ -53,6 +53,7 @@ from phoenix.server.api.dataloaders import (
 )
 from phoenix.server.bearer_auth import PhoenixUser
 from phoenix.server.dml_event import DmlEvent
+from phoenix.server.email.types import EmailSender
 from phoenix.server.types import (
     CanGetLastUpdatedAt,
     CanPutItem,
@@ -124,6 +125,7 @@ class Context(BaseContext):
     auth_enabled: bool = False
     secret: Optional[str] = None
     token_store: Optional[TokenStore] = None
+    email_sender: Optional[EmailSender] = None
 
     def get_secret(self) -> str:
         """A type-safe way to get the application secret. Throws an error if the secret is not set.

phoenix/server/api/mutations/user_mutations.py

@@ -1,3 +1,4 @@
+import logging
 import secrets
 from contextlib import AsyncExitStack
 from datetime import datetime, timezone
@@ -32,6 +33,8 @@ from phoenix.server.api.types.User import User, to_gql_user
 from phoenix.server.bearer_auth import PhoenixUser
 from phoenix.server.types import AccessTokenId, ApiKeyId, PasswordResetTokenId, RefreshTokenId
 
+logger = logging.getLogger(__name__)
+
 
 @strawberry.input
 class CreateUserInput:
@@ -39,6 +42,7 @@ class CreateUserInput:
     username: str
     password: str
     role: UserRoleInput
+    send_welcome_email: Optional[bool] = False
 
 
 @strawberry.input
@@ -111,6 +115,12 @@ class UserMutationMixin:
                 await session.flush()
             except (PostgreSQLIntegrityError, SQLiteIntegrityError) as error:
                 raise Conflict(_user_operation_error_message(error))
+        if input.send_welcome_email and info.context.email_sender is not None:
+            try:
+                await info.context.email_sender.send_welcome_email(user.email, user.username)
+            except Exception as error:
+                # Log the error but do not raise it
+                logger.error(f"Failed to send welcome email: {error}")
         return UserMutationPayload(user=to_gql_user(user))
 
     @strawberry.mutation(permission_classes=[IsNotReadOnly, IsAdmin, IsLocked])  # type: ignore

phoenix/server/api/queries.py

@@ -19,7 +19,7 @@ from phoenix.config import (
     getenv,
 )
 from phoenix.db import enums, models
-from phoenix.db.helpers import SupportedSQLDialect
+from phoenix.db.helpers import SupportedSQLDialect, exclude_experiment_projects
 from phoenix.db.models import DatasetExample as OrmExample
 from phoenix.db.models import DatasetExampleRevision as OrmRevision
 from phoenix.db.models import DatasetVersion as OrmVersion
@@ -42,7 +42,6 @@ from phoenix.server.api.input_types.ClusterInput import ClusterInput
 from phoenix.server.api.input_types.Coordinates import InputCoordinate2D, InputCoordinate3D
 from phoenix.server.api.input_types.DatasetSort import DatasetSort
 from phoenix.server.api.input_types.InvocationParameters import InvocationParameter
-from phoenix.server.api.subscriptions import PLAYGROUND_PROJECT_NAME
 from phoenix.server.api.types.Cluster import Cluster, to_gql_clusters
 from phoenix.server.api.types.Dataset import Dataset, to_gql_dataset
 from phoenix.server.api.types.DatasetExample import DatasetExample
@@ -233,18 +232,8 @@ class Query:
             last=last,
             before=before if isinstance(before, CursorString) else None,
         )
-        stmt = (
-            select(models.Project)
-            .outerjoin(
-                models.Experiment,
-                and_(
-                    models.Project.name == models.Experiment.project_name,
-                    models.Experiment.project_name != PLAYGROUND_PROJECT_NAME,
-                ),
-            )
-            .where(models.Experiment.project_name.is_(None))
-            .order_by(models.Project.id)
-        )
+        stmt = select(models.Project).order_by(models.Project.id)
+        stmt = exclude_experiment_projects(stmt)
         async with info.context.db() as session:
             projects = await session.stream_scalars(stmt)
             data = [