EvoFlux

A local-first desktop workspace for AI agent teams.

EvoFlux brings agent conversations, files, terminal, browser, git, and verification into one workspace. Use Work for general tasks and Coding for repository-aware development.

Download · Run from source · Documentation

Highlights

• Work and Coding modes for cowork tasks and persistent repositories.
• Lead-and-specialist teams with per-agent models, skills, tools, and permissions.
• Bring your own model through hosted, cloud, routed, or local providers.
• Repository-aware Coding with code search, symbol relationships, LSP feedback, git workflows, and reviewable diffs.
• Spec-first delivery through Agent Spec-Driven (ASDD), with user-approved specifications, verification, and evidence-based convergence.
• Local control with inspectable history, permissions, sandboxing, and outbound data protection.
• Memory, plugins, MCP, scheduling, and browser tooling are available as integrated workspace capabilities.

Download

Download the latest desktop release from GitHub Releases. Packages are available for macOS, Windows, and Linux. The desktop packages include the native Python sidecar.

Linux packages should be installed through the system package manager, for example:

sudo apt install ./EvoFlux_*_amd64.deb

WebBridge is an optional browser companion distributed separately in the evo-webbridge repository.

Run from source

Requirements

• Python 3.12+
• uv
• Bun
• Rust and the Tauri CLI
• Tauri prerequisites for your operating system

Setup

git clone https://github.com/evoelsewhere/evoflux.git
cd evoflux

uv sync
cd web && bun install && cd ..

Start the development app with:

# React UI + local API
make dev-web

# React UI + local API + Tauri desktop shell
make dev-desktop

make dev is an alias for make dev-web. EvoFlux is developed and shipped as a desktop product; the web development server is an internal development surface.

On first launch, connect a model provider, then start a Work session or open a repository in Coding mode.

Documentation

The README stays intentionally high-level. Detailed contracts and guides live under documents/:

• Documentation index
• ASDD methodology
• Evo Agent Specs guide
• Agent Plugins guide
• Coding architecture
• Development guide

Architecture at a glance

Tauri desktop shell
        ↓
React UI  ↔  local FastAPI sidecar
        ↓
local state, agent runtime, repositories, and model providers

The app keeps the main runtime and project state on the user's machine. Model providers are replaceable, while the harness handles context, tools, permissions, memory, and verification.

Project layout

app/        FastAPI sidecar, agents, code context, memory, scheduler, MCP
web/        React interface
desktop/    Tauri shell and Python sidecar packaging
seed/       Work and Coding blueprints, skills, and config
tests/      Backend and frontend tests
documents/  Architecture, feature contracts, guides, and records

Contributing

Issues and pull requests are welcome. Keep changes focused and include the smallest relevant test run. Report vulnerabilities privately through GitHub Security Advisories.

License

EvoFlux is released under the Apache License 2.0.