Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
48 commits
Select commit Hold shift + click to select a range
84b7138
Fix AI workflow generation: linear flow logic, graph connections, fro…
Jan 27, 2026
e0a077a
Fix Simulation 500 Error: Pass text properly to engine, add robust in…
Jan 27, 2026
579a23f
feat: integrate google sheets backend and refine frontend animations
Jan 29, 2026
bca6780
Updated backend services, landing page, sheets integration, deploy pa…
Jan 30, 2026
b51c7c0
fix: updated landing UI and added system architecture doc
SIBAM890 Feb 8, 2026
b4e39bb
Update README.md
SIBAM890 Feb 8, 2026
eac11ba
Update system architecture diagram connections
SIBAM890 Feb 8, 2026
9b784f5
Clean up system architecture diagram
SIBAM890 Feb 8, 2026
7f97254
Remove high-level overview and diagram sections
SIBAM890 Feb 8, 2026
8d44d8f
Enhance SYSTEM_ARCHITECTURE.md with diagram and headers
SIBAM890 Feb 8, 2026
075bb0d
Delete AutoFlow System Architecture details
SIBAM890 Feb 8, 2026
daacb69
Enhance SYSTEM_ARCHITECTURE.md with detailed sections
SIBAM890 Feb 8, 2026
65c218f
Refactor system architecture diagram syntax
SIBAM890 Feb 8, 2026
99107f6
docs: update README with detailed system architecture and add archite…
SIBAM890 Feb 9, 2026
54ed2cd
docs: add detailed message processing workflow diagram to README and …
SIBAM890 Feb 9, 2026
475f093
Remove unnecessary list_model.py
SIBAM890 Feb 9, 2026
128f0ee
Updated backend and frontend components
SIBAM890 Feb 11, 2026
5c5361e
Removed landing files and updated workflow graph
SIBAM890 Mar 13, 2026
0c3787d
Refactor project structure: replaced autoflow-backend/frontend with m…
SIBAM890 Mar 14, 2026
7cf93a0
feat(architecture): Complete Phase D and E orchestration, docs, and s…
SIBAM890 Mar 14, 2026
52a1990
fix(backend): fix database import error in main.py
SIBAM890 Mar 14, 2026
2305f0e
fix(whatsapp-bridge): handle stale chromium singleton lock on restart
SIBAM890 Mar 14, 2026
eed9733
fix(whatsapp-bridge): recursive delete of singleton locks
SIBAM890 Mar 14, 2026
9798f35
fix(builder): resolve ReactFlow infinite loop & optimize docker compose
SIBAM890 Mar 15, 2026
8010bd8
Update backend, docker config and ROI dashboard improvements
SIBAM890 Mar 15, 2026
16fdf5e
docs: comprehensive README.md and SYSTEM_ARCHITECTURE.md rewrite
SIBAM890 Mar 16, 2026
03e2650
fix: prevent WhatsApp bridge crash and increase Ollama timeouts for C…
SIBAM890 Mar 16, 2026
c37aa21
feat(builder): restore original Builder UI with AI chat sidebar, TopB…
SIBAM890 Mar 17, 2026
87063fc
feat(builder): add Toolbox sidebar on Customization Mode toggle with …
SIBAM890 Mar 17, 2026
a06c4ab
perf: switch to qwen3:1.7b for fast CPU inference, fix WhatsApp retry…
SIBAM890 Mar 17, 2026
c5fa5f1
refactor(whatsapp): replace whatsapp-web.js+Chromium with Baileys (no…
SIBAM890 Mar 17, 2026
24d7ddd
fix: add git to whatsapp-bridge Dockerfile (baileys npm dep needs it)
SIBAM890 Mar 17, 2026
cc49511
fix(whatsapp): use official baileys package, add exponential backoff,…
SIBAM890 Mar 17, 2026
42bc1d9
fix: upgrade whatsapp-bridge to Node 20 (baileys deps require >=20)
SIBAM890 Mar 17, 2026
cb27401
chore(frontend): keep original hero and remove hero-2 experiment
shayannab Mar 17, 2026
7db7243
chore(git): ignore backend local sqlite database
shayannab Mar 17, 2026
0c7ad16
fix(whatsapp): clear corrupt session on 405 error (incompatible auth …
SIBAM890 Mar 18, 2026
3d56116
fix(whatsapp): resolve EBUSY error when clearing auth directory (dock…
SIBAM890 Mar 18, 2026
fc02de7
landing page ver1
shayannab Jan 26, 2026
703a3be
final v1
shayannab Jan 28, 2026
9af800b
edited readme
shayannab Mar 9, 2026
4e8d2fa
feat: add unified-frontend with Studio builder, collapsible panels, p…
shayannab Mar 19, 2026
655799e
updated previous logic
SIBAM890 Mar 19, 2026
9152e0a
Restructure project and update frontend/backend code
SIBAM890 Mar 19, 2026
b06d304
Restructure project and update frontend
SIBAM890 Mar 19, 2026
fae5da6
Update frontend structure and migrate files
SIBAM890 Mar 19, 2026
584ee89
feat: upgrade README, backend logic, workflows, and docker setup
SIBAM890 Apr 10, 2026
558acc3
Removed autoflow backend files
SIBAM890 Apr 10, 2026
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 6 additions & 0 deletions .gitignore
Original file line number Diff line number Diff line change
Expand Up @@ -47,3 +47,9 @@ tmp/
temp/
auth_info_baileys/
backend/auth_info_baileys/
whatsapp-session/
data/autoflow.db
data/*.db
data/*.sqlite
data/*.sqlite3
backend/autoflow.db
200 changes: 133 additions & 67 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,98 +1,164 @@
# ⚡ AutoFlow AI
# ⚡ AutoFlow AI: The Intelligent Agentic Ecosystem

**The Intelligent AI Agent Builder for Everyone.**
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![FastAPI](https://img.shields.io/badge/Backend-FastAPI-009688?logo=fastapi&logoColor=white)](https://fastapi.tiangolo.com/)
[![React](https://img.shields.io/badge/Frontend-React-61DAFB?logo=react&logoColor=black)](https://reactjs.org/)
[![WhatsApp](https://img.shields.io/badge/Bridge-WhatsApp-25D366?logo=whatsapp&logoColor=white)](https://github.com/pedroslopez/whatsapp-web.js/)
[![LLM](https://img.shields.io/badge/AI-Gemini%20%2F%20Ollama-blueviolet)](https://ai.google.dev/)

AutoFlow AI is a powerful, low-code platform that allows you to build, visualize, and deploy AI automation agents effortlessly. It combines a state-of-the-art **React-based Visual Builder** with a robust **Node.js + Google Gemini AI Backend**.
**AutoFlow AI** is a professional, low-code platform designed to build, visualize, and deploy autonomous AI agents. By combining a futuristic visual builder with a robust multi-service architecture, AutoFlow enables anyone to create complex automation workflows powered by Google Gemini and local LLMs (via Ollama).

![AutoFlow Builder Screenshot](https://via.placeholder.com/800x450.png?text=AutoFlow+Builder+Preview)
---

## 🚀 Key Features
## 🌟 Key Features

- **🧠 Google Gemini Pro Integration**: Powered by the latest Gemini 1.5 Flash models for lightning-fast and cost-effective AI reasoning.
- **🎨 Professional Visual Builder**:
- **Dark Mode** infinite canvas.
- **Agent-Centric Topology**: All workflows centralized around your "AutoFlow Agent".
- **Dynamic Bezier Curves**: Smooth, professional connection lines.
- **🔌 100+ Integration Tools**: Pre-built nodes for WhatsApp, Gmail, Slack, Salesforce, Stripe, and more.
- **🛠️ Customization Mode**: Toggle between simple AI generation and advanced "Tech Mode" for manual fine-tuning.
- **💬 Natural Language to Workflow**: Just type "Create a WhatsApp bot for order tracking" and watch the AI build it for you.
- **🧠 Hybrid AI Intelligence**: Seamlessly switch between **Google Gemini 1.5 Pro** for cloud power and **Ollama (Qwen3:8B)** for local, private inference.
- **🎨 Professional Visual Builder**: An infinite-canvas editor built with React Flow, featuring agent-centric topology and dynamic Bezier connections.
- **🔌 Multi-Channel Connectivity**: Native bridge for **WhatsApp**, with upcoming support for Slack, Gmail, and Salesforce.
- **📊 Real-Time Analytics**: Built-in ROI dashboard and audit logs to track agent performance and decision-making history.
- **🛠️ Tech-Mode Customization**: Toggle between simple AI generation and advanced manual editing for granular control over tool nodes.
- **📦 Data-Driven Actions**: Integrated CSV/Spreadsheet support for inventory lookups, payment logging, and automated broadcasting.

---

## 🏗️ Project Structure
## 🏗️ System Architecture

AutoFlow is built on a high-performance microservice architecture, ensuring scalability and ease of deployment.

```mermaid
graph TB
subgraph "Frontend Layer (React + Vite)"
UI[Visual Builder UI]
State[Zustand Store]
Flow[React Flow Canvas]
end

subgraph "Backend Orchestrator (FastAPI)"
API[REST API Handlers]
Executor[Workflow Executor Engine]
DB[(SQLite / SQLModel)]
end

subgraph "AI & Intelligence"
Gemini[Google Gemini 1.5]
Ollama[Local Ollama Inference]
end

subgraph "Communication Bridge"
WA_Bridge[WhatsApp Bridge Node.js]
WA_Web[WhatsApp Web Protocol]
end

%% Connections
UI <--> API
API <--> Executor
Executor <--> DB
Executor <--> Gemini
Executor <--> Ollama
API <--> WA_Bridge
WA_Bridge <--> WA_Web
```

This is a monorepo containing both the frontend and backend:
---

\`\`\`
AutoFlow/
├── backend/ # Node.js Express Server + Gemini AI Logic
│ ├── src/
│ ├── server.js
│ └── .env (Required)
└── autoflow-frontend/ # React + Vite + Tailwind Builder
├── src/
└── package.json
\`\`\`
## 🔄 Agentic Workflow

The following diagram illustrates how messages are processed through the AutoFlow ecosystem:

```mermaid
sequenceDiagram
participant User as 👤 Customer (WhatsApp)
participant Bridge as 🔌 WhatsApp Bridge
participant Backend as ⚙️ Backend Executor
participant AI as 🧠 LLM (Gemini/Ollama)
participant Data as 📊 Inventory/CSV

User->>Bridge: Sends Inquiry ("Is sugar in stock?")
Bridge->>Backend: Forward Webhook (JSON)
Backend->>Backend: Match Active Workflow
Backend->>Data: Lookup Resource (inventory.csv)
Data-->>Backend: Return Data (Qty: 50)
Backend->>AI: Contextual Prompt (Data + Inquiry)
AI-->>Backend: Generated Response ("Yes, we have 50 units!")
Backend->>Bridge: Send Message Command
Bridge-->>User: Delivers WhatsApp Message
```

---

## 🛠️ Installation & Setup
## 🛠️ Technology Stack

### Prerequisites
- Node.js (v18 or higher)
- Google AI Studio API Key (Free Tier supported)
| Component | Technology |
| :--- | :--- |
| **Frontend** | React 18, Vite, TailwindCSS, React Flow, Zustand, Recharts |
| **Backend** | Python 3.11, FastAPI, SQLModel, Uvicorn |
| **Bridges** | Node.js, Express, WhatsApp-Web.js (Puppeteer) |
| **Database** | SQLite (Production-ready via SQLModel) |
| **AI/ML** | Google Gemini API, Ollama (Local LLM) |
| **Deployment** | Docker, Docker Compose |

### 1. Backend Setup

\`\`\`bash
cd backend
npm install
\`\`\`
---

Create a `.env` file in the `backend` folder:
\`\`\`env
GEMINI_API_KEY=your_google_ai_studio_key_here
PORT=3000
\`\`\`
## 📂 Project Structure

Start the server:
\`\`\`bash
node server.js
\`\`\`
*> Server runs on http://localhost:3000*
```text
AutoFlow/
├── autoflow-frontend/ # React + Vite Visual Builder
│ ├── src/ # UI Components & State Management
│ └── public/ # Static Assets
├── backend/ # FastAPI Orchestrator
│ ├── routers/ # API Endpoints
│ ├── executor.py # Workflow Traversal Engine
│ └── models.py # Database Schemas
├── whatsapp-bridge/ # Node.js WhatsApp WebSocket Bridge
│ ├── server.js # Express Webhook Handler
│ └── session/ # WhatsApp Auth States
├── data/ # Persistent SQLite DB & CSV Resources
└── docker-compose.yml # Multi-service Orchestration
```

### 2. Frontend Setup
---

Open a new terminal:
\`\`\`bash
cd autoflow-frontend
npm install
npm run dev
\`\`\`
*> Builder runs on http://localhost:5173*
## 🚀 Quick Start

---
### 1. Prerequisites
- Docker & Docker Compose
- Google AI Studio API Key (Optional, for Gemini support)

## 🎮 Usage Guide
### 2. Environment Setup
Create a `.env` file in the root directory:
```env
GEMINI_API_KEY=your_key_here
WHATSAPP_PORT=3001
BACKEND_PORT=8000
```

1. Open the **Builder** in your browser.
2. **Chat with AI**: Type a prompt like *"Build a customer support agent that handles refunds via email"*.
3. **Visualize**: The AI will instantly generate a star-topology workflow centered around your **AutoFlow Agent**.
4. **Customize**:
- Click **"Customization Mode"** (top right) to open the toolbox.
- Drag & Drop extra tools (Slack, Sheets, etc.) from the library of 100+ plugins.
- Connect them to the **Agent Node's** special bottom ports.
### 3. Launch the Ecosystem
```bash
docker-compose up --build
```
- **Builder UI**: `http://localhost:3000`
- **Backend API**: `http://localhost:8000`
- **WhatsApp Bridge**: `http://localhost:3001`

---

## 🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.
We welcome contributions! Please fork the repository and submit a pull request for any features or bug fixes.

1. Fork the Project
2. Create your Feature Branch (`git checkout -b feature/AmazingFeature`)
3. Commit your Changes (`git commit -m 'Add some AmazingFeature'`)
4. Push to the Branch (`git push origin feature/AmazingFeature`)
5. Open a Pull Request

---

## 📄 License

This project is open-source and available under the [MIT License](LICENSE).
Distributed under the MIT License. See `LICENSE` for more information.

---
*Built with ❤️ by [SIBAM890](https://github.com/SIBAM890)*
<p align="center">
Built with ❤️ by the AutoFlow Team
</p>
Loading