[](https://xkcd.com/1987/)

(As usual, XKCD has a comic for this. Appropriately enough, the comic is out of date.)

# simple-modern-uv

[](https://x.com/ojoshe) [](https://www.python.org/downloads/) [](https://github.com/astral-sh/uv) [](https://github.com/copier-org/copier)

## What Is This?

**simple-modern-uv** is a minimal, modern **Python project template** for new projects (Python 3.11–3.14) based on [**uv**](https://docs.astral.sh/uv/). This template aims to be a good base for serious work but also simple so it’s an easy option for any small project, like an open source library or tool. It can also upgrade an existing project to a modern setup: uv, ruff, BasedPyright, and GitHub Actions, or add only the practices that fit without forcing a full migration. The [agent skill](#use-with-any-coding-agent) handles each adoption path.

## Use with Any Coding Agent

Install the [simple-modern-uv skill bundle](skills/simple-modern-uv/SKILL.md) with the [skills CLI](https://github.com/vercel-labs/skills), then appoint your coding agent to do the work. The bundle follows the [Agent Skills](https://agentskills.io) open format; the installer supports Claude Code, Codex, Cursor, Gemini CLI, and other compatible agents:

```shell NPM_CONFIG_IGNORE_SCRIPTS=true NPM_CONFIG_BEFORE=2026-07-31T18:59:05Z \ npx --yes skills@1.5.18 add jlevy/simple-modern-uv \ --skill simple-modern-uv --yes ```

Then describe the out