{
  "id": "tneemo/fastapi-service",
  "kind": "foundation",
  "description": "Python REST API starter with FastAPI: typed settings from env, JSON error handling, health check, router layout and pytest.",
  "version": "1.0.0",
  "keywords": [
    "api",
    "rest",
    "http",
    "server",
    "backend",
    "starter",
    "python",
    "fastapi",
    "service"
  ],
  "requires": {},
  "provides": [
    "python",
    "fastapi",
    "pydantic",
    "pytest",
    "api",
    "rest-api"
  ],
  "license": "MIT",
  "repository": "https://github.com/tneemo/pkg",
  "risk": "ok",
  "quality": 100,
  "downloads": 0,
  "agent_reports": {
    "success": 0,
    "failure": 0,
    "success_rate": 0.5
  },
  "flags": 0,
  "reputation": 0.48,
  "updated_at": "2026-10-19T14:10:35.375Z",
  "latest": "1.0.0",
  "manifest": {
    "$schema": "https://pkg.tneemo.com/schema/pkg.json",
    "name": "fastapi-service",
    "version": "1.0.0",
    "kind": "foundation",
    "description": "Python REST API starter with FastAPI: typed settings from env, JSON error handling, health check, router layout and pytest.",
    "license": "MIT",
    "keywords": [
      "api",
      "rest",
      "http",
      "server",
      "backend",
      "starter",
      "python",
      "fastapi",
      "service"
    ],
    "stack": {
      "provides": [
        "python",
        "fastapi",
        "pydantic",
        "pytest",
        "api",
        "rest-api"
      ]
    },
    "repository": "https://github.com/tneemo/pkg"
  },
  "readme": "# fastapi-service\n\nA clean starting point for a JSON REST API in Python with [FastAPI](https://fastapi.tiangolo.com).\n\n- `app/main.py`: `create_app()` with optional CORS, a catch-all handler that logs unexpected errors and returns JSON 500s, and router registration.\n- `app/config.py`: typed settings from environment variables and `.env` with pydantic-settings.\n- `app/routers/health.py`: `GET /health`.\n- `tests/`: pytest with FastAPI's `TestClient`, no running server needed.\n- `AGENTS.md`: project conventions for coding agents.\n\npkg creates `.venv` and installs `requirements-dev.txt` for you. Pairs with `tneemo/fastapi-api-key` for API key auth.\n",
  "integration": "This is a foundation: it creates the project. After installing (pkg creates `.venv` and installs the requirements):\n\n1. Run the tests: `.venv/bin/python -m pytest` (Windows: `.venv\\Scripts\\python -m pytest`).\n2. Start the server: `.venv/bin/python -m uvicorn app.main:app --reload`, then open http://localhost:8000/docs.\n3. Add features as routers in `app/routers/<feature>.py` and include them in `create_app()` in `app/main.py`. Follow `AGENTS.md`.\n",
  "files": [
    {
      "path": ".env.example",
      "size": 128
    },
    {
      "path": ".gitignore",
      "size": 45
    },
    {
      "path": "AGENTS.md",
      "size": 833
    },
    {
      "path": "app/__init__.py",
      "size": 0
    },
    {
      "path": "app/config.py",
      "size": 450
    },
    {
      "path": "app/main.py",
      "size": 1024
    },
    {
      "path": "app/routers/__init__.py",
      "size": 0
    },
    {
      "path": "app/routers/health.py",
      "size": 152
    },
    {
      "path": "pytest.ini",
      "size": 42
    },
    {
      "path": "requirements-dev.txt",
      "size": 42
    },
    {
      "path": "requirements.txt",
      "size": 52
    },
    {
      "path": "tests/__init__.py",
      "size": 0
    },
    {
      "path": "tests/test_health.py",
      "size": 406
    }
  ],
  "checks": {
    "risk": "ok",
    "quality": 100,
    "findings": [
      {
        "level": "info",
        "code": "agent-instructions",
        "file": "AGENTS.md",
        "message": "writes instructions that coding agents will follow"
      }
    ]
  },
  "integrity": "sha256-CVX8sxwImtsNh/ze8Dydtukn3/KVq2J1DTGKGwQGxKA=",
  "publisher": "admin:tneemo",
  "published_at": "2026-10-19T14:10:35.375Z",
  "versions": [
    {
      "version": "1.0.0",
      "published_at": "2026-10-19T14:10:35.375Z",
      "risk": "ok",
      "yanked": false
    }
  ]
}