How do I install the Fastapi Service skill?

Run npx skillmds@latest add tomevault-io/fastapi-service in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Fastapi Service safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Fastapi Service?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Fastapi Service free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Fastapi Service?

tomevault-io (@tomevault-io) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Fastapi Service by tomevault-io — Agent Skill

Name: Fastapi Service
Author: tomevault-io

File contents

FastAPI Service Conventions

Applies to the api/ workspace.

Versions

Python 3.9+ (project tested on 3.9). Avoid X | Y union syntax in runtime-evaluated type hints (FastAPI evaluates return annotations).
FastAPI 0.110+, SQLAlchemy 2.0+, Alembic, psycopg2-binary, pydantic-settings.

Layout

api/
  app/
    __init__.py
    config.py     — pydantic-settings loading `.env`
    db.py         — engine, SessionLocal, Base, get_db()
    models.py     — SQLAlchemy ORM models + enum tuples
    schemas.py    — Pydantic request/response schemas
    main.py       — FastAPI app + routes + CORS
  alembic/
    env.py        — wired to app.db.Base.metadata
    versions/     — generated migrations
  alembic.ini
  requirements.txt
  seed.py
  .env / .env.example

Rules

Activate the venv before any python/alembic/uvicorn command: source .venv/bin/activate.
Config: read everything through app.config.settings (pydantic BaseSettings). Never os.environ[...] in app code.
DB access: request handlers take db: Session = Depends(get_db). Use SQLAlchemy 2.0 select() style. Avoid legacy Query.
Schemas first. Every endpoint that returns ORM data should declare response_model=schemas.X so Pydantic handles serialization.
Python 3.9 quirk: return types that include | unions must either be quoted, Union[...] imports, or omitted — FastAPI evaluates them.
CORS: CORS_ORIGINS is comma-separated in .env; default allows http://localhost:3000.

Commands

cd api
python3 -m venv .venv && source .venv/bin/activate
pip install -r requirements.txt

alembic revision --autogenerate -m "what changed"
alembic upgrade head
python seed.py                       # idempotent; skips if data exists
uvicorn app.main:app --reload --port 8000

Adding an endpoint

Add/adjust ORM model in app/models.py.
alembic revision --autogenerate -m "..." + alembic upgrade head.
Add Pydantic schema(s) in app/schemas.py.
Add route in app/main.py, using Depends(get_db) and response_model=.
Extend the TypeScript client (web/src/lib/api.ts).

Resetting the DB

dropdb gulp_marketplace && createdb -O gulp gulp_marketplace
alembic upgrade head && python seed.py

Source: benson-alist/gulp — distributed by TomeVault.

---name: fastapi-servicedescription: Conventions for the FastAPI + SQLAlchemy + Alembic service in `api/`. Use when adding endpoints, models, or migrations. Use when this capability is needed.---# FastAPI Service ConventionsApplies to the `api/` workspace.## Versions- Python 3.9+ (project tested on 3.9). Avoid `X | Y` union syntax in runtime-evaluated type hints (FastAPI evaluates return annotations).- FastAPI 0.110+, SQLAlchemy 2.0+, Alembic, psycopg2-binary, pydantic-settings.## Layout```api/ app/ __init__.py config.py — pydantic-settings loading `.env` db.py — engine, SessionLocal, Base, get_db() models.py — SQLAlchemy ORM models + enum tuples schemas.py — Pydantic request/response schemas main.py — FastAPI app + routes + CORS alembic/ env.py — wired to app.db.Base.metadata versions/ — generated migrations alembic.ini requirements.txt seed.py .env / .env.example```## Rules- **Activate the venv** before any python/alembic/uvicorn command: `source .venv/bin/activate`.- **Config:** read everything through `app.config.settings` (pydantic BaseSettings). Never `os.environ[...]` in app code.- **DB access:** request handlers take `db: Session = Depends(get_db)`. Use SQLAlchemy 2.0 `select()` style. Avoid legacy `Query`.- **Schemas first.** Every endpoint that returns ORM data should declare `response_model=schemas.X` so Pydantic handles serialization.- **Python 3.9 quirk:** return types that include `|` unions must either be quoted, `Union[...]` imports, or omitted — FastAPI evaluates them.- **CORS:** `CORS_ORIGINS` is comma-separated in `.env`; default allows `http://localhost:3000`.## Commands```shcd apipython3 -m venv .venv && source .venv/bin/activatepip install -r requirements.txtalembic revision --autogenerate -m "what changed"alembic upgrade headpython seed.py # idempotent; skips if data existsuvicorn app.main:app --reload --port 8000```## Adding an endpoint1. Add/adjust ORM model in `app/models.py`.2. `alembic revision --autogenerate -m "..."` + `alembic upgrade head`.3. Add Pydantic schema(s) in `app/schemas.py`.4. Add route in `app/main.py`, using `Depends(get_db)` and `response_model=`.5. Extend the TypeScript client (`web/src/lib/api.ts`).## Resetting the DB```shdropdb gulp_marketplace && createdb -O gulp gulp_marketplacealembic upgrade head && python seed.py```---> Source: [benson-alist/gulp](https://github.com/benson-alist/gulp) — distributed by [TomeVault](https://tomevault.io).

Frequently asked questions

Fastapi Service