opensquilla

花同样的钱,让 AI 更聪明

OpenSquilla 是一个主打 Token 高效利用的 AI Agent 框架,旨在让同样的预算获得更高的智能密度。它通过优化上下文管理、记忆机制和技能调用,减少不必要的 Token 消耗,从而降低使用成本。核心能力包括模块化 Agent 设计、MCP 协议支持、持久记忆存储以及可扩展的技能库。项目基于 Python 构建,适合开发者快速搭建定制化的智能体应用,解决大模型推理成本高、响应慢的问题。

开源 unknown 智能体
访问官网 ↗ GitHub ↗ 文档 ↗
GitHub 星标 ★ 7045
维护状态 活跃
是否开源 是
定价模式 unknown

项目数据

分类智能体
开发团队TokenRhythm
所属国家
定价模式unknown
价格说明定价信息待确认
访问状态
是否开源是
开源协议Apache-2.0
主要语言Python
技术栈/模型agent,ai,ai-agents,deep-learning,foundation-models,llm,mcp,memory,openclaw,python,skills
GitHub 星标★ 7045
30天Star增速
HF 下载量
上线时间2026-05-06 00:00:00
最近更新2026-09-22 00:00:00
维护状态活跃
中文支持
访问方式
移动端支持
综合评分
收录时间2026-08-09
浏览次数2

使用教程

难度:入门 约 10 分钟 部署方式:命令行工具 7 步

环境要求

  • Python 3.12+(用 uv 安装时会自动管理 Python,无需系统 Python)
  • 操作系统:Windows、macOS 或 Linux
  • 首次安装需联网下载依赖(ONNX Runtime、LightGBM、NumPy、tokenizers 等)
  • 仅源码安装需要 Git + Git LFS 及 Node.js/npm(release wheel 与桌面版不需要)

安装与启动步骤

  1. 1安装 uv(Mac/Linux)

    用官方脚本安装 uv 工具链,它会把 OpenSquilla 装进独立环境并自带 Python。若 uv --version 已可用可跳过。

    curl -LsSf https://astral.sh/uv/install.sh | sh
    . "$HOME/.local/bin/env"
  2. 2安装 uv(Windows)

    Windows PowerShell 下安装 uv,安装后把 .localin 加入当前会话 PATH,避免找不到命令。

    powershell -c "irm https://astral.sh/uv/install.ps1 | iex"
    $env:Path = "$env:USERPROFILE.localin;" + $env:Path
  3. 3安装 OpenSquilla

    从 GitHub Release 拉取 0.5.4 wheel 并安装 recommended 附加依赖(含 SquillaRouter 运行时),首次安装需要联网。

    uv tool install --python 3.12 "opensquilla[recommended] @ https://github.com/TokenRhythm/opensquilla/releases/download/v0.5.4/opensquilla-0.5.4-py3-none-any.whl"
  4. 4初始化配置

    运行引导程序完成基础配置,按提示填写模型与渠道信息即可。

    opensquilla onboard
  5. 5启动网关

    启动 OpenSquilla gateway,即可通过 CLI、Web UI 与聊天渠道使用智能体。

    opensquilla gateway run
  6. 6桌面版安装(可选)

    macOS 下载 dmg 拖入应用程序;Windows 下载 exe 安装。安装包已内置 Vue 控制台,无需 Node.js。

  7. 7源码安装(可选)

    需 Git LFS 拉取模型资产,再运行官方安装脚本(内部会执行 npm ci/build 与 uv tool install)。

    git lfs install
    git clone https://github.com/TokenRhythm/opensquilla.git
    cd opensquilla
    git lfs pull --include="src/opensquilla/squilla_router/models/**"
    bash scripts/install_source.sh

如何确认成功

安装后终端能执行 opensquilla 命令;运行 opensquilla gateway run 后网关启动即成功。

常见问题

Q:安装完提示找不到 opensquilla 命令怎么办?

A:新开一个终端,或重新执行第 1 步中的 PATH 那行命令。源码安装可运行 uv tool update-shell 后再开新终端。

Q:为什么第一次安装要下载很多东西?

A:默认的 recommended extra 包含 SquillaRouter 运行时依赖(ONNX Runtime、LightGBM、NumPy、tokenizers 等),需联网拉取 wheel。

Q:可以跳过安装脚本直接 pip install . 吗?

A:README 明确说这是低层源码构建路径:本地 checkout 必须先构建好 Web UI 才能用,VCS URL 安装会被拒绝,建议用官方安装脚本或 release wheel。

Q:Windows 桌面版从 RC3 升级要注意什么?

A:不要先卸载 RC3,其卸载程序可能删除桌面用户数据;直接用新安装包覆盖安装,并提前备份 %APPDATA%OpenSquilla。

Q:SquillaRouter 报原生库加载错误怎么办?

A:uv 不安装系统原生运行时,macOS 需 libomp、Windows 需 Visual C++ Redistributable,详见 README 的 Troubleshooting。

注意事项

  • release wheel 与桌面安装包已内置 Vue 控制台,这类安装方式不需要 Node.js 或 npm。
  • Windows v0.5.4 官方安装包仍未签名,可能触发 SmartScreen,企业策略受限时可改用终端安装。
  • 源码安装每次重装都会重建 node_modules 并重新构建控制台,耗时与磁盘占用较高。
  • macOS 桌面版升级前先退出正在运行的应用,再将 DMG 中的 App 拖入「应用程序」。

核心亮点

  • Token 效率优化显著,实测可降低 30% 以上的调用成本
  • 模块化架构,支持 MCP 协议,易于集成现有工具链
  • 内置持久记忆系统,支持跨会话状态保持

不足之处

  • 文档/社区待观察
  • 尚处早期,生态和第三方集成较少

适用场景

  • 高并发客服机器人,需控制 API 成本
  • 长对话场景,如虚拟助手或教育陪练
  • 企业内部知识库问答,需记忆和技能扩展

替代项目

AutoGPT、LangChain、CrewAI

项目介绍

opensquilla 是智能体领域的开源项目,由 TokenRhythm 开发,是 2026 年新上线的项目。

在全站 13,090 个收录项目中,它的 GitHub 星标数(7,045)位列前 7%,在智能体分类的 2,517 个项目里位列前 7%。

近 41 天,它的 GitHub 星标从 6,560 增加到 7,045,净增 485。

项目目前处于活跃维护状态,最近一次代码更新于 2026-09-22。从国内网络环境看,可直接访问。

它主要面向的使用场景是:高并发客服机器人,需控制API成本。同类可对比的替代方案包括 AutoGPT、LangChain、CrewAI。

上一篇:lobu

下一篇:emilia-protocol

同类项目推荐

xinchao-dynamic-mind 开源

给 AI 装上疲惫和欲望,让交互更真实

独立、可自托管的 AI 动态心智状态引擎:驱动力、念头池、疲惫、睡眠与意图。

★ 199 2026-08-09
deepseek-harness 开源

把 AI 能力拆成乐高积木,拼出你的专属智能体。

DeepSeek Harness: Everything is a Plugin.

★ 233327 2026-08-15
AutoGPT 开源

开箱即用的 AI 员工,交代任务就自己干完

AutoGPT is the vision of accessible AI for everyone, to use and to build on. Our mis···

★ 187492 2026-08-09
EvoAgentX 开源

让 AI 智能体自己迭代变强,越用越聪明

EvoAgentX: Building a Self-Evolving Ecosystem of AI Agents

★ 3351 2026-09-12