Attakay78

Attakay78 / fastapi-taskflow

Public

Turn FastAPI BackgroundTasks into a production-ready task system. Retries, Resiliency, control, and visibility without workers or brokers.

attakay78.github.iofastapi-taskflow background-tasks fastapi observability resiliency retries
19
1
100% credibility
Found Apr 13, 2026 at 19 stars -- GitGems finds repos before they trend. Get early access to the next one.
Sign Up Free
AI Analysis
Python
AI Summary

fastapi-taskflow is a lightweight extension for FastAPI applications that adds retries, status tracking, persistence, logging, and a live dashboard to native background tasks without requiring workers or brokers.

How It Works

1
🚀 Discover the tool

While building a web app that runs jobs in the background like sending emails, you find a simple helper that adds retries and tracking without extra hassle.

2
📦 Add it easily

You include the helper in your app with one quick setup step, no big changes needed.

3
✏️ Mark your background jobs

You label the functions that do background work and choose how many retry attempts they get if something goes wrong.

4
🌐 Turn on the live dashboard

You connect a beautiful screen that shows everything happening with your jobs in real time.

5
▶️ Launch your app

You start your web app just like always, and the new features kick in automatically.

6
👀 Watch jobs in action

Open the dashboard in your browser to see tasks start, run, succeed, fail with details, or retry smoothly.

🎉 Perfect background reliability

Now your app's background jobs never get lost, always retry smartly, survive restarts, and you have full visibility into what’s happening.

Sign up to see the full architecture

5 more

Sign Up Free

Star Growth

See how this repo grew from 19 to 19 stars Sign Up Free
Repurpose This Repo

Repurpose is a Pro feature

Generate ready-to-use prompts for X threads, LinkedIn posts, blog posts, YouTube scripts, and more -- with full repo context baked in.

Unlock Repurpose
AI-Generated Review

What is fastapi-taskflow?

fastapi-taskflow upgrades FastAPI's native BackgroundTasks into a production-ready system with automatic retries, exponential backoff, full lifecycle tracking (pending, running, success, failed, interrupted), and a live dashboard at /tasks/dashboard. It adds SQLite or Redis persistence for surviving restarts, requeues unfinished tasks on startup, and supports idempotency keys to dedupe operations—all without workers or brokers. Python-based, it patches your existing FastAPI routes so BackgroundTasks injections work unchanged.

Why is it gaining traction?

Unlike Celery or ARQ, it layers directly on FastAPI BackgroundTasks with zero migration: decorate functions, add TaskAdmin to your app, and get retries, SSE-powered visibility, file logging for tail/grep, and multi-instance support via shared backends. Developers love the instant dashboard for debugging, API endpoints like /tasks/metrics and POST /tasks/{id}/retry, plus opt-in requeue for interrupted tasks—prod control without infra overhead.

Who should use this?

FastAPI backend devs handling emails, notifications, or file processing who hit BackgroundTasks limits like silent failures or no restart survival. Solo devs or small teams avoiding broker complexity, especially in single-host deploys where you want quick visibility without turning FastAPI into a full task queue.

Verdict

Solid for prototyping or low-volume prod—installs clean, docs are polished with guides for logging and multi-instance. At 19 stars and 1.0% credibility, it's early alpha; test thoroughly before high stakes, but a smart pick if you want production-ready BackgroundTasks fast.

(187 words)

Sign up to read the full AI review Sign Up Free

Similar repos coming soon.