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.
- 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 Evo Agent Specs (EASD), 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 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.debWebBridge is an optional browser companion distributed separately in the evo-webbridge repository.
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-desktopmake 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.
The README stays intentionally high-level. Detailed contracts and guides live
under documents/:
- Documentation index
- EASD methodology
- Evo Agent Specs guide
- Agent Plugins guide
- Coding architecture
- Development guide
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.
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
Issues and pull requests are welcome. Keep changes focused and include the smallest relevant test run. Report vulnerabilities privately through GitHub Security Advisories.
EvoFlux is released under the Apache License 2.0.