Skip to content

Mention uv in Python dependency management options #2457

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
kcmartin merged 1 commit into from
Aug 7, 2026
+1 −0
Merged

Mention uv in Python dependency management options #2457

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions python/the-basics/initial-setup.html.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@
This allows you to run your project locally, and test that it works, before deploying it to Fly.io.

<section class="callout">
We recommend the latest [supported versions](https://devguide.python.org/versions/#supported-versions) of Python.

Check warning on line 15 in python/the-basics/initial-setup.html.md

View workflow job for this annotation

GitHub Actions / Vale linter 

[vale] reported by reviewdog 🐶
Avoid time-based words like 'latest' in product documentation.

Raw Output:
{"message":"Avoid time-based words like 'latest' in product documentation.","location":{"path":"python/the-basics/initial-setup.html.md","range":{"start":{"line":15,"column":18},"end":{"line":15,"column":24}}},"severity":"INFO","code":{"value":"Google.Timeless","url":"https://developers.google.com/style/timeless-documentation"}}
</section>

## Dependency Management
Expand All @@ -20,9 +20,10 @@
For project and dependency management we use [Poetry](https://python-poetry.org/). Like most package managers, Poetry combines multiple tools in one.

You have other options:
- [uv](https://docs.astral.sh/uv/)

Check warning on line 23 in python/the-basics/initial-setup.html.md

View workflow job for this annotation

GitHub Actions / Vale linter 

[vale] reported by reviewdog 🐶
Is 'uv' a typo?

Raw Output:
{"message":"Is 'uv' a typo?","location":{"path":"python/the-basics/initial-setup.html.md","range":{"start":{"line":23,"column":4},"end":{"line":23,"column":6}}},"severity":"INFO","code":{"value":"Fly.Spelling"}}
- [venv](https://docs.python.org/3/library/venv.html) and [pip](https://pip.pypa.io/)

Check warning on line 24 in python/the-basics/initial-setup.html.md

View workflow job for this annotation

GitHub Actions / Vale linter 

[vale] reported by reviewdog 🐶
Is 'venv' a typo?

Raw Output:
{"message":"Is 'venv' a typo?","location":{"path":"python/the-basics/initial-setup.html.md","range":{"start":{"line":24,"column":4},"end":{"line":24,"column":8}}},"severity":"INFO","code":{"value":"Fly.Spelling"}}
- [Pipenv](https://github.com/pypa/pipenv)

Check warning on line 25 in python/the-basics/initial-setup.html.md

View workflow job for this annotation

GitHub Actions / Vale linter 

[vale] reported by reviewdog 🐶
Is 'Pipenv' a typo?

Raw Output:
{"message":"Is 'Pipenv' a typo?","location":{"path":"python/the-basics/initial-setup.html.md","range":{"start":{"line":25,"column":4},"end":{"line":25,"column":10}}},"severity":"INFO","code":{"value":"Fly.Spelling"}}
- [pyenv](https://github.com/pyenv/pyenv)

Check warning on line 26 in python/the-basics/initial-setup.html.md

View workflow job for this annotation

GitHub Actions / Vale linter 

[vale] reported by reviewdog 🐶
Is 'pyenv' a typo?

Raw Output:
{"message":"Is 'pyenv' a typo?","location":{"path":"python/the-basics/initial-setup.html.md","range":{"start":{"line":26,"column":4},"end":{"line":26,"column":9}}},"severity":"INFO","code":{"value":"Fly.Spelling"}}
- [pip-tools](https://pypi.org/project/pip-tools/)

If you are just starting out, it is easiest to follow along using `poetry`.
Expand Down Expand Up @@ -68,4 +69,4 @@
python main.py
```

<div class="callout">If you're using Poetry 2.0+ (the default when installed via `pipx`), the `poetry shell` command is no longer built in. Use `poetry run` (recommended) or `poetry env activate` as shown above. If you prefer `poetry shell`, you can install it as a plugin: `poetry self add poetry-plugin-shell`.</div>

Check warning on line 72 in python/the-basics/initial-setup.html.md

View workflow job for this annotation

GitHub Actions / Vale linter 

[vale] reported by reviewdog 🐶
Use 'preceding' instead of 'above'.

Raw Output:
{"message":"Use 'preceding' instead of 'above'.","location":{"path":"python/the-basics/initial-setup.html.md","range":{"start":{"line":72,"column":206},"end":{"line":72,"column":211}}},"severity":"WARNING","code":{"value":"Google.WordListCase","url":"https://developers.google.com/style/word-list"}}
Loading