Home

ZOO

An asynchronous zoo API, powered by FastAPI, SQLAlchemy 2.0, Pydantic v2, and Alembic.

What is this?

zoo is a simple API example project that allows you to manage a zoo. It uses all the basic building blocks of a modern API, including

• Asynchronous ASGI Framework (FastAPI)
• Production Ready Server (Uvicorn)
• Modern SQL ORM (SQLAlchemy 2.0)
• Data Validation (Pydantic v2)
• Authentication (fastapi-users)
• Database Migrations (Alembic)
• Docker Images (Docker)
• Documentation (mkdocs-material)
• Testing (pytest)
• CI/CD (GitHub Actions)
• Python Environment Management (hatch)
• Release Automation (semantic-release)
• Serverless Deployment (Mangum + AWS Lambda)
• Worker Queues (Celery)
• API Caching (redis)
• What else?

This project is meant to be a starting point for building your own API, it outlines the basic structure of an API project and provides a few examples of how to implement common features.