uv-python

name	uv-python
description	Use this skill for Python setup, dependency management, and run commands in backend/ and rag/.

uv Python Skill

Python projects in this repository must use uv.

Rules

• Use uv init, uv add, uv sync, uv lock, and uv run.
• Do not use pip, pip3, Poetry, or root-level requirements.txt for project dependency management.
• Keep each Python service self-contained with its own pyproject.toml, uv.lock, and .python-version.
• Do not commit .venv/.

Backend

Run commands from inside backend/:

uv sync
uv run fastapi dev src/app.py

Add backend dependencies from inside backend/:

uv add <package>

RAG

Run commands from inside rag/:

uv sync
uv run python src/app.py

Add RAG dependencies from inside rag/:

uv add <package>

Legacy _3rd Directories

Directories ending in _3rd, such as streamlit_3rd/, are not current Python scope. Do not run uv sync, tests, or dependency commands there unless explicitly requested.

Lock Files

Commit uv.lock when dependency metadata changes.