Claude Python Setup

Claude Python Setup

A comprehensive CLAUDE.md template for setting up modern Python development environments with uv, ruff, pytest, and automated tooling. This repository provides a battle-tested configuration that can be used with Claude Code to quickly bootstrap Python projects with best practices.

Overview

This repository contains a complete CLAUDE.md file that automates the setup of a modern Python development environment including:

• uv - Fast Python package manager and dependency resolver
• ruff - Lightning-fast Python linter and formatter
• pytest - Modern testing framework with coverage reporting
• pre-commit - Git hooks for code quality enforcement
• GitHub Actions - Automated CI/CD pipeline
• Makefile - Developer convenience commands

Quick Start

Option 1: Use with Claude Code

1. Copy the CLAUDE.md file to your Python project directory
2. Ask Claude Code to run the setup:

   Run the Python development environment setup from CLAUDE.md

Option 2: Manual Setup

1. Clone or download this repository
2. Copy CLAUDE.md to your Python project
3. Run the setup commands from the CLAUDE.md file

What Gets Created

The setup process creates a complete development environment:

your-project/
├── .editorconfig           # Editor configuration
├── .gitignore             # Python-specific gitignore
├── .pre-commit-config.yaml # Pre-commit hooks
├── .github/workflows/ci.yml # GitHub Actions CI
├── CONTRIBUTING.md        # Contribution guidelines
├── Makefile              # Development commands
├── pyproject.toml        # Project configuration
├── src/your_package/     # Package source code
│   └── __init__.py
└── tests/                # Test directory
    └── test_example.py

Available Commands

After setup, use these Make commands for development:

• make help - Show all available commands
• make dev - Set up development environment
• make test - Run tests with pytest
• make lint - Run r