DBAB API - Python/FastAPI Version

Developer Ban Appeal Bot API - Modern async Python implementation.

This project is still very much in the alpha stages.

Quick Start

pip install -r requirements.txt
python main.py

Server runs on http://localhost:3000 with auto-generated API docs at /docs.

Tech Stack

• FastAPI - Modern async web framework
• SQLAlchemy - Python ORM
• Pydantic - Request/response validation
• PyMySQL - MySQL driver

Installation

1. Install dependencies:

   pip install -r requirements.txt

2. Ensure config file exists at ~/.dbab-config/dbab.json with MySQL credentials

3. Run the server:

   python main.py

Project Structure

• app.py - FastAPI app configuration
• main.py - Server entry point
• config/ - Configuration loader
• database/ - SQLAlchemy setup
• models/ - SQLAlchemy ORM models
• controllers/ - Business logic
• routes/ - FastAPI routers
• middleware/ - Auth & logging middleware

API Documentation

• Swagger UI: http://localhost:3000/docs
• ReDoc: http://localhost:3000/redoc

Authentication

All endpoints require an Authorization header with a valid API token from the ACL table.

See Also

• Node.js/Express Version - Original implementation
• Migration Guide - Express to FastAPI conversion details