python-project

Generate modern Python project blueprints for APIs, CLIs, and data pipelines.

258|26|Updated Dec 9, 2025
One-click install
npx skills add https://github.com/majiayu000/claude-arsenal --skill python-project-majiayu000
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: python-project
Source: https://github.com/majiayu000/claude-arsenal/tree/main/skills/python-project
Command: npx skills add https://github.com/majiayu000/claude-arsenal --skill python-project-majiayu000

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill provides a modern Python project architecture guide to help you create API services, CLIs, and data pipelines with up-to-date best practices. It reduces setup time, complexity, and boilerplate by recommending a consistent structure, tooling, and patterns.

Core Features & Use Cases

  • Type hints everywhere — Pydantic for runtime validation and mypy for static type checks.
  • Async-first patterns — Async APIs and internal calls to maximize throughput.
  • Unified toolchain — Ruff as the single lint/format tool; pyproject.toml as the sole config; src/ layout under src/; LiteLLM proxy for all LLM interactions.
  • Modern project layout — All code under src/, no setup.py or requirements.txt.

Quick Start

Initialize a new project with uv, set the Python version, and add core dependencies (fastapi, uvicorn, pydantic, SQLAlchemy, httpx). Adopt the src/ layout and enable LiteLLM for LLM integrations.

Frequently Asked Questions about python-project

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I structure a modern Python project with async APIs and type hints?

Use a src/ layout with Pydantic for runtime validation, mypy for static type checking, and async patterns throughout. This Skill provides a complete blueprint covering project structure, tooling with Ruff, dependencies via uv, and async-first execution for APIs, CLIs, and data pipelines.

What's the best way to set up a FastAPI project with Ruff and Pydantic?

Initialize with uv, adopt src/ layout, add FastAPI and Pydantic as core dependencies, configure Ruff as your single lint/format tool via pyproject.toml, and enable type hints everywhere. This Skill delivers a ready-to-use architecture eliminating boilerplate and setup complexity.

Can I build Python APIs without setup.py and requirements.txt?

Yes. Use uv for dependency management and pyproject.toml as your sole configuration file. This Skill demonstrates a no-setup.py strategy with modern tooling, LiteLLM proxy integration for LLM calls, and unified dependency/version management.

How do I implement async patterns in Python data pipelines and CLIs?

Apply async-first execution to internal calls and external services using httpx and FastAPI where applicable. This Skill covers async patterns across APIs, CLIs, and data pipelines with type hints and modern project structure to maximize throughput.

Does this approach work with SQLAlchemy and mypy type checking?

Yes. This Skill integrates SQLAlchemy with Pydantic for runtime validation and mypy for static type checking, providing pervasive type hints across your data layer and API endpoints in a src/ layout.

What tooling do I need to replace Black, isort, and flake8?

Use Ruff as a unified linter and formatter, replacing Black, isort, and flake8 in a single tool. This Skill adopts Ruff as part of a modern Python toolchain alongside uv, Pydantic, FastAPI, and async patterns.