$git clone https://github.com/Onelevenvy/flockA desktop multi-agent harness built with Rust, Tauri, and React, powered by langgraph-rust.
| 1 | # Flock |
| 2 | |
| 3 | A desktop multi-agent harness built with Rust, Tauri, and React, powered by langgraph-rust. |
| 4 | |
| 5 | **Visual Workflow | Multi-Agent Harness | Built-in Agent | Safe Sandbox & VNC | Cross-Platform | Any API Key** |
| 6 | |
| 7 | English | [简体中文](docs/README_zh.md) |
| 8 | |
| 9 |  |
| 10 |  |
| 11 |  |
| 12 |  |
| 13 |  |
| 14 | |
| 15 | > **Note**: This project is built on top of [langgraph-rust](https://github.com/Onelevenvy/langgraph-rust), which is my personal Rust implementation of the LangGraph framework. |
| 16 | > |
| 17 | > **Refactoring History**: Flock has been completely rewritten from the ground up. The original version was a Python-based application using LangGraph, LangChain, and FastAPI as the backend. The current version is a native desktop application with a Rust backend, powered by Tauri for the desktop shell. This rewrite brings significant improvements in performance, reliability, and user experience. |
| 18 | > |
| 19 | > **Legacy Code**: The original Python codebase is preserved in the `legacy/python` branch for reference. |
| 20 | |
| 21 | --- |
| 22 | |
| 23 | ## 📋 Quick Navigation |
| 24 | |
| 25 | [Multi-Agent Harness & Workflow](#-multi-agent-harness--workflow) · [Core Features](#-core-features) · [Architecture](#-architecture) · [Quick Start](#-quick-start) |
| 26 | |
| 27 | --- |
| 28 | |
| 29 | ## 🤝 Multi-Agent Harness & Workflow — Visual Orchestration for AI Agents |
| 30 | |
| 31 | Flock is more than just a chat client. It's a comprehensive **multi-agent harness** combined with a powerful **Visual Workflow Editor**. It orchestrates and runs AI agents locally or inside sandbox containers to read/write files, execute bash commands, browse the web, and run complex pipelines. You see everything the agent does, and you're always in control. |
| 32 | |
| 33 | | Capability / Feature | Traditional Chat Clients | Flock (Multi-Agent Harness) | |
| 34 | | :--- | :---: | :---: | |
| 35 | | **Visual Workflow Builder** | No | **Yes** — ReactFlow editor with 10+ node types & streaming execution | |
| 36 | | **AI Operating on Files** | Limited or No | **Yes** — Built-in agent with full filesystem, grep, and glob access | |
| 37 | | **Multi-Step Autonomy** | No | **Yes** — Autonomous LangGraph-rust execution loop with approval prompts | |
| 38 | | **Scheduled Task Automation** | No | **Yes** — Native Cron scheduler for 24/7 unattended workflows | |
| 39 | | **Multi-Agent Collaboration** | No | **Yes** — Auto-detects & orchestrates multiple agents in team networks | |
| 40 | | **Open Source & Extensible** | Rarely | **Yes** — Free, built with Rust & Tauri, fully extensible | |
| 41 | |
| 42 | --- |
| 43 | |
| 44 | ## 🌟 Core Features |
| 45 | |
| 46 | ### 🕸️ Visual Workflow Editor (ReactFlow Engine) |
| 47 | * **Drag-and-Drop Canvas**: Design complex pipelines visually by connecting custom agent and logic nodes. |
| 48 | * **10 Node Types Shipped**: |
| 49 | * `start` & `answer`: Define workflow inputs and final delivery parameters. |
| 50 | * `llm` & `agent`: Pure inference nodes and tool-enabled LangGraph agents. |
| 51 | * `classifier` & `ifelse`: Semantic routing routers and conditional branch checkers. |
| 52 | * `code`: Custom JS/Python code runners to execute arbitrary transformations. |
| 53 | * `human`: Interactive interrupts asking for manual feedback or input. |
| 54 | * `plugin` & `parameter_extractor`: Expose custom tools/plugins and extract structured data. |
| 55 | * **Version Control & Execution History**: Easily manage multiple versions of your visual workflows, track historical execution paths, and debug states incrementally. |
| 56 | |
| 57 | ### 👥 Human-in-the-Loop (HITL) & Safe Interaction |
| 58 | * **Interactive Tool Approvals**: Crucial actions (like writing files, running bash scripts, or modifying configurations) require explicit user approval before execution. You can inspect the plan, approve, or deny on the fly. |
| 59 | * **VNC Screen Takeover**: Directly interact with sandboxed browser and OS interfaces. When the agent gets stuck on captchas, you can take over mouse/keyboard controls seamlessly. |
| 60 | * **Workflow Breakpoints (`human` node)**: Place m |