use uv instead of poetry (#663)

Author: adilhafeez

.github/workflows/e2e_archgw.yml .github/workflows/e2e_plano_tests.yml.github/workflows/e2e_archgw.yml renamed to .github/workflows/e2e_plano_tests.yml

@@ -48,19 +48,16 @@ jobs:
         run: |
           source common.sh && wait_for_healthz http://localhost:10000/healthz
 
-      - name: install poetry
-        run: |
-          export POETRY_VERSION=2.2.1
-          curl -sSL https://install.python-poetry.org | python3 -
-          export PATH="$HOME/.local/bin:$PATH"
+      - name: install uv
+        run: curl -LsSf https://astral.sh/uv/install.sh | sh
 
       - name: install test dependencies
         run: |
-          poetry install
+          uv sync
 
       - name: run plano tests
         run: |
-          poetry run pytest || tail -100 plano.logs
+          uv run pytest || tail -100 plano.logs
 
       - name: stop plano docker container
         env:

.github/workflows/e2e_test_currency_convert.yml

@@ -26,10 +26,8 @@ jobs:
         run: |
           docker build  -f Dockerfile . -t katanemo/plano -t katanemo/plano:0.4.0
 
-      - name: install poetry
-        run: |
-          export POETRY_VERSION=2.2.1
-          curl -sSL https://install.python-poetry.org | python3 -
+      - name: install uv
+        run: curl -LsSf https://astral.sh/uv/install.sh | sh
 
       - name: setup python venv
         run: |
@@ -43,8 +41,8 @@ jobs:
       - name: install arch gateway and test dependencies
         run: |
           source venv/bin/activate
-          cd cli && echo "installing plano cli" && poetry install
-          cd ../demos/shared/test_runner && echo "installing test dependencies" && poetry install
+          cd cli && echo "installing plano cli" && uv sync && uv tool install .
+          cd ../demos/shared/test_runner && echo "installing test dependencies" && uv sync
 
       - name: run demo tests
         env:

.github/workflows/e2e_test_preference_based_routing.yml

@@ -26,10 +26,8 @@ jobs:
         run: |
           docker build  -f Dockerfile . -t katanemo/plano -t katanemo/plano:0.4.0
 
-      - name: install poetry
-        run: |
-          export POETRY_VERSION=2.2.1
-          curl -sSL https://install.python-poetry.org | python3 -
+      - name: install uv
+        run: curl -LsSf https://astral.sh/uv/install.sh | sh
 
       - name: setup python venv
         run: |
@@ -43,8 +41,8 @@ jobs:
       - name: install arch gateway and test dependencies
         run: |
           source venv/bin/activate
-          cd cli && echo "installing plano cli" && poetry install
-          cd ../demos/shared/test_runner && echo "installing test dependencies" && poetry install
+          cd cli && echo "installing plano cli" && uv sync && uv tool install .
+          cd ../demos/shared/test_runner && echo "installing test dependencies" && uv sync
 
       - name: run demo tests
         env:

.github/workflows/e2e_tests.yml

@@ -45,11 +45,8 @@ jobs:
         with:
           python-version: "3.12"
 
-      - name: Install Poetry
-        run: |
-          export POETRY_VERSION=2.2.1
-          curl -sSL https://install.python-poetry.org | python3 -
-          export PATH="$HOME/.local/bin:$PATH"
+      - name: Install uv
+        run: curl -LsSf https://astral.sh/uv/install.sh | sh
 
       - name: Run e2e tests
         env:

.github/workflows/plano_tools_tests.yml

@@ -25,16 +25,13 @@ jobs:
         with:
           python-version: "3.12"
 
-      - name: install poetry
-        run: |
-          export POETRY_VERSION=2.2.1
-          curl -sSL https://install.python-poetry.org | python3 -
-          export PATH="$HOME/.local/bin:$PATH"
+      - name: install uv
+        run: curl -LsSf https://astral.sh/uv/install.sh | sh
 
       - name: install plano tools
         run: |
-          poetry install
+          uv sync --extra dev
 
       - name: run tests
         run: |
-          poetry run pytest
+          uv run pytest

.github/workflows/publish-pypi.yml

@@ -24,14 +24,12 @@ jobs:
         with:
           python-version: "3.12"
 
-      - name: install poetry
-        run: |
-          export POETRY_VERSION=2.2.1
-          curl -sSL https://install.python-poetry.org | python3 -
-          export PATH="$HOME/.local/bin:$PATH"
+      - name: install uv
+        run: curl -LsSf https://astral.sh/uv/install.sh | sh
 
       - name: Build and publish to PyPI
         env:
-          POETRY_PYPI_TOKEN_PYPI: ${{ secrets.PYPI_API_TOKEN }}
+          UV_PUBLISH_TOKEN: ${{ secrets.PYPI_API_TOKEN }}
         run: |
-          poetry publish --build
+          uv build
+          uv publish

.gitignore

@@ -145,3 +145,5 @@ apps/*/out/
 apps/*/dist/
 ./node_modules
 .vercel
+
+*.logs

Dockerfile

@@ -30,14 +30,22 @@ COPY --from=builder /arch/target/release/brightstaff /app/brightstaff
 COPY --from=envoy /usr/local/bin/envoy /usr/local/bin/envoy
 
 WORKDIR /app
-COPY config/requirements.txt .
-RUN pip install -r requirements.txt
+
+# Install uv using pip
+RUN pip install --no-cache-dir uv
+
+# Copy Python dependency files
+COPY cli/pyproject.toml ./
+COPY cli/uv.lock ./
+COPY cli/README.md ./
+
+RUN uv run pip install --no-cache-dir .
+
+# Copy the rest of the application
 COPY cli .
 COPY config/envoy.template.yaml .
 COPY config/arch_config_schema.yaml .
 COPY config/supervisord.conf /etc/supervisor/conf.d/supervisord.conf
-
-RUN pip install requests
 RUN mkdir -p /var/log/supervisor && touch /var/log/envoy.log /var/log/supervisor/supervisord.log
 
 RUN mkdir -p /var/log && \

README.md

@@ -58,7 +58,19 @@ Before you begin, ensure you have the following:
 Plano's CLI allows you to manage and interact with the Plano gateway efficiently. To install the CLI, simply run the following command:
 
 > [!TIP]
-> We recommend that developers create a new Python virtual environment to isolate dependencies before installing Plano. This ensures that plano and its dependencies do not interfere with other packages on your system.
+> We recommend using **uv** for fast, reliable Python package management. Install uv if you haven't already:
+>
+> ```console
+> $ curl -LsSf https://astral.sh/uv/install.sh | sh
+> ```
+
+**Option 1: Install planoai with uv (Recommended)**
+
+```console
+$ uv tool install planoai==0.4.0
+```
+
+**Option 2: Install with pip (Traditional)**
 
 ```console
 $ python3.12 -m venv venv
@@ -161,6 +173,8 @@ Run your `flight_agent` and `hotel_agent` services (see the [Orchestration guide
 
 ```console
 $ planoai up plano_config.yaml
+# Or if installed with uv tool:
+$ uvx planoai up plano_config.yaml
 ```
 
 Plano will start the orchestrator and expose an agent listener on port `8001`.

cli/README.md

@@ -31,36 +31,44 @@ pip uninstall planoai
 
 This guide will walk you through the steps to set up the plano cli on your local machine when you want to develop the plano CLI
 
-### Step 1: Create a Python virtual environment
+### Step 1: Install uv
 
-In the tools directory, create a Python virtual environment by running:
+Install uv if you haven't already:
 
 ```bash
-python -m venv venv
+curl -LsSf https://astral.sh/uv/install.sh | sh
 ```
 
-### Step 2: Activate the virtual environment
-* On Linux/MacOS:
+### Step 2: Create a Python virtual environment and install dependencies
+
+In the cli directory, run:
 
 ```bash
-source venv/bin/activate
+uv sync
 ```
 
-### Step 3: Run the build script
+This will create a virtual environment and install all dependencies.
+
+### Step 3: Activate the virtual environment (optional)
+
+uv will automatically use the virtual environment, but if you need to activate it manually:
+
+* On Linux/MacOS:
+
 ```bash
-poetry install
+source .venv/bin/activate
 ```
 
 ### Step 4: build Arch
 ```bash
-planoai build
+uv run planoai build
 ```
 
 ### Logs
 `plano` command can also view logs from the gateway. Use following command to view logs,
 
 ```bash
-planoai logs --follow
+uv run planoai logs --follow
 ```
 
 ## Uninstall Instructions: plano CLI