https://github.com/edycutjong/suture
🩺 Autonomous AI agent that detects and self-heals broken Fivetran syncs in under 60 seconds.
https://github.com/edycutjong/suture
ai-agent fastapi fivetran gemini-api hackathon nextjs schema-drift self-healing supabase
Last synced: 20 days ago
JSON representation
🩺 Autonomous AI agent that detects and self-heals broken Fivetran syncs in under 60 seconds.
- Host: GitHub
- URL: https://github.com/edycutjong/suture
- Owner: edycutjong
- License: mit
- Created: 2026-05-22T12:57:14.000Z (about 1 month ago)
- Default Branch: main
- Last Pushed: 2026-05-31T01:21:45.000Z (about 1 month ago)
- Last Synced: 2026-05-31T02:28:05.317Z (about 1 month ago)
- Topics: ai-agent, fastapi, fivetran, gemini-api, hackathon, nextjs, schema-drift, self-healing, supabase
- Language: TypeScript
- Homepage: https://suture.edycu.dev
- Size: 32.9 MB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 21
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Agents: AGENTS.md
Awesome Lists containing this project
README
Suture 🩺
Autonomous AI agent that detects and self-heals broken Fivetran syncs in under 60 seconds.
[](https://suture.edycu.dev)
[](https://suture.edycu.dev/pitch-deck)
[](https://youtu.be/Mckrst7NF8Y)
[](https://rapid-agent.devpost.com/)
[](https://github.com/edycutjong/suture/actions/workflows/ci.yml)
---
## 📸 See it in Action
### 🌐 Landing Page
### 🖥️ Dashboard — Command Center
### 🤖 Agent Terminal — Autonomous Healing
> **Self-healing infrastructure in action.** Schema Break → Webhook → Log Analysis → Schema Diff → AI Reasoning → API Patch → Re-Sync → ✅ GREEN.
---
## 💡 The Problem & Solution
Schema drift is the #1 cause of data pipeline failures. When an upstream source changes its API schema — renaming columns, adding fields, or deprecating endpoints — downstream Fivetran connectors break silently. The current fix is manual: 2-4 hours of comparing schemas, guessing mappings, and hoping nothing else breaks.
**Average cost per incident: $500–$2,000 in engineering time + data downtime.**
**Suture** solves this by turning Fivetran into a self-healing infrastructure.
**Key Features:**
- ⚡ **Autonomous Healing:** Detects and patches drift in under 60 seconds without human intervention.
- 🧠 **Semantic Reasoning:** Uses Gemini 3 Pro to understand context, avoiding blind string-matching errors.
- 🛡️ **Observability:** Military-grade SOC dashboard providing real-time oversight of the healing pipeline.
## 🏗️ Architecture & Tech Stack
```mermaid
flowchart LR
W(["🔔 Fivetran\nWebhook"])
D["01 · DETECT\ndetector.py"]
DI["02 · DIAGNOSE\ndiagnoser.py"]
M["03 · MAP\nmapper.py"]
P["04 · PATCH\npatcher.py"]
V["05 · VERIFY\nverifier.py"]
H(["✅ HEALED\n< 60 seconds"])
G(["✦ Gemini 3 Pro\nVertex AI"])
FT(["⚡ Fivetran\nREST API"])
PH(["📡 Arize\nPhoenix"])
SB(["🗄 Supabase"])
W --> D --> DI --> M --> P --> V --> H
G -- semantic reasoning --> M
FT -- PATCH /schemas --> P
D & DI & M & P & V -. traces .-> PH
DI & P & V -. state .-> SB
```
| Layer | Technology |
|---|---|
| **Agent** | Python 3.12, FastAPI |
| **AI** | Gemini 3 Pro (Vertex AI) |
| **Data** | Fivetran REST API (7 methods) |
| **Observability** | Arize Phoenix |
| **Dashboard** | Next.js 16, React 19, Tailwind v4 |
| **Database** | Supabase (PostgreSQL + Realtime) |
| **Deploy** | Cloud Run (agent) + Vercel (dashboard) |
## 🏆 Sponsor Tracks Targeted
- **Fivetran Partner Track ($5,000):** Deep integration with Fivetran's API to manage syncs and modify table mappings programmatically.
- **Grand Prize ($20,000):** Pushing the boundaries of autonomous AI agents in mission-critical infrastructure.
## 🚀 Getting Started
### Prerequisites
- Node.js ≥ 20
- npm
- Python 3.12
### Installation
1. Clone: `git clone https://github.com/edycutjong/suture.git`
2. Set up agent:
```bash
cd agent && pip install -r requirements.txt
```
3. Set up dashboard:
```bash
cd ../dashboard && npm install
```
4. Configure: `cp .env.example .env.local` (dashboard) and `cp .env.example .env` (agent), then add your API keys.
5. Run: `npm run dev` (in dashboard) and `uvicorn main:app` (in agent).
> **For Judges:** Watch the automated demo pipeline!
> `python scripts/seed.py` (Setup healthy pipeline)
> `python scripts/break_schema.py` (Simulate drift)
## 🧪 Testing & CI
### 🛠️ Root Commands
You can run checks for both frontend and backend from the root directory using the `Makefile`:
```bash
make test # Run all tests (backend + frontend)
make coverage # Run all tests with coverage report
make ci # Run full CI pipeline (lint, typecheck, tests, build)
```
### 💻 Dashboard (Frontend)
```bash
cd dashboard
npm run lint # Run ESLint check
npm run typecheck # Run TypeScript type check
npm run test:coverage # Run Jest coverage report
npm run ci # Run full frontend CI check (lint + typecheck + test)
```
### 🐍 Agent (Backend)
```bash
cd agent
.venv/bin/ruff check . # Lint python files using Ruff
.venv/bin/mypy . # Typecheck python files using Mypy
pytest --cov # Run pytest with coverage report
```
## 📁 Project Structure
```
suture/
├── agent/ # Python FastAPI agent (webhook listener, schema differ, Gemini reasoner)
├── dashboard/ # Next.js 16 App Router (status dashboard, schema diff viewer)
├── docs/ # README assets (hero, screenshots)
├── scripts/ # Demo scripts (seed, break, verify)
├── data/ # Deterministic test fixtures (Salesforce schemas)
├── db/ # Supabase schema (pipelines, incidents, config)
├── .github/ # CI workflows
└── README.md # You are here
```
## 📄 License
[MIT](LICENSE) © 2026 Edy Cu
## 🙏 Acknowledgments
Built for Google Cloud Rapid Agent Hackathon 2026. Thank you to Fivetran and Google Cloud for the APIs and tools.