Astral Project with uv

uv を使用した Astral プロジェクト

このプロジェクトでは、Astral が作成した高速な Python パッケージマネージャーである uv を使用します。uv は pip、pip-tools、virtualenv の代わりにそのまま使用できる、より高速になるよう設計されたツールです。

必要条件

• Python 3.8 以上
• uv がインストールされていること

インストール

まだ uv をインストールしていない場合は、まずインストールしてください。

curl -Ls https://astral.sh/uv/install.sh | sh

Or use pipx:

pipx install uv

Creating a Virtual Environment

Create a virtual environment with uv:

uv venv .venv

Activate it:
	•	On Linux/macOS:

source .venv/bin/activate


	•	On Windows:

.venv\Scripts\activate



Installing Dependencies

Install the packages listed in requirements.txt (or pyproject.toml if you’re using modern packaging):

uv pip install -r requirements.txt

Or if using pyproject.toml:

uv pip install .

Adding a New Package

To add a new package:

uv pip install package-name

Freezing Dependencies

Freeze the current environment packages into requirements.txt:

uv pip freeze > requirements.txt

Why uv?
	•	Much faster than traditional pip and virtualenv
	•	Manages virtual environments and packages in one tool
	•	Built by Astral

Happy coding!

Would you also like a French version alongside it (like a bilingual `README.md`)?  
Or maybe you want a smaller **minimal version**?