Merge branch 'BerriAI:main' into main

Author: towry

.circleci/config.yml

@@ -3339,7 +3339,7 @@ jobs:
             python -m build
             twine upload --verbose dist/*
 
-  e2e_ui_testing:
+  ui_build:
     machine:
       image: ubuntu-2204:2023.10.1
     resource_class: xlarge
@@ -3366,6 +3366,48 @@ jobs:
 
             # Now source the build script
             source ./build_ui.sh
+      - persist_to_workspace:
+          root: .
+          paths:
+            - litellm/proxy/_experimental/out
+
+  ui_unit_tests:
+    machine:
+      image: ubuntu-2204:2023.10.1
+    resource_class: xlarge
+    working_directory: ~/project
+    steps:
+      - checkout
+      - setup_google_dns
+      - run:
+          name: Run UI unit tests (Vitest)
+          command: |
+            # Use Node 20 (several deps require >=20)
+            export NVM_DIR="/opt/circleci/.nvm"
+            source "$NVM_DIR/nvm.sh"
+            nvm install 20
+            nvm use 20
+
+            cd ui/litellm-dashboard
+            npm ci || npm install
+
+            # CI run, with both LCOV (Codecov) and HTML (artifact you can click)
+            CI=true npm run test -- --run --coverage \
+              --coverage.provider=v8 \
+              --coverage.reporter=lcov \
+              --coverage.reporter=html \
+              --coverage.reportsDirectory=coverage/html
+
+  e2e_ui_testing:
+    machine:
+      image: ubuntu-2204:2023.10.1
+    resource_class: xlarge
+    working_directory: ~/project
+    steps:
+      - checkout
+      - setup_google_dns
+      - attach_workspace:
+          at: ~/project
       - run:
           name: Upgrade Docker to v24.x (API 1.44+)
           command: |
@@ -3411,24 +3453,6 @@ jobs:
           name: Install Playwright Browsers
           command: |
             npx playwright install
-      - run:
-          name: Run UI unit tests (Vitest)
-          command: |
-            # Use Node 20 (several deps require >=20)
-            export NVM_DIR="/opt/circleci/.nvm"
-            source "$NVM_DIR/nvm.sh"
-            nvm install 20
-            nvm use 20
-
-            cd ui/litellm-dashboard
-            npm ci || npm install
-
-            # CI run, with both LCOV (Codecov) and HTML (artifact you can click)
-            CI=true npm run test -- --run --coverage \
-              --coverage.provider=v8 \
-              --coverage.reporter=lcov \
-              --coverage.reporter=html \
-              --coverage.reportsDirectory=coverage/html
 
       - run:
           name: Build Docker image
@@ -3633,13 +3657,29 @@ workflows:
               only:
                 - main
                 - /litellm_.*/
+      - ui_build:
+          filters:
+            branches:
+              only:
+                - main
+                - /litellm_.*/
+      - ui_unit_tests:
+          requires:
+            - ui_build
+          filters:
+            branches:
+              only:
+                - main
+                - /litellm_.*/
       - auth_ui_unit_tests:
           filters:
             branches:
               only:
                 - main
                 - /litellm_.*/
       - e2e_ui_testing:
+          requires:
+            - ui_build
           filters:
             branches:
               only:

AGENTS.md

@@ -94,6 +94,10 @@ LiteLLM supports MCP for agent workflows:
 - Support for external MCP servers (Zapier, Jira, Linear, etc.)
 - See `litellm/experimental_mcp_client/` and `litellm/proxy/_experimental/mcp_server/`
 
+## RUNNING SCRIPTS
+
+Use `poetry run python script.py` to run Python scripts in the project environment (for non-test files).
+
 ## TESTING CONSIDERATIONS
 
 1. **Provider Tests**: Test against real provider APIs when possible

CLAUDE.md

@@ -25,6 +25,9 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co
 - `poetry run pytest tests/path/to/test_file.py -v` - Run specific test file
 - `poetry run pytest tests/path/to/test_file.py::test_function -v` - Run specific test
 
+### Running Scripts
+- `poetry run python script.py` - Run Python scripts (use for non-test files)
+
 ## Architecture Overview
 
 LiteLLM is a unified interface for 100+ LLM providers with two main components: