flowly

<div align="center"> <img src="assets/banner.png" alt="Flowly — 您的个人 AI 代理，适用于您工作的每个地方" width="100%"> <p> <a href="https://pypi.org/project/flowly-ai/"><img src="https://img.shields.io/pypi/v/flowly-ai?style=for-the-badge&label=pypi&color=7C5CFC" alt="PyPI"></a> <img src="https://img.shields.io/badge/python-≥3.11-3776AB?style=for-the-badge&logo=python&logoColor=white" alt="Python"> <img src="https://img.shields.io/badge/macOS%20·%20Linux%20·%20Windows-14181F?style=for-the-badge" alt="平台"> <a href="LICENSE"><img src="https://img.shields.io/badge/license-Apache%202.0-3B82F6?style=for-the-badge" alt="许可证"></a> </p> </div> **Flowly 是一款开源的 AI 代理，运行在您的机器上，与您已经使用的每个渠道相连，并且随着您使用时间的增加而变得更好。** 一个共享内存，一个技能库，您自己的 LLM 密钥。它在对话中记住，维护并随着时间推移而改进自己，调度自己的工作，并与任何支持 [MCP](content/docs/features/mcp.md) 的系统连接 — 无论是 $5 的 VPS，Mac mini 还是您面前的笔记本电脑。 <div align="center"> <img src="assets/demo-tui.png" alt="Flowly 终端 UI" width="80%"> <br><br> <img src="assets/demo-desktop.gif" alt="Flowly 桌面版" width="80%"> <br><br> <img src="assets/demo-mobile.gif" alt="Flowly 在 iOS 和 Android 上" width="80%"> </div> <div align="center"> <img src="assets/diagram.png" alt="渠道 → Flowly 核心 → 您的 LLM 提供商（BYOK）或 Flowly Cloud" width="100%"> </div> --- ## 快速开始 ```bash # 安装 — 一条命令设置 uv、Python 和 Flowly curl -fsSL https://useflowlyapp.com/install.sh | bash # （已经使用 uv 管理工具？`uv tool install flowly-ai`） # 首次设置 — 选择 LLM 提供商，添加任意渠道 flowly setup # 开始聊天（裸 `flowly` 打开终端 UI） flowly ``` `flowly setup` 将引导您选择提供商（OpenRouter、Anthropic、OpenAI、Gemini、Groq、xAI/Grok、Zhipu 或本地模型）和您要的任意渠道。两分钟即可完成。添加 Telegram 机器人？`flowly setup` → Telegram → 粘贴令牌。网关在您保存时热重载每个渠道。 --- ## 内部功能 <table> <tr> <td width="30%"><b>一个代理，多个渠道</b></td> <td>终端 TUI · Telegram · Discord · Slack · Microsoft Teams · WhatsApp · iMessage · 电子邮件 · 语音。一个单一的网关进程与所有这些渠道通信，共享一个对话内存。原生 Mac / iOS / Android 应用和浏览器扩展通过 <a href="https://useflowlyapp.com">Flowly Cloud</a>（可选）提供。</td> </tr> <tr> <td><b>40+ 高级工具</b></td> <td>工作空间沙盒文件 I/O 和允许列表 shell，具有每个命令的批准；网页搜索 + 页面获取 + 实时 X/Twitter；macOS 计算机使用（无障碍控制，截图，浏览器标签 + 剪贴板）；PDF/DOCX/XLSX/PPTX，图像生成，<code>video_analyze</code>；Linear，Trello，Home Assistant 和 Google Workspace（日历，联系人，驱动器，任务）。</td> </tr> <tr> <td><b>封闭的学习循环</b></td> <td>您分享的每个事实都成为一个<b>受控内存</b>，具有校准的信任分数 — 👍/👎 以重新调整它，并且后台合并过程合并重复项并淘汰过时的笔记。结构化事实还存储在 <b>知识图谱</b> 中。选择加入后，Flowly 会挖掘您的重复过程以<b>编写和完善其自己的技能</b>，每次更改都快照且可逆。→ <a href="docs/memory-governance-architecture.md">内存</a> · <a href="docs/skill-self-improvement-architecture.md">技能</a></td> </tr> <tr> <td><b>135 内置技能</b></td> <td>此外还有技能 <b>包</b>（一个按键启用整个堆栈）和 Markdown 技能。兼容开放的 <a href="https://agentskills.io">agentskills.io</a> 标准。</td> </tr> <tr> <td><b>委托和并行化</b></td> <td>为并行工作流创建隔离的子代理（<code>delegate</code>，<code>spawn</code>），运行跨渠道的 <b>任务板</b>（顺序或并行，<a href="content/docs/features/board.md">任务板文档</a>），并将重型编码交给本地的 <b>Codex</b> 会话（选择加入）。</td> </tr> <tr> <td><b>MCP，双向</b></td> <td>连接任意 <a href="content/docs/features/mcp.md">MCP</a> 服务器（<code>flowly mcp install …</code>）<i>和</i> 将 Flowly 本身作为 MCP 服务器运行（<code>flowly mcp serve</code>），适用于 Claude Desktop、Cursor 或 Claude Code。</td> </tr> <tr> <td><b>定时和无人值守</b></td> <td>内置 <b>cron</b> — 调度任意自然语言提示并将结果交付到任意渠道。以守护进程方式运行网关，重启后仍可生存。</td> </tr> <tr> <td><b>您可以扩展和包含</b></td> <td>完整的 Python <b>插件</b>（工具，斜杠命令，渠道，生命周期钩子 → <a href="content/docs/features/plugins.md">插件</a>），可切换的 <b>角色</b>，和 <b>沙盒</b>（macOS <code>sandbox-exec</code>，Linux <code>bwrap</code>；选择退出 <code>FLOWLY_SANDBOX=0</code>）。</td> </tr> </table> --- ## 提供商 — 自带密钥 适配器适用于 **[OpenRouter](https://openrouter.ai)、[Anthropic](https://www.anthropic.com)、[OpenAI](https://openai.com)、[Google Gemini](https://ai.google.dev)、[Groq](https://groq.com)、[xAI / Grok](https://x.ai)、[Zhipu / GLM](https://z.ai)**，任意 **OpenAI 兼容的本地模型**（[Ollama](https://ollama.com)、[LM Studio](https://lmstudio.ai)、[vLLM](https://github.com/vllm-project/vllm)），以及托管的 **Flowly Cloud** 选项。登录 xAI 时，您可以使用 **SuperGrok / X Premium+** 订阅代替 API 密钥。随时切换： ```bash flowly # 打开聊天 /provider openrouter # 选择提供商 /model anthropic/claude-sonnet-4-6 ``` 或编辑 `~/.flowly/config.json`。当没有固定时，Flowly 会通过您配置的任意模型（OpenRouter → Anthropic → OpenAI → xAI → …）进行级联，因此它始终有一个可用的模型。 --- ## CLI 与消息 — 快速参考 两个入口点：使用 `flowly` 启动终端 UI，或运行网关并通过 Telegram、Discord、Slack、WhatsApp、iMessage 或电子邮件与 Flowly 聊天。一旦进入对话，大多数斜杠命令在两个界面中都相同。 | 操作 | 终端（TUI） | 消息渠道 | |---|---|---| | 开始聊天 | `flowly` | `flowly setup` → 添加渠道，然后给您的代理发送消息 | | 新建 / 重置对话 | `/new` | `/new` | | 更改模型 / 提供商 | `/model`，`/provider` | `/model`，`/provider` | | 切换角色 | `/persona [name]` | `/persona [name]` | | 浏览和运行技能 | `/skills` 或 `/<skill>` | `/<skill>` | | 检查 / 修正内存 | `/memory`，`flowly memory list` | `/memory` | | 会话和历史 | `/sessions` | `/sessions` | | 中断当前工作 | `Ctrl+C` 或发送消息 | `/stop` 或发送消息 | --- ## 自托管或云 Flowly 的代理核心是 **Apache 2.0**。在您的笔记本电脑、VPS 或 Mac mini 上自托管 — 您的密钥，您的数据，您的机器。**此仓库中的所有内容都无需 Flowly 帐户即可使用。** → [自托管指南](content/docs/using-flowly/self-hosting.md) · [开源 vs. 桌面版/云](content/docs/using-flowly/desktop-vs-oss.md) 可选的 [Flowly Cloud](https://useflowlyapp.com) 添加了原生 Mac/iOS/Android 应用，跨设备同步，托管的 LLM 访问，以及一个托管的中继，当您的笔记本电脑睡眠时，该中继使您的代理保持可访问。登录是可选的（`flowly login`），并且仅影响云功能；代理保持不变。 --- ## 常用命令 ```bash flowly # 终端聊天（TUI） flowly setup # 交互式向导（LLM，渠道，集成） flowly agent -m "..." # 一次性提示 flowly service install --start # 以守护进程方式运行网关 flowly restart # 智能重启（launchd / systemd / Task Scheduler） flowly doctor # 诊断配置 + 运行时健康状况 flowly memory list # 检查 / 修正长期内存 flowly skill mine --dry-run # 预览自我改进的技能（选择加入子系统） flowly mcp install <name> # 从目录添加 MCP 服务器 flowly mcp serve # 将 Flowly 暴露为 MCP 服务器 flowly login / logout # Flowly Cloud 帐户（可选） ``` 其他命令组：`flowly channels · cron · plugins · skills · bundles · persona · codex · xai · sessions · approvals · pairing`。完整参考：`flowly --help`。 --- ## 架构 <div align="center"> <img src="assets/architecture.png" alt="Flowly 架构：客户端 → 网关（在沙盒中运行）→ 您的 LLM 提供商" width="100%"> </div> 网关作为本地守护进程运行，**整个进程在 OS 沙盒中运行**（macOS 上的 `sandbox-exec`，Linux 上的 `bwrap`）。渠道通过进程内消息总线路由；TUI、桌面和移动应用作为客户端通过 WebSocket 协议（`ws://127.0.0.1:18790`）连接；桌面和移动应用也可以通过 Flowly Cloud 中继远程访问。配置存储在 `~/.flowly/config.json` 中，由每个客户端共享。→ [内部 RPC 协议](docs/internal-gateway-rpc-architecture.md) --- ## 安装路径 | 方法 | 命令 | 何时 | |---|---|---| | 安装脚本 | `curl -fsSL https://useflowlyapp.com/install.sh \| bash` | 推荐 — 设置 uv、Python、Flowly、PATH | | `uv tool` | `uv tool install flowly-ai` | 如果您已经使用 uv 管理工具 | | 源代码 | `git clone … && pip install -e ".[dev]"` | 贡献者 | 安装后，运行 `flowly setup`。要在没有打开终端会话的情况下运行： ```bash flowly service install --start # launchd（macOS）/ systemd（Linux）/ Task Scheduler（Windows） ``` 它在重启和终端关闭后仍然存活。 --- ## 文档 **完整文档：** [useflowlyapp.com/docs](https://useflowlyapp.com/docs) — 可搜索，包含以下所有内容。Markdown 源文件位于 [`content/docs/`](content/docs)。 - [MCP](content/docs/features/mcp.md) — 连接外部 MCP 服务器 + 将 Flowly 作为 MCP 服务器运行 - [插件](content/docs/features/plugins.md) — 使用自定义工具、钩子、命令、技能扩展 Flowly - [任务板](content/docs/features/board.md) — 跨渠道任务板（顺序 + 并行代理） - [自托管](content/docs/using-flowly/self-hosting.md) — 在您自己的机器或 VPS 上运行 Flowly - [开源 vs. 桌面版和云](content/docs/using-flowly/desktop-vs-oss.md) — 此仓库中有什么 vs. 应用 - [安全](SECURITY.md) — 信任模型 + 漏洞报告 - [贡献](CONTRIBUTING.md) — 开发设置、项目布局、PR 流程 - **工程深入解析：** [内存治理](docs/memory-governance-architecture.md) · [技能自我改进](docs/skill-self-improvement-architecture.md) · [内部网关 RPC](docs/internal-gateway-rpc-architecture.md) --- ## 社区 - 🐛 [问题](https://github.com/Nocetic/flowly/issues) — 错误和功能请求 - 🌐 [useflowlyapp.com](https://useflowlyapp.com) — 应用、托管云和文档 - 📚 [agentskills.io](https://agentskills.io) — Flowly 所遵循的开放技能标准 --- ## 状态 Flowly 在 v1.x 时是开源的，在 v2 重写期间是封闭的，现在在 **Apache 2.0** 下重新开放。代理、40+ 工具、135 技能和此仓库中的每个渠道适配器都是与 Flowly 桌面版相同的代码 — 没有单独的“精简”构建。 活跃开发中。问题和 PR 欢迎。 --- ## 许可证 [Apache 2.0](LICENSE)。分叉、发布、嵌入。自托管使用您自己的 LLM 密钥不受限制。商业使用 *Flowly Cloud* 凭证（帐户 / 中继 / 网关令牌）受我们的 [可接受使用政策](https://useflowlyapp.com/terms#acceptable-use) 管辖 — 大致：仅通过官方 Flowly 客户端使用，而不是通过代理我们的订阅的自定义套接字。 --- ## 致谢 灵感来自 [Claude Code](https://github.com/anthropics/claude-code)（Anthropic）和更广泛的开源代理社区。由 [Nocetic Limited](https://useflowlyapp.com) 构建。