⚡ FastAPI NoSQL Template

The high-performance, minimalist backbone for NoSQL-native applications.

Features • Speedrun • The Stack • GraphQL • Contributing

---

🌪️ Philosophy

Most templates are bloated. FastAPI-NoSQL is built for developers who care about the metal. It’s focused, strictly type-safe, and asynchronous from the ground up. Zero ORM overhead, just raw NoSQL power and clean abstractions.

"If it's not async, it's not ready for the future."

---

🚀 Features

🔥 Core Engine

• Fully Async: Non-blocking I/O across FastAPI, Motor (MongoDB), and Redis.
• Pydantic v2: Lightning-fast data validation and serialization.
• Versioned APIs: Native support for /v1 and /v2 routing out of the box.
• Hybrid Power: Simultaneous support for REST and GraphQL (Strawberry).

🛡️ Security & Auth

• Asymmetric JWT: RS256 token signing with statically generated RSA keypairs.
• Scoped RBAC: Fine-grained permissions (Admin, Seller, Customer).
• Rate Limiting: Dynamic, Redis-backed protection via SlowAPI.

💾 Data & Management

• Atlas Ready: Intelligent URI construction for local or MongoDB Atlas (SRV).
• Admin Dashboard: Real-time analytics for users, products, and categories.
• Role Migration: Native logic to migrate users between roles and collections.

🛠️ Ops & Observability

• Prometheus Ready: Built-in /metrics endpoint and structured JSON logging.
• 100% Coverage: Exhuastive test suite with full MongoDB and Redis mocking.
• Nginx Gateway: Production-ready container orchestration.

---

🕹️ Speedrun

# 1. Clone the power
git clone https://github.com/th0truth/fastapi-nosql-template.git && cd fastapi-nosql-template

# 2. Inject environment
cp .env.example .env

# 3. Generate RSA keys for JWT
# Generate the keys locally:
openssl genrsa -out private_key.pem 2048
openssl rsa -in private_key.pem -pubout -out public_key.pem
# Then format them for .env (replace newlines with \n and wrap in quotes)
# Add them to .env as PRIVATE_KEY_PEM="..." and PUBLIC_KEY_PEM="..."

# 4. Ignite
docker compose up --build

⌨️ Local Workflow

Command	Action
bash scripts/build.sh	Build optimized Docker images
bash scripts/run.sh	Launch the full stack
bash scripts/clean.sh	Wipe containers, networks, and volumes

---

🏗️ The Stack

Layer	Technology
Logic	FastAPI + Python 3.11+
Persistence	MongoDB + Motor (Async)
Cache / Limit	Redis + aioredis
GraphQL	Strawberry GraphQL
Metrics	Prometheus
Gateway	Nginx

---

🧬 GraphQL Playground

Fetch users and products in a single high-speed request at /graphql.

query {
  user(username: "admin") {
    username
    email
    role
  }
  products(category: "electronics") {
    title
    brand
    price
  }
}

📄 License

This project is licensed under the MIT License. See the LICENSE file for details.

Built for developers who ship fast.
⭐ Star this repo if it helps your next project!