TokenRhythm/opensquilla

OpenSquilla – 节省 Token 的 AI 代理

它是什么 – OpenSquilla 是一个本地运行、微内核风格的 AI 代理，它将每次交互（turn）路由到能够处理请求的最便宜的 LLM。它结合了轻量级设备端模型路由器（SquillaRouter）、持久记忆、沙盒工具层、网络搜索和设备端嵌入，全部封装在一个单一对话循环中。同一个循环驱动桌面 GUI、CLI 以及各种聊天渠道集成。

主要功能

• 节省 Token 的路由 – 设备端路由器为每次对话选择最具成本效益的提供商（TokenRhythm、OpenRouter、OpenAI、Anthropic、Ollama、Gemini、Qwen 等）。
• 统一入口点 – CLI、基于 Electron 的桌面应用和聊天渠道机器人共享相同的工具分发、重试逻辑和日志记录。
• 可插拔提供商层 – 无需代码更改即可支持 20 多个 LLM 后端。
• 内置工具 – 持久记忆、沙盒执行、网络搜索和本地嵌入。
• 可扩展渠道 – 开箱即用支持飞书、Telegram、钉钉、QQ、企业微信、Slack、Discord；可选 Matrix 和 Matrix-E2E 扩展。
• 隐私感知遥测 – 可选网络报告，带有一个硬关闭开关。

安装选项

路径	适用对象	安装方式
桌面安装程序（macOS ARM、Windows x64）	想要即用 GUI 的用户	从 GitHub 发布页面下载 .dmg 或 .exe，然后拖拽/运行。
快速终端安装	任何操作系统上偏好单命令的最终用户	uv tool install --python 3.12 "opensquilla[recommended] @ https://github.com/TokenRhythm/opensquilla/releases/download/v0.5.6/opensquilla-0.5.6-py3-none-any.whl"
从源码安装	想要最新 main 分支或检查代码的用户	使用 Git LFS 克隆，运行 scripts/install_source.sh（或 PowerShell 变体）。
从源码开发	贡献者	使用 uv sync --extra recommended --extra dev 并通过 uv run 运行命令。

典型工作流程

1. 运行入门向导：opensquilla onboard（设置配置和密钥）。
2. 启动网关：opensquilla gateway run。
3. 通过 CLI（opensquilla chat）、桌面 UI 或连接的聊天渠道进行交互。

成熟度 – 项目版本为 0.5.6（稳定版），具有 CI 测试、签名的 Windows 二进制文件，以及发表在 arXiv 和 aiXiv（2026）上的技术报告。它提供生产就绪的安装程序和文档化的卸载过程。

许可证 – Apache 2.0。

引用 – 如果您引用 OpenSquilla，请引用技术报告：

OpenSquilla: Token-Efficient AI Agent, TokenRhythm, 2026.
arXiv:2607.11399 (Agentic Routing: The Harness-Native Data Flywheel)

了解更多 – 完整产品指南（README.product.md）、API 文档（docs/）和隐私政策（PRIVACY.md）。