Typing Animation

Status Python FastAPI Tortoise ORM

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):

• Python
• FastAPI
• Uvicorn
• Tortoise ORM
• Aerich
• asyncpg
• PyJWT

• 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)

1. Clone repository

git clone https://github.com/JonniTech/Advanced-Task-Management-REST-API.git
cd "Task Management API"

2. Create a virtual environment and activate it

python -m venv .venv
source .venv/bin/activate

3. Install project dependencies

pip install -r requirements.txt

4. Create .env with DB and secret settings (see configs/settings.py for env names)

5. Run database migrations (aerich)

aerich init -t database.aerich_config.TORTOISE_ORM
aerich upgrade

6. Start the app locally

uvicorn main:app --reload

Open 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!