Repolode
TokenRhythm

TokenRhythm/opensquilla

一个注重 Token 效率的微内核 AI Agent,支持 CLI、Web UI 和聊天渠道,按任务把请求路由到够用的最低成本模型。

可替代:ChatGPT

Star
7,081
Fork
583
未关闭 Issue
271
最近提交
2小时前

这是什么?

OpenSquilla 是一个可在本地运行、对接多家大模型服务商的 AI Agent。内置的本地路由器 SquillaRouter 会根据输入长度、语言、代码、关键词和语义向量对每轮对话分类,再交给能胜任的最低成本模型处理。分类在本机完成,做路由决策时提示词不会离开设备。

Web UI、CLI 以及 Telegram、Slack、Discord、飞书、钉钉、企业微信、Matrix、QQ 等聊天渠道共用同一个对话循环,工具调度、重试和日志行为保持一致。长期记忆由 MEMORY.md 和基于 SQLite 的全文与语义检索组成;工具执行在 Linux 上使用 Bubblewrap,macOS 上使用 Seatbelt,Windows 上使用原生后端做沙箱隔离。

项目还支持按需加载的技能、MCP 客户端与服务端、基于 SQLite 的会话存储、定时任务调度,并提供从 OpenClaw 或 Hermes Agent 迁移状态的命令。它以 Python 包发布,同时提供 macOS 和 Windows 桌面安装包。

核心功能

  • 01借助本地 LightGBM 与 ONNX 分类器,把每轮对话路由到能胜任的最低成本模型。
  • 02支持 20 多家大模型服务商,包括 OpenAI、Anthropic、Ollama、OpenRouter 和 DeepSeek。
  • 03Web UI、CLI 与聊天渠道共享同一套对话循环。
  • 04本地长期记忆支持关键词与语义向量检索。
  • 05工具运行在分层沙箱中,提供标准、严格和锁定三档策略。
  • 06内置网页搜索、文件与 Shell 工具,并支持 MCP 客户端与服务端。

适用场景

  • 通过把简单请求交给低价模型来降低大模型 API 开支。
  • 在本地部署个人助手,并通过 Telegram、Slack 等聊天应用对话。
  • 将 Agent 会话暴露给其他 MCP 客户端,用于自动化工作流。
  • 把已有的 OpenClaw 或 Hermes Agent 配置迁移到新的本地 Agent。

快速上手

  1. 1

    安装 uv(Linux/macOS:运行 README 中的官方安装脚本)

  2. 2

    使用 uv 从发布版 wheel 安装 OpenSquilla

    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"
  3. 3

    配置 OpenSquilla

    opensquilla onboard
  4. 4

    启动网关

    opensquilla gateway run

使用前须知

  • 默认安装会引入 ONNX Runtime、LightGBM 等较重的路由依赖,首次安装下载量较大。
  • 在 Windows 和 macOS 上,路由器可能需要快速终端安装不会提供的系统原生库(Visual C++ 运行库或 libomp)。
  • 从源码构建需要 Git LFS 以及 Node.js 22.12+ 和 npm。

标签

常见问题

opensquilla 是什么?
一个注重 Token 效率的微内核 AI Agent,支持 CLI、Web UI 和聊天渠道,按任务把请求路由到够用的最低成本模型。 OpenSquilla 是一个可在本地运行、对接多家大模型服务商的 AI Agent。内置的本地路由器 SquillaRouter 会根据输入长度、语言、代码、关键词和语义向量对每轮对话分类,再交给能胜任的最低成本模型处理。分类在本机完成,做路由决策时提示词不会离开设备。
opensquilla 可以免费使用吗?用的什么许可证?
opensquilla 以 Apache-2.0 许可证开源。用于商业产品前,请先确认许可证条款。
opensquilla 还在维护吗?
活跃维护中。opensquilla 最近一次提交是在 2026年10月22日。
opensquilla 适合用来做什么?
通过把简单请求交给低价模型来降低大模型 API 开支。 在本地部署个人助手,并通过 Telegram、Slack 等聊天应用对话。 将 Agent 会话暴露给其他 MCP 客户端,用于自动化工作流。 把已有的 OpenClaw 或 Hermes Agent 配置迁移到新的本地 Agent。
opensquilla 怎么安装和运行?
安装 uv(Linux/macOS:运行 README 中的官方安装脚本) 使用 uv 从发布版 wheel 安装 OpenSquilla: 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" 配置 OpenSquilla: opensquilla onboard 启动网关: opensquilla gateway run
在哪里获取 opensquilla?
源代码和安装说明在 GitHub 上:https://github.com/TokenRhythm/opensquilla

概要由 AI 根据项目 README 生成;GitHub 数据每日更新。

相关项目