LocalFlow

LocalFlow is a local-first development workflow orchestration tool that empowers developers with parallel agentic capabilities without cloud lock-in. Built on the principle of agentic sovereignty, LocalFlow runs AI-powered workflows entirely on your local machine, orchestrating multiple agents in parallel to accelerate development tasks while maintaining complete control over your code and data.

In an era where AI coding is dominated by cloud-locked IDE extensions, LocalFlow provides a sovereign alternative — a high-performance, extensible hub for local agent workflows that respects your privacy and puts you in control.

• Zero Cloud Dependency — All processing happens locally; no data leaves your machine
• Offline-Capable — Works without internet connection for core workflows
• Data Sovereignty — Complete control over your codebase and agent interactions
• Fast Local Execution — Zero network latency, instant feedback loops

• Multi-Agent Parallelism — Run multiple AI agents simultaneously on different tasks
• Agent Discovery — Dynamic discovery and registration of available agents
• Mux (Multiplexer) — Intelligent routing and coordination of agent workflows
• Tool Integration — Extensible tool system for file operations, shell commands, and code manipulation
• LLM Integration — Pluggable LLM backend support

• Desktop Application — Native desktop app for workflow management
• Core Engine — Robust orchestration engine with task scheduling
• UI Components — React-based component library for building interfaces
• Zero-CSS Performance — Optimized rendering with minimal CSS overhead
• Docker Support — Containerized development and deployment

• Workflow Discovery — Auto-discover workflows and agents in your project
• Custom Workflows — Define and compose your own agentic workflows
• Task Parallelization — Automatically parallelize independent tasks
• Progress Tracking — Real-time monitoring of agent execution

• Node.js >= 18
• pnpm >= 9.0
• Docker (optional, for containerized development)

git clone https://github.com/yethikrishna/localflow.git
cd localflow

# Install dependencies
pnpm install

# Build all packages
pnpm build

# Start development
pnpm dev

# Start with docker compose
docker-compose -f docker-compose.dev.yml up

# Production
docker-compose -f docker-compose.prod.yml up -d

# Start the desktop app
pnpm dev:desktop

# Run a workflow
localflow run <workflow-name>

# List available agents
localflow agents list

# Orchestrate parallel tasks
localflow mux run --parallel task1 task2 task3

localflow/
├── apps/
│   └── desktop/                 # Desktop application
├── packages/
│   ├── core/                    # Core orchestration engine
│   ├── discovery/               # Agent & workflow discovery
│   ├── llm/                     # LLM integration layer
│   ├── mux/                     # Multiplexer for parallel agent routing
│   ├── tools/                   # Tool system (file, shell, code ops)
│   └── ui/                      # Shared UI component library
├── scripts/                     # Build & utility scripts
├── docs/                        # Documentation
├── research/                    # Research notes & experiments
├── Dockerfile                   # Production Dockerfile
├── Dockerfile.dev               # Development Dockerfile
├── docker-compose.yml           # Base Docker Compose
├── docker-compose.dev.yml       # Development Compose
├── docker-compose.prod.yml      # Production Compose
├── pnpm-workspace.yaml          # pnpm workspace config
├── turbo.json                   # Turborepo config
├── tsconfig.base.json           # Base TypeScript config
├── package.json                 # Root package config
├── LICENSE                      # MIT License
└── README.md                    # This file

docker-compose -f docker-compose.prod.yml up -d

pnpm build
pnpm --filter desktop start

Contributions are welcome! Please see CONTRIBUTING.md for guidelines.

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Run tests and linting (pnpm test && pnpm lint)
5. Submit a pull request

• Community Plan
• Discovery Strategy
• Recruitment Strategy
• Nexus 10 Year Plan

This project is licensed under the MIT License — see the LICENSE file for details.