whatisgithub

What is ai-workflow-cleanup?

phanindraintelligenzit-afk/ai-workflow-cleanup — explained in plain English

Analysis updated 2026-05-18

0PythonAudience · ops devopsComplexity · 3/5LicenseSetup · easy

In one sentence

A FastAPI and React tool that scans n8n, Zapier, and Make automations for broken steps and helps fix them.

Mindmap

mindmap
  root((repo))
    What it does
      Scans automations
      Health scoring
      Auto-fix issues
      Activity logging
    Tech stack
      Python
      FastAPI
      React
      Docker
    Use cases
      Audit broken automations
      Repair workflow issues
    Audience
      SMB owners
      Automation builders

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Scan existing n8n, Zapier, or Make workflows for common failure patterns.

USE CASE 2

Get a health score for each automation showing how broken it is.

USE CASE 3

Apply one-click automatic fixes or follow guided manual repair steps.

USE CASE 4

Track every scan and fix action in an audit log with timestamps.

What is it built with?

PythonFastAPIReactSQLiteDocker

How does it compare?

phanindraintelligenzit-afk/ai-workflow-cleanup0xallam/my-recipe0xhassaan/nn-from-scratch
Stars00
LanguagePythonPythonPython
Last pushed2022-11-22
MaintenanceDormant
Setup difficultyeasymoderatemoderate
Complexity3/52/54/5
Audienceops devopsgeneraldeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 5min

Docker Compose starts frontend and backend together, local setup needs Python (uv) and pnpm.

So what is it?

AI Workflow Cleanup is a tool built for small and medium businesses that automated too many processes and ended up with broken results. It connects to your existing automation setups built in n8n, Zapier, or Make, scans them for problems, and walks you through fixing what is wrong. The scanner checks each workflow's steps against a list of common failure patterns, things like missing triggers, bad login credentials, timeouts, rate limits, deprecated APIs, and broken data mappings. Every workflow gets a health score between 0 and 100 percent based on how many issues it has and how serious they are. Once problems are found, you can apply a one click automatic fix for known issues, or follow step by step guidance to fix things manually. Every scan and every fix is logged with a timestamp so you have a record of what changed and when. Under the hood, the project is a web application with a Python based FastAPI backend, a React frontend, and a SQLite database accessed asynchronously. The backend exposes a REST API for listing, creating, scanning, and fixing workflows, and the frontend talks to that API to display results. The whole thing can be configured through environment variables, such as the database connection string and allowed origins for cross origin requests. The easiest way to run it is with Docker Compose, which starts both the frontend and backend with a single command, after which you open the app in your browser. It can also be run without Docker by setting up a Python virtual environment for the backend and running the frontend separately with its own package manager. The project currently supports n8n, Zapier, and Make workflows, and its roadmap includes importing workflow files directly, richer AI powered fix suggestions, and exporting fixed workflows back to their original platform. It is released under the MIT license.

Copy-paste prompts

Prompt 1
Walk me through deploying this with Docker Compose and opening the frontend.
Prompt 2
Show me how to register a new workflow and run a scan using the REST API.
Prompt 3
Explain how the health scoring system rates workflow issues.
Prompt 4
Help me set up the backend and frontend locally without Docker.

Frequently asked questions

What is ai-workflow-cleanup?

A FastAPI and React tool that scans n8n, Zapier, and Make automations for broken steps and helps fix them.

What language is ai-workflow-cleanup written in?

Mainly Python. The stack also includes Python, FastAPI, React.

How hard is ai-workflow-cleanup to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is ai-workflow-cleanup for?

Mainly ops devops.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.