TaskFlow AI

TaskFlow AI is a personal workflow prototype that represents major tasks and their internal execution plans as connected graphs. It combines a React Flow workspace, a deterministic FastAPI + SQLite backend, and a human-in-the-loop boundary for agent orchestration.

Product idea

Ordinary task lists hide the structure inside complex work. TaskFlow keeps two levels visible:

• a personal canvas for tasks, dependencies, status, and deadlines;
• an internal workflow for serial, parallel, and merged sub-steps;
• explicit advance_rule fields that describe when work may move forward;
• analytics and calendar views for workload and deadline risk.

OpenClaw is treated as an orchestration layer. It can summarize external information and propose actions through Lark, while TaskFlow remains the deterministic system of record. Status changes are confirmed by the user or justified by evidence that satisfies an explicit rule.

Screens

Internal workflow	Task intelligence

Stack

• Frontend: React 19, TypeScript, Vite, Tailwind CSS 4, React Flow, Zustand
• Backend: FastAPI, Pydantic, SQLite
• Integration boundary: OpenClaw and Lark card proposals

Run locally

Requirements: Python 3.11+, Node.js 20+, and npm.

git clone https://github.com/GaryYang12345/TaskFlowAI.git
cd TaskFlowAI
python -m venv .venv
.\.venv\Scripts\Activate.ps1
pip install -r requirements.txt

cd frontend
npm install
npm run dev

In another terminal:

cd TaskFlowAI
.\.venv\Scripts\Activate.ps1
python -m uvicorn app.main:app --reload --port 8010

• Frontend: http://localhost:5173
• Backend API: http://127.0.0.1:8010

The repository is intentionally curated around the product prototype. Local data, third-party reference projects, virtual environments, build outputs, and private planning notes are excluded.