Row-Bot
将本地模型、记忆与受控工具整合为可在个人设备上执行工作的桌面助手。
- Star 数
- ★ 1.7k
- 最近更新
- 今天
- License
- Apache-2.0
- 主语言
- Python
- FA 评分
- 59/100 · 缺口较多
30 秒速览
- 运行形态
- 可在哪里用
- 通用 · 跨平台ChatGPT · Codex · Claude.ai · OpenAI API · Claude APIClaude Code(部分支持)
- 费用
- 软件免费,模型调用费用自付
- 上手难度
- 中 · 需要几步配置
- 开始前需要
- 典型场景
- 需要在个人电脑上整理 PDF、表格和笔记的研究人员,可让 Row-Bot 提取内容、建立知识图谱,并在后续对话中进行本地召回。
- 不适合
- 需要多用户托管或租户隔离的团队,它只是单所有者多设备应用
- 需要 Linux 或后台运行 Computer Use 的用户,该功能仅限 Windows/macOS 交互式会话
- 源码审查
- 59/100 · 缺口较多
这个 Agent 能做什么,适合哪些场景?
Row-Bot 是一款本地优先的桌面 AI 助手,围绕“Reason、Orchestrate、Work”组织对话、模型、记忆和工具调用。它以 LangGraph ReAct agent 为执行核心,提供 Goal Mode、Agent Profiles 与子代理委派,并保留可见目标、审批和本地运行历史。应用包含个人知识图谱、文档提取、浏览器自动化、文件系统和 shell 操作、工作流、消息渠道,以及 Developer Studio 和 Designer Studio。默认情况下,持久化数据保存在本机;可使用 Ollama 本地模型,也可选择 OpenAI、Anthropic、Google AI、xAI、OpenRouter 和自定义 OpenAI 兼容端点。它可作为 Windows、macOS 和 Linux 桌面应用运行,也支持经认证的单所有者远程访问和 row-bot serve 服务器模式。
Row-Bot 通过 LangGraph ReAct agent 将当前对话、记忆召回和工具结果组合为一次受预算约束的执行。它可读取 PDF、CSV、Excel、JSON、JSONL、TSV 和图像文件,提取文档内容并写入带来源信息的知识图谱;也可使用 Tavily、DuckDuckGo、Wikipedia、arXiv、YouTube transcripts 和 URL reader 获取外部资料。它能在配置的工作区内执行文件系统和 shell 操作,使用可见 Chromium 浏览器自动化,或在 Windows/macOS 上经明确启用的 Cua Driver 使用原生 Computer Use。Developer Studio 可链接或克隆 Git 工作区、创建 worktree、查看 diff、运行测试并准备提交、推送和 PR;Designer Studio 可生成文档、演示文稿、落地页和导出文件。row-bot serve 提供受会话门控的浏览器访问,row-bot access invite 用于创建一次性设备邀请。
- 需要在个人电脑上整理 PDF、表格和笔记的研究人员,可让 Row-Bot 提取内容、建立知识图谱,并在后续对话中进行本地召回。
- 维护代码仓库的开发者,可在 Developer Studio 中链接或克隆仓库,使用独立 worktree 运行测试、查看 diff,并在审批后准备 Git 提交或 PR。
- 希望把重复任务自动化的个人用户,可创建带计划、webhook 或任务完成触发器的工作流,并设置条件、审批和通知。
- 需要在多个受信任设备上访问同一助手的单一所有者,可通过 Remote Access 邀请在浏览器、手机或平板访问本机正在运行的实例。
- 需要邮件、日历和消息渠道协作的用户,可在授权后使用 Gmail、Google Calendar、Telegram、WhatsApp、Discord、Slack 或 SMS 工具完成具体操作。
- 希望使用本地模型而不上传日常对话和记忆的用户,可通过 Ollama 配置本地推理,并仅在主动选择时接入云端模型或自托管端点。
如何安装或部署这个 Agent?
源码安装需要 Python 3.12+。如需本地模型,先安装 Ollama;仅使用云端或自托管模型时可跳过。执行:
git clone https://github.com/siddsachar/row-bot.git
cd row-bot
python -m venv .venv
source .venv/bin/activate
python -m pip install "uv>=0.7,<1.0"
uv sync --locked --all-extras --group test
uv run python launcher.pyWindows 激活环境使用 .venv\Scripts\activate。也可从 GitHub Releases 下载 Windows 安装程序或 macOS DMG;Linux 可执行 curl -fsSL https://raw.githubusercontent.com/siddsachar/row-bot/main/installer/install-linux.sh | bash。首次启动时在设置向导中选择 Ollama、本地/云端提供商或自定义 OpenAI 兼容端点;云端功能需要相应的 API key 或应用内 OAuth 登录。
如何使用这个 Agent?
启动后,在设置向导中选择模型路径:本地模式选择 Ollama 和模型;提供商模式填写如 OPENAI_API_KEY、ANTHROPIC_API_KEY 或其他已支持提供商的密钥;自托管模式填写兼容端点,例如 http://127.0.0.1:1234/v1。随后可直接提出任务,例如“Read report.pdf in my workspace”或“Run git status on my project”。较长任务可创建 Goal、选择 Agent Profile,再委派范围受限的子代理。无界面服务器模式可运行 uv run python launcher.py serve --port 8080,安装版使用 row-bot serve;再用 row-bot access invite --layout desktop --origin https://row-bot.example.com 创建一次性浏览器邀请。
这个 Agent 有哪些优点和局限?
- 本地优先:对话、知识图谱、工作流和设置默认保存在本机,且项目声明没有 Row-Bot 账户系统或自建推理中转服务。
- 模型选择覆盖 Ollama、本地兼容端点、多个 API 提供商,以及 ChatGPT/Codex、Claude Subscription 和 xAI Grok 的应用内登录路径。
- 从知识管理到 Git worktree、浏览器自动化、工作流和渠道消息,功能在一个桌面应用中由同一套目标、审批和执行预算机制协调。
- 远程访问采用单所有者会话门控、一次性邀请、可撤销设备会话和本地存储的哈希凭据,而不是开放式多租户托管。
- 本地模型需要安装 Ollama;README 对较强代理行为建议使用 14B 级模型,并建议 16–32 GB RAM 或合适 GPU,硬件成本可能较高。
- 云端模型、搜索、邮件、日历、消息和媒体生成依赖对应提供商密钥、OAuth 或网络连接,所选对话和工具上下文会发送到该端点。
- Computer Use 仍是默认关闭的 beta,仅支持交互式本地 Windows/macOS,需安装 Cua Driver 并授予系统权限;Linux 和后台场景不支持。
- 旧 Thoth 或早期 Row-Bot 用户不能直接依赖当前版本的自动品牌迁移,需先运行一个具备迁移功能的旧版 Row-Bot。
- 远程服务器、反向代理和 Docker 部署需要操作者自行配置 TLS、可信代理、备份、限流和防火墙。
这个 Agent 与同类方案有什么区别?
与只提供 Ollama 本地推理的使用方式相比,Row-Bot 还可接入多家云端与 OpenAI 兼容端点,并保留按提供商区分的模型能力和回退状态。与浏览器自动化相比,原生 Computer Use 面向本机 Windows/macOS 应用,但需要单独安装和授权,项目明确将浏览器自动化视为网站操作的首选路径。Docker Sandbox 则与直接在链接仓库中本地执行不同:它在影子工作区运行,只有明确导入后才会改变真实仓库。
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| Row-Bot 当前 | 59 · 缺口较多 | 桌面应用免费 + 模型费 | ★ 1.7k | 今天 | Python | ChatGPT · Codex · Claude.ai · OpenAI API · Claude API |
| Skales | 36 · 缺口较多 | 桌面应用免费版 + 付费版 | ★ 2.2k | 3 天前 | — | ChatGPT · OpenAI API · Claude API |
| TuriX | 34 · 缺口较多 | 命令行工具免费 + 模型费 | ★ 3.2k | 1 个月前 | Python | Claude.ai |
| TARS 多模态操作栈 | 30 · 缺口较多 | 命令行工具免费 + 模型费 | ★ 40k | 28 天前 | TypeScript | Claude API |
FollowAgents 如何评估这个 Agent?
查看各维度的扣分理由
证据显示:README 明确说明本地优先、数据默认留在本机,提供 OS 凭据存储和 Docker 加密卷,强调邀请/会话分离、可撤销会话、严格来源检查,以及可选的 Computer Use 需明确同意。扣分:依赖安全仅列出版本范围,未提供漏洞扫描或审计证据;回滚仅提及恢复工具,未提供具体机制;发布者身份未验证,来源归属仅基于仓库元数据。
证据显示:README 与 pyproject.toml 一致,CI 配置了多平台测试和依赖验证,测试文件包含防护措施防止写入真实用户状态。扣分:未提供失败消息的具体示例或错误处理文档,依赖可用性仅通过版本范围保证,未提供运行时验证。
证据显示:README 详细描述了多种使用场景(本地、提供商、自定义端点),明确列出能力边界(如 SMS 仅文本、Computer Use 默认关闭),提供触发示例(常见提示词),并支持多平台(Windows/macOS/Linux/Docker)。扣分:未提供详细的触发条件或环境配置要求,环境适配仅基于声明。
证据显示:README 结构清晰,提供安装说明、快速开始、远程访问指南,命名稳定(Row-Bot 前身 Thoth),有示例提示词,明确已知限制(如 SMS 仅文本、Computer Use 默认关闭),许可证为 Apache-2.0。扣分:未提供版本历史或变更日志,维护责任仅通过 SECURITY.md 和 CI 暗示,未明确维护者。
证据显示:README 描述输出为可用的报告、行动计划和设计,提供视频演示,强调本地优先和成本控制(可选云模型)。扣分:未提供性能基准或用户反馈,边际价值仅基于功能列表。
证据显示:README 中的功能声明与 pyproject.toml 依赖和 CI 测试部分对应,但未提供具体测试结果或独立验证。扣分:声明多为断言,缺乏可追溯的测试证据,事实与推断未明确区分。
- 发布者身份未验证,安装前应核实来源。
- 依赖安全未提供漏洞扫描或审计证据,建议检查依赖版本。
- 回滚机制仅提及恢复工具,未提供具体操作步骤。
- 版本历史或变更日志缺失,升级前需谨慎。
最近版本
来自该项目 GitHub Releases 的最新发布记录,说明为上游原文摘录,未经本站改写或测试。
-
v5.3.2 v5.3.2 - Videos That Look And Sound Right, A Calmer App
发布说明摘录
v5.3.2 - Videos That Look And Sound Right, A Calmer App Row-Bot 5.3.2 makes its videos look like a studio made them and never lets a silent one slip out, asks you less for the things you clearly asked for, and makes Home and Settings calmer. It comes from a week of using Row-Bot like you would, on Windows and a Mac, with ChatGPT and a model on this computer. From 5.3.1 it arrives through background updates. Videos - Made like a studio - a camera that follows what's done, the page framed on your brand's backdrop, titles as lit slides and lower thirds, captions a …在 GitHub 查看 ↗ -
v5.3.1 v5.3.1 - Real Work, Video, Linked Conversations & Waits
发布说明摘录
v5.3.1 - Real Work, Video, Linked Conversations & Waits Row-Bot 5.3.1 is about getting real work done. It follows the approval level you chose, with far fewer refusals. It can make and edit videos and talk to its other conversations. A chat or workflow can wait for something without using your plan, and Row-Bot tells you what it's doing as it works. From 5.3.0 it arrives through background updates: Settings › Updates offers Restart now. Read Upgrade Notes below before upgrading. New Since The Beta - Weekday schedules run on weekdays - a workflow set to "1-5" runs Monday …在 GitHub 查看 ↗ -
v5.3.0 v5.3.0 - A Browser In The App, Pages, Outlook & Reviewed Approvals
发布说明摘录
v5.3.0 - A Browser In The App, Pages, Outlook & Reviewed Approvals Row-Bot 5.3 puts its browser inside the app and rebuilds computer use. Row-Bot can make pages you work in beside the chat, ask you questions with options, and connect Outlook and several X accounts. Chats can be incognito, background work shows up at once, Auto approvals are reviewed and a new Hands-off level asks nothing. Row-Bot can run servers and long jobs in the background, edit video, send you files and work on code from any of your devices. Claude works with your …在 GitHub 查看 ↗