Codewshobson-agents

fastapi-templates

Create production-ready FastAPI projects with async patterns, dependency injection, and comprehensive error handling. Use when building new FastAPI applications or setting up backend API projects.

Open in Skill Hub View pinned source

3.9k est. installs39.1k stars

Estimated installs are a discovery signal based on public repository popularity and source completeness, not recorded Dokki installation events.

Repository

wshobson/agents

Pinned commit

d82998e7df39

License

MIT

Execution

Instructions only

Complete source instructions

SKILL.md

FastAPI Project Templates

Production-ready FastAPI project structures with async patterns, dependency injection, middleware, and best practices for building high-performance APIs.

When to Use This Skill

Starting new FastAPI projects from scratch
Implementing async REST APIs with Python
Building high-performance web services and microservices
Creating async applications with PostgreSQL, MongoDB
Setting up API projects with proper structure and testing

Core Concepts

1. Project Structure

Recommended Layout:

app/├── api/                    # API routes│   ├── v1/│   │   ├── endpoints/│   │   │   ├── users.py│   │   │   ├── auth.py│   │   │   └── items.py│   │   └── router.py│   └── dependencies.py     # Shared dependencies├── core/                   # Core configuration│   ├── config.py│   ├── security.py│   └── database.py├── models/                 # Database models│   ├── user.py│   └── item.py├── schemas/                # Pydantic schemas│   ├── user.py│   └── item.py├── services/               # Business logic│   ├── user_service.py│   └── auth_service.py├── repositories/           # Data access│   ├── user_repository.py│   └── item_repository.py└── main.py                 # Application entry

app/├── api/                    # API routes│   ├── v1/│   │   ├── endpoints/│   │   │   ├── users.py│   │   │   ├── auth.py│   │   │   └── items.py│   │   └── router.py│   └── dependencies.py     # Shared dependencies├── core/                   # Core configuration│   ├── config.py│   ├── security.py│   └── database.py├── models/                 # Database models│   ├── user.py│   └── item.py├── schemas/                # Pydantic schemas│   ├── user.py│   └── item.py├── services/               # Business logic│   ├── user_service.py│   └── auth_service.py├── repositories/           # Data access│   ├── user_repository.py│   └── item_repository.py└── main.py                 # Application entry

2. Dependency Injection

FastAPI's built-in DI system using Depends:

Database session management
Authentication/authorization
Shared business logic
Configuration injection

3. Async Patterns

Proper async/await usage:

Async route handlers
Async database operations
Async background tasks
Async middleware

Detailed worked examples and patterns

Detailed sections (starting with ## Implementation Patterns) live in references/details.md. Read that file when the navigation summary above is insufficient.

Testing

python

# tests/conftest.pyimport pytestimport asynciofrom httpx import AsyncClientfrom sqlalchemy.ext.asyncio import create_async_engine, AsyncSessionfrom sqlalchemy.orm import sessionmaker
from app.main import appfrom app.core.database import get_db, Base
TEST_DATABASE_URL = "sqlite+aiosqlite:///:memory:"
@pytest.fixture(scope="session")def event_loop():    loop = asyncio.get_event_loop_policy().new_event_loop()    yield loop    loop.close()
@pytest.fixtureasync def db_session():    engine = create_async_engine(TEST_DATABASE_URL, echo=True)    async with engine.begin() as conn:        await conn.run_sync(Base.metadata.create_all)
    AsyncSessionLocal = sessionmaker(        engine, class_=AsyncSession, expire_on_commit=False    )
    async with AsyncSessionLocal() as session:        yield session
@pytest.fixtureasync def client(db_session):    async def override_get_db():        yield db_session
    app.dependency_overrides[get_db] = override_get_db
    async with AsyncClient(app=app, base_url="http://test") as client:        yield client
# tests/test_users.pyimport pytest
@pytest.mark.asyncioasync def test_create_user(client):    response = await client.post(        "/api/v1/users/",        json={            "email": "test@example.com",            "password": "testpass123",            "name": "Test User"        }    )    assert response.status_code == 201    data = response.json()    assert data["email"] == "test@example.com"    assert "id" in data

# tests/conftest.pyimport pytestimport asynciofrom httpx import AsyncClientfrom sqlalchemy.ext.asyncio import create_async_engine, AsyncSessionfrom sqlalchemy.orm import sessionmaker
from app.main import appfrom app.core.database import get_db, Base
TEST_DATABASE_URL = "sqlite+aiosqlite:///:memory:"
@pytest.fixture(scope="session")def event_loop():    loop = asyncio.get_event_loop_policy().new_event_loop()    yield loop    loop.close()
@pytest.fixtureasync def db_session():    engine = create_async_engine(TEST_DATABASE_URL, echo=True)    async with engine.begin() as conn:        await conn.run_sync(Base.metadata.create_all)
    AsyncSessionLocal = sessionmaker(        engine, class_=AsyncSession, expire_on_commit=False    )
    async with AsyncSessionLocal() as session:        yield session
@pytest.fixtureasync def client(db_session):    async def override_get_db():        yield db_session
    app.dependency_overrides[get_db] = override_get_db
    async with AsyncClient(app=app, base_url="http://test") as client:        yield client
# tests/test_users.pyimport pytest
@pytest.mark.asyncioasync def test_create_user(client):    response = await client.post(        "/api/v1/users/",        json={            "email": "test@example.com",            "password": "testpass123",            "name": "Test User"        }    )    assert response.status_code == 201    data = response.json()    assert data["email"] == "test@example.com"    assert "id" in data

Same repository

fastapi-templates

SKILL.md

FastAPI Project Templates

When to Use This Skill

Core Concepts

1. Project Structure

2. Dependency Injection

3. Async Patterns

Detailed worked examples and patterns

Testing

api-design-principles

architecture-patterns

avoid-ai-writing

before-you-build

block-no-verify-hook

brand-landingpage

Start your company of agents
today.

fastapi-templates

SKILL.md

FastAPI Project Templates

When to Use This Skill

Core Concepts

1. Project Structure

2. Dependency Injection

3. Async Patterns

Detailed worked examples and patterns

Testing

Related Skills

api-design-principles

architecture-patterns

avoid-ai-writing

before-you-build

block-no-verify-hook

brand-landingpage

Start your company of agentstoday.

Start your company of agents
today.