feat: migrate to uv #53

Tomas2D · 2025-09-11T15:59:13Z

Ref: #52

Ref: #52 Signed-off-by: Tomas Dvorak <[email protected]>

gemini-code-assist

Summary of Changes

Hello @Tomas2D, I'm Gemini Code Assist¹! I'm currently reviewing this pull request and will post my feedback shortly. In the meantime, here's a summary to help you and other reviewers quickly get up to speed!

This pull request transitions the project's Python dependency management and build processes from Poetry to uv. This change is intended to enhance the efficiency of dependency installation and project execution by leveraging uv's speed, with corresponding updates to documentation and configuration files to reflect the new tooling.

Highlights

Package Manager Migration: The project has migrated its Python package management from Poetry to uv, a fast Python package installer and resolver, aiming for improved performance and streamlined workflows.
Build System Update: The pyproject.toml configuration has been updated to use hatchling as the build backend, aligning with uv's ecosystem and standard Python packaging practices.
Documentation Alignment: Both README.md and DEVELOP.md have been revised to reflect the new uv-based commands and setup instructions, ensuring consistency and ease of use for developers.
Python Version Specification: A new .python-version file has been added to explicitly declare Python 3.11 as the required version for the project.

Using Gemini Code Assist

The full guide for Gemini Code Assist can be found on our documentation page, here are some quick tips.

Invoking Gemini

You can request assistance from Gemini at any point in your pull request via creating an issue comment (i.e. comment on the pull request page) using either /gemini <command> or @gemini-code-assist <command>. Below is a summary of the supported commands.

Feature	Command	Description
Code Review	`/gemini review`	Performs a code review for the current pull request in its current state.
Pull Request Summary	`/gemini summary`	Provides a summary of the current pull request in its current state.
Comment	@gemini-code-assist	Responds in comments when explicitly tagged, both in issue comments and review comments.
Help	`/gemini help`	Displays a list of available commands.

Customization

To customize Gemini Code Assist for GitHub experience, repository maintainers can create a configuration file and/or provide a custom code review style guide (such as PEP-8 for Python) by creating and adding files to a .gemini/ folder in the base of the repository. Detailed instructions can be found here.

Limitations & Feedback

Gemini Code Assist may make mistakes. Please leave feedback on any instances where its feedback is incorrect or counter productive. You can react with 👍 and 👎 on @gemini-code-assist comments. If you're interested in giving your feedback about your experience with Gemini Code Assist for Github and other Google products, sign up here.

You can also get AI-powered code generation, chat, as well as code reviews directly in the IDE at no cost with the Gemini Code Assist IDE Extension.

Review the Privacy Notices, Generative AI Prohibited Use Policy, Terms of Service, and learn how to configure Gemini Code Assist in GitHub here. Gemini can make mistakes, so double check it and use code with caution. ↩

Signed-off-by: Tomas Dvorak <[email protected]> # Conflicts: # poetry.lock # pyproject.toml

gemini-code-assist

Code Review

This pull request migrates the project's dependency management and build system from Poetry to uv and hatch. The changes primarily involve updating pyproject.toml to the standard format, replacing poetry commands with uv commands in the documentation (README.md, DEVELOP.md), and adding a .python-version file. My review focuses on the documentation changes to ensure clarity and reproducibility. I've suggested pinning the Docker image version in README.md for better reproducibility and pointed out a potentially unintentional removal of the (Optional) keyword in an instruction.

README.md

Ref: #52 Signed-off-by: Tomas Dvorak <[email protected]>

.github/workflows/main.yml

+    timeout-minutes: 10
    name: Lint & Build & Test
    runs-on: ubuntu-latest
+
    steps:
      - uses: actions/checkout@v4
        with:
          fetch-depth: 0
-      - name: Install poetry
-        run: pipx install poetry
-      - uses: actions/setup-python@v5
-        with:
-          python-version: "3.11"
-          cache: "poetry"
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v6
+
+      - name: Set up Python
+        run: uv python install
+
      - name: Install dependencies
-        run: poetry install --no-interaction
+        run: uv sync --all-extras --locked --dev
+
      - name: Code Lint
-        run: poetry run poe lint
+        run: uv run poe lint
+
      - name: Type check task with mypy
-        run: poetry run poe type-check -- -- --show-error-context --pretty
+        run: uv run poe type-check -- --show-error-context --pretty
+
      - name: Code Format
-        run: poetry run poe format
+        run: uv run poe format
+
      - name: Build
-        run: poetry build
+        run: uv build


The best practice for GitHub Actions workflows is to explicitly specify the permissions key at either the workflow (root) level or at the job level. For this workflow, adding permissions: { contents: read } at the top level will ensure that all jobs default to the minimal required permissions, adhering to the principle of least privilege.

To fix the issue, add the following block on a new line after the workflow name declaration (after line 1 and before on: at line 3):

permissions: contents: read

No changes are required elsewhere, as the workflow otherwise appears standard.

JanPokorny · 2025-09-11T16:05:21Z

.github/workflows/main.yml

+        uses: astral-sh/setup-uv@v6
+
+      - name: Set up Python
+        run: uv python install


This should not be necessary AFAIK, uv sync downloads the correct Python when creating venv

JanPokorny · 2025-09-11T16:08:40Z

DEVELOP.md

@@ -35,9 +35,9 @@ With the githooks installed the following will run automatically on a commit:
 * [mypy](https://github.com/python/mypy) is used to check for type errors
 * a simple format check is applied to the commit message to verify for use of [conventional commits](https://www.conventionalcommits.org/en/v1.0.0/#summary)

-Additional tools are integrated into poetry via the [poetry plugin](https://poethepoet.natn.io/poetry_plugin.html)
+Additional tools are provided via [Poe the Poet](https://github.com/nat-n/poethepoet) tasks and can be run with uv.


It's also possible to ditch Poe and use project scripts:

https://github.com/i-am-bee/beeai-platform/blob/a5911f59be15fc9685144ac791575aaebc0687b7/apps/beeai-cli/pyproject.toml#L39-L41

...just mind the caveat that if the project is a library, these scripts get installed alongside it. So it's only usable for apps.

(Or we could unify and use Mise, but I'm probably overthinking this.)

JanPokorny · 2025-09-11T16:09:32Z

DEVELOP.md


-Tools can also be run directly via the command line (run within `poetry shell` or prefix with `poetry run`):
+Tools can be run directly via the command line (activate the venv or prefix commands with `uv run`):

 * `poe lint` - lints and formats your code


I think you should write these as prefixed (uv run poe lint etc.) so people skimming this could just copy the command

JanPokorny · 2025-09-11T16:11:42Z

pyproject.toml

-requires = ["poetry-core>=2.0.0,<3.0.0"]
-build-backend = "poetry.core.masonry.api"
+requires = ["hatchling>=1.18"]
+build-backend = "hatchling.build"


You can use the uv native build backend (example: https://github.com/i-am-bee/beeai-platform/blob/a5911f59be15fc9685144ac791575aaebc0687b7/apps/beeai-cli/pyproject.toml#L43-L49)

JanPokorny · 2025-09-11T16:12:10Z

README.md

@@ -24,13 +24,13 @@ This starter template helps you **quickly** get started with the [BeeAI framewor
 ## 📋 Requirements

 - **Python Version 3.11+**


Technically you don't need this anymore, uv will download correct Python if not present when creating the venv

JanPokorny · 2025-09-11T16:13:56Z

README.md


 You have two options:

 **Option 1:** Interactive mode
 ```sh
-python beeai_framework_starter/agent.py
+uv run python beeai_framework_starter/agent.py


Suggested change

uv run python beeai_framework_starter/agent.py

uv run beeai_framework_starter/agent.py

JanPokorny · 2025-09-11T16:14:05Z

README.md

 ```

 **Option 2:** Define your prompt up front
 ```sh
-python beeai_framework_starter/agent.py <<< "I am going out tomorrow morning to walk around Boston. What should I plan to wear?"
+uv run python beeai_framework_starter/agent.py <<< "I am going out tomorrow morning to walk around Boston. What should I plan to wear?"


Suggested change

uv run python beeai_framework_starter/agent.py <<< "I am going out tomorrow morning to walk around Boston. What should I plan to wear?"

uv run beeai_framework_starter/agent.py <<< "I am going out tomorrow morning to walk around Boston. What should I plan to wear?"

JanPokorny · 2025-09-11T16:14:16Z

README.md

 ```sh
-python beeai_framework_starter/agent_code_interpreter.py <<< "Calculate 534*342?"
+uv run python beeai_framework_starter/agent_code_interpreter.py <<< "Calculate 534*342?"


Suggested change

uv run python beeai_framework_starter/agent_code_interpreter.py <<< "Calculate 534*342?"

uv run beeai_framework_starter/agent_code_interpreter.py <<< "Calculate 534*342?"

JanPokorny · 2025-09-11T16:14:27Z

README.md

 ```sh
-python beeai_framework_starter/agent_code_interpreter.py <<< "Generate a riddle"
+uv run python beeai_framework_starter/agent_code_interpreter.py <<< "Generate a riddle"


Suggested change

uv run python beeai_framework_starter/agent_code_interpreter.py <<< "Generate a riddle"

uv run beeai_framework_starter/agent_code_interpreter.py <<< "Generate a riddle"

JanPokorny · 2025-09-11T16:14:34Z

README.md

 ```sh
-python beeai_framework_starter/agent_workflow.py
+uv run python beeai_framework_starter/agent_workflow.py


Suggested change

uv run python beeai_framework_starter/agent_workflow.py

uv run beeai_framework_starter/agent_workflow.py

feat: migrate to uv

244f84b

Ref: #52 Signed-off-by: Tomas Dvorak <[email protected]>

Tomas2D requested a review from a team as a code owner September 11, 2025 15:59

gemini-code-assist bot reviewed Sep 11, 2025

View reviewed changes

Merge branch 'main' into feat/52-migrate-to-uv

7b5e71f

Signed-off-by: Tomas Dvorak <[email protected]> # Conflicts: # poetry.lock # pyproject.toml

gemini-code-assist bot reviewed Sep 11, 2025

View reviewed changes

README.md Show resolved Hide resolved

README.md Show resolved Hide resolved

feat: migrate to uv

7567924

Ref: #52 Signed-off-by: Tomas Dvorak <[email protected]>

github-advanced-security bot found potential problems Sep 11, 2025

View reviewed changes

Tomas2D merged commit 648b9be into main Sep 11, 2025
5 checks passed

JanPokorny reviewed Sep 11, 2025

View reviewed changes

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

feat: migrate to uv #53

feat: migrate to uv #53

Uh oh!

Tomas2D commented Sep 11, 2025

Uh oh!

gemini-code-assist bot left a comment

Uh oh!

gemini-code-assist bot left a comment

Uh oh!

Uh oh!

Uh oh!

Check warning

Copilot Autofix

Uh oh!

JanPokorny Sep 11, 2025

Uh oh!

JanPokorny Sep 11, 2025

Uh oh!

JanPokorny Sep 11, 2025

Uh oh!

JanPokorny Sep 11, 2025

Uh oh!

JanPokorny Sep 11, 2025

Uh oh!

JanPokorny Sep 11, 2025

Uh oh!

JanPokorny Sep 11, 2025

Uh oh!

JanPokorny Sep 11, 2025

Uh oh!

JanPokorny Sep 11, 2025

Uh oh!

JanPokorny Sep 11, 2025

Uh oh!

Uh oh!

@@ -1,4 +1,6 @@
             name: Lint, Build
+            permissions:
+              contents: read
             on:
               push:

		@@ -24,13 +24,13 @@ This starter template helps you quickly get started with the [BeeAI framewor
		## 📋 Requirements

		- Python Version 3.11+

	uv run python beeai_framework_starter/agent.py
	uv run beeai_framework_starter/agent.py

	uv run python beeai_framework_starter/agent.py <<< "I am going out tomorrow morning to walk around Boston. What should I plan to wear?"
	uv run beeai_framework_starter/agent.py <<< "I am going out tomorrow morning to walk around Boston. What should I plan to wear?"

	uv run python beeai_framework_starter/agent_code_interpreter.py <<< "Calculate 534*342?"
	uv run beeai_framework_starter/agent_code_interpreter.py <<< "Calculate 534*342?"

	uv run python beeai_framework_starter/agent_workflow.py
	uv run beeai_framework_starter/agent_workflow.py

feat: migrate to uv #53

feat: migrate to uv #53

Uh oh!

Conversation

Tomas2D commented Sep 11, 2025

Uh oh!

gemini-code-assist bot left a comment

Choose a reason for hiding this comment

Summary of Changes

Highlights

Footnotes

Uh oh!

gemini-code-assist bot left a comment

Choose a reason for hiding this comment

Code Review

Uh oh!

Uh oh!

Uh oh!

Check warning

Copilot Autofix

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!