evoelsewhere/evoflux

EvoFlux

一个面向 AI 智能体团队的本地优先桌面工作空间。

EvoFlux 将智能体对话、文件、终端、浏览器、git 和验证整合到一个工作空间中。使用 Work 处理通用任务，使用 Coding 进行仓库感知的开发。

License: Apache 2.0
Desktop app
Python 3.12+
Tauri v2

下载 · 从源码运行 ·
文档

亮点

- Work 和 Coding 模式，适用于协作任务和持久化仓库。
- 主导与专家团队，每个智能体拥有独立的模型、技能、工具和权限。
- 自带模型，支持托管、云端、路由或本地提供商。
- 仓库感知的 Coding，具备代码搜索、符号关系、LSP 反馈、git 工作流和可审查的差异。
- 规范优先交付，通过 Agent Spec-Driven（ASDD）实现，包含用户批准的规范、验证和基于证据的收敛。
- 本地控制，具备可检查的历史记录、权限、沙箱和出站数据保护。
- 记忆、插件、MCP、调度和浏览器工具作为集成的工作空间能力提供。

下载

从 GitHub Releases 下载最新的桌面版本。软件包适用于 macOS、Windows 和 Linux。桌面软件包包含原生 Python sidecar。

Linux 软件包应通过系统包管理器安装，例如：

sudo apt install ./EvoFlux_*_amd64.deb

WebBridge 是一个可选的浏览器伴侣，单独发布于
evo-webbridge 仓库。

从源码运行

要求

- Python 3.12+
- uv
- Bun
- Rust 和 Tauri CLI
- 适用于你操作系统的 Tauri 前置依赖

设置

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

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

使用以下命令启动开发应用：

React UI + local API
make dev-web

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

make dev 是 make dev-web 的别名。EvoFlux 作为桌面产品进行开发和发布；Web 开发服务器是内部开发界面。

首次启动时，连接一个模型提供商，然后启动一个 Work 会话或在 Coding 模式下打开一个仓库。

文档
README 有意保持在高层次。详细的契约和指南位于
documents/ 下：

- 文档索引
- ASDD 方法论
- Evo Agent Specs 指南
- Agent Plugins 指南
- 编码架构
- 开发指南

架构概览

Tauri 桌面外壳
↓
React UI  ↔  本地 FastAPI sidecar
↓
本地状态、agent 运行时、仓库和模型提供方

该应用将主运行时和项目状态保留在用户机器上。模型提供方是可替换的，而
harness 负责处理上下文、工具、权限、记忆和验证。

项目布局

app/        FastAPI sidecar、agents、代码上下文、记忆、调度器、MCP
web/        React 界面
desktop/    Tauri 外壳和 Python sidecar 打包
seed/       Work 和 Coding 蓝图、技能和配置
tests/      后端和前端测试
documents/  架构、功能契约、指南和记录

贡献

欢迎提交 issue 和 pull request。保持改动聚焦，并包含最小相关的测试运行。
请通过 GitHub Security Advisories 私下报告漏洞。

许可证

EvoFlux 在 Apache License 2.0 下发布。