Content
<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.
[](LICENSE)
[](desktop/)
[](pyproject.toml)
[](desktop/)
**[Website](https://evoelsewhere.asia/)** · **[Download](#download)** ·
**[Run from source](#run-from-source)** · **[Documentation](#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](https://github.com/evoelsewhere/evoflux/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:
```sh
sudo apt install ./EvoFlux_*_amd64.deb
```
WebBridge is an optional browser companion distributed separately in the
[evo-webbridge repository](https://github.com/evoelsewhere/evo-webbridge).
## Run from source
### Requirements
- Python 3.12+
- [uv](https://docs.astral.sh/uv/)
- [Bun](https://bun.sh/)
- Rust and the [Tauri CLI](https://v2.tauri.app/start/prerequisites/)
- Tauri prerequisites for your operating system
### Setup
```sh
git clone https://github.com/evoelsewhere/evoflux.git
cd evoflux
uv sync
cd web && bun install && cd ..
```
Start the development app with:
```sh
# 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/`](documents/):
- [Documentation index](documents/README.md)
- [Agent Plugins guide](documents/guides/agent-plugins.md)
- [Coding architecture](documents/architecture/)
- [Development guide](documents/development/README.md)
## Architecture at a glance
```text
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
```text
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](LICENSE).
MCP Store