메뉴
Initialize FastAPI project with uv, pyproject.toml, ruff configuration, and environment files
기본적으로 소스를 먼저 확인하는 Prompt가 선택됩니다. 직접 명령으로 전환하거나 로컬 사본을 다운로드할 수도 있습니다.
설치 여부를 결정하기 전에 SKILL.md와 SkillsMP에 표시된 보조 파일을 읽어 보세요.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
직접 명령은 검토 Prompt를 거치지 않습니다. 실행하기 전에 소스를 확인하세요.
npx skills add https://github.com/agusmdev/burntop --skill fastapi-project-setup명령은 한 줄로 유지됩니다. 복사하기 전에 가로로 스크롤해 전체 내용을 확인하세요.
로컬 사본을 원하시나요? SkillsMP에서 현재 제공할 수 있는 파일을 다운로드하세요.
OpenProse is a programming language for AI sessions. An AI session is a Turing-complete computer; OpenProse structures English into unambiguous control flow. More pattern than framework—it ships as a skill with no dependencies. Activate when: running .prose files, mentioning OpenProse, or orchestrating multi-agent workflows from a script. Use this skill if you ever want to kick off more than one subagent at a time, or orchestrate anything interesting between more than one subagent. Write a .prose file and save it in the .claude-plugin/ directory. Then embody the OpenProse VM, as described in prose.md, and execute it.
Configure Alembic for async SQLAlchemy migrations with PostgreSQL
Create FastAPI application factory with lifespan, middleware, pagination, and router configuration
SKILL.md 표시 중
SOC 직업 분류 기준
| name | fastapi-project-setup |
| description | Initialize FastAPI project with uv, pyproject.toml, ruff configuration, and environment files |
This skill covers initializing a new FastAPI project with uv package manager, proper project configuration, and tooling setup.
uv init
[project]
name = "your-project-name"
version = "0.1.0"
description = "FastAPI backend application"
requires-python = ">=3.12"
dependencies = [
"fastapi>=0.115.0",
"uvicorn[standard]>=0.32.0",
"pydantic>=2.10.0",
"pydantic-settings>=2.7.0",
"sqlalchemy[asyncio]>=2.0.36",
"asyncpg>=0.30.0",
"alembic>=1.14.0",
"fastapi-pagination>=0.12.33",
"fastapi-filter>=2.0.0",
"python-json-logger>=3.2.1",
]
[project.optional-dependencies]
dev = [
"ruff>=0.8.0",
"pytest>=8.3.0",
"pytest-asyncio>=0.25.0",
"httpx>=0.28.0",
]
= []
=
= []
=
=
= []
= []
3.12
# Ruff configuration for FastAPI project
# Target Python 3.12
target-version = "py312"
# Line length
line-length = 100
# Exclude directories
exclude = [
".git",
".ruff_cache",
".venv",
"venv",
"__pycache__",
"alembic/versions",
]
[lint]
# Enable rules
select = [
"E", # pycodestyle errors
"W", # pycodestyle warnings
"F", # Pyflakes
"I", # isort
"B", # flake8-bugbear
"C4", # flake8-comprehensions
"UP", # pyupgrade
"ARG", # flake8-unused-arguments
"SIM", # flake8-simplify
"TCH", # flake8-type-checking
"PTH", # flake8-use-pathlib
"ERA", # eradicate (commented-out code)
"PL", # Pylint
"RUF", # Ruff-specific rules
]
# Ignore specific rules
ignore = [
"E501", # line too long (handled by formatter)
"B008", # do not perform function calls in argument defaults (needed for Depends)
"PLR0913", # too many arguments
"PLR2004", # magic value comparison
]
# Allow autofix for all enabled rules
fixable = ["ALL"]
unfixable = []
[lint.per-file-ignores]
# Tests can have unused arguments (fixtures)
"tests/**/*.py" = ["ARG"]
# Alembic migrations
"alembic/**/*.py" = ["ERA"]
[lint.isort]
known-first-party = ["app"]
force-single-line = false
combine-as-imports = true
[format]
# Use double quotes for strings
quote-style = "double"
# Indent with spaces
indent-style = "space"
# Unix-style line endings
line-ending = "lf"
# Enable auto-formatting of docstrings
docstring-code-format = true
# Application
APP_NAME=FastAPI App
DEBUG=false
# Database
DATABASE_URL=postgresql+asyncpg://user:password@localhost:5432/dbname
DATABASE_ECHO=false
DATABASE_POOL_SIZE=5
DATABASE_MAX_OVERFLOW=10
# Logging
LOG_LEVEL=INFO
LOG_JSON_FORMAT=true
Create src/app/config.py:
from pydantic import PostgresDsn
from pydantic_settings import BaseSettings, SettingsConfigDict
class Settings(BaseSettings):
"""Application settings loaded from environment variables."""
model_config = SettingsConfigDict(
env_file=".env",
env_file_encoding="utf-8",
extra="ignore",
case_sensitive=False,
)
# Application
app_name: str = "FastAPI App"
debug: bool = False
# Database
database_url: PostgresDsn
database_echo: bool = False
database_pool_size: int = 5
database_max_overflow: int = 10
# Logging
log_level: str = "INFO"
log_json_format: bool = True
settings = Settings()
mkdir -p src/app/{core,common,middleware,api/v1}
mkdir -p tests/api/v1
mkdir -p alembic/versions
touch src/app/__init__.py
touch src/app/core/__init__.py
touch src/app/common/__init__.py
touch src/app/middleware/__init__.py
touch src/app/api/__init__.py
touch src/app/api/v1/__init__.py
touch tests/__init__.py
touch tests/api/__init__.py
touch tests/api/v1/__init__.py
touch alembic/versions/.gitkeep
uv sync
uv sync --dev
After setup, verify:
uv run python -c "import fastapi; print(fastapi.__version__)" worksuv run ruff check src/ runs without errors.env file is created from .env.example with actual valuesuv run to execute commands within the virtual environment.env file, only .env.exampleuv lock --upgrade