evoflux

<div align="center"> <img src="documents/images/intro/evoflux-intro-preview.gif" width="800" alt="EvoFlux intro: agent teams, Computer App Control, and WebBridge" />

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.

Website · Download · Run from source · Documentation

</div>

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 from around 200 hosted, cloud, routed, or local providers, chosen per agent.
• Repository-aware Coding with code search, symbol relationships, LSP feedback, git workflows, and reviewable diffs.
• Computer App Control lets an agent operate one desktop app window on Windows or macOS through its accessibility tree, in the background, while you watch a live preview and approve each action.
• WebBridge lets agents work in your real Chrome or Edge, with your existing sign-ins, through a paired, policy-checked relay.
• Local control with inspectable history, permissions, sandboxing, and outbound secret and PII redaction.
• Memory, plugins, MCP, scheduling, and a built-in browser 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
• 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, coding tools, 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.