Advanced Task Management REST API is a small, modern backend for managing users, projects, and tasks. It's built on top of FastAPI for fast development and async performance, using Tortoise ORM + Aerich for database models and migrations, and is designed to be easy to extend.
This repository is currently not finished — still under development, and active improvements are in progress.
Tech & services used (quick glance):
- User authentication and JWT tokens
- Projects and tasks management endpoints
- Database migrations using Aerich and Tortoise ORM
- Async endpoints and connection-ready for Postgres
- Python 3.13 or later
- PostgreSQL (or another supported DB for asyncpg)
- Clone repository
git clone https://github.com/JonniTech/Advanced-Task-Management-REST-API.git
cd "Task Management API"- Create a virtual environment and activate it
python -m venv .venv
source .venv/bin/activate- Install project dependencies
pip install -r requirements.txt-
Create .env with DB and secret settings (see
configs/settings.pyfor env names) -
Run database migrations (aerich)
aerich init -t database.aerich_config.TORTOISE_ORM
aerich upgrade- Start the app locally
uvicorn main:app --reloadOpen API docs at http://127.0.0.1:8000/docs
High level structure (abridged):
api/ # Routers and API routes (v1)
auth/ # Authentication helpers and token logic
database/ # Connection and migration config (aerich)
models/ # Tortoise models
schemas/ # Pydantic request/response schemas
services/ # Business logic / services
main.py # FastAPI bootstrapping
Contributions and feedback are very welcome — open issues or submit a pull request. As the project is under active development, please open an issue to discuss bigger changes before implementing them.
This project is under active development — expect incomplete functionality and breaking changes on the main branch.
If you want to follow or contribute, open an issue or PR. You can reach the maintainer via GitHub: @JonniTech
Thanks for checking this project — improvements coming soon!