opensquilla

同预算下让 AI Agent 更聪明、更省 Token

OpenSquilla 是一个用 Python 编写的开源 AI Agent 框架，核心卖点是“Token 效率”——在相同预算下提供更高的智能密度。它面向需要构建自主智能体的开发者，通过优化上下文管理、记忆机制和技能调用，减少无效 Token 消耗，让 Agent 在长任务和多轮交互中保持低成本与高响应质量。项目集成 MCP 协议、技能系统与记忆模块，支持接入多种大语言模型和基础模型，可用于搭建能调用工具、维持长期记忆、执行复杂工作流的智能体。相比通用 Agent 框架，它更强调在有限 Token 预算内提升推理与执行效果，适合对成本敏感、又希望获得较强自主能力的应用场景。

开源 unknown 智能体

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 7017

维护状态活跃

是否开源是

定价模式 unknown

项目数据

分类智能体

开发团队TokenRhythm

所属国家

官网地址https://opensquilla.ai

GitHubhttps://github.com/TokenRhythm/opensquilla

定价模式unknown

价格说明定价信息待确认

访问状态

是否开源是

开源协议Apache-2.0

主要语言Python

技术栈/模型agent,ai,ai-agents,deep-learning,foundation-models,llm,mcp,memory,openclaw,python,skills

GitHub 星标★ 7017

30天Star增速

HF 下载量

上线时间2026-05-06 00:00:00

最近更新2026-09-16 00:00:00

维护状态活跃

中文支持

访问方式

移动端支持

综合评分

收录时间2026-09-12

浏览次数0

使用教程

难度：入门约 15 分钟部署方式：命令行工具 5 步

环境要求

Python 3.12+（使用 uv 安装时会自动管理 Python，无需系统 Python）
支持 Windows、macOS、Linux
首次安装需要网络访问，以下载 release wheel 及 ONNX Runtime、LightGBM、NumPy、tokenizers 等依赖
若选择源码安装：需要 Git、Git LFS 和 Node.js/npm 环境
若选择桌面版：macOS Apple Silicon 或 Windows x64

安装与启动步骤

1安装 uv

uv 会把 OpenSquilla 装进独立环境并自管 Python。若 uv --version 已可用则跳过本步。Windows 用 PowerShell 安装。
```
curl -LsSf https://astral.sh/uv/install.sh | sh
. "$HOME/.local/bin/env"
```

2安装 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"

3初始化配置

运行引导流程完成初始配置。若提示找不到 opensquilla 命令，请新开一个终端或重跑上一步的 PATH 命令。
```
opensquilla onboard
```
4启动网关

启动 OpenSquilla 网关运行时，即 README 给出的正式启动方式。保持该终端窗口运行。
```
opensquilla gateway run
```

5可选：源码安装

想跟随 main 分支、从本地检出运行而不修改代码时使用。需先装 Git LFS，克隆后拉取模型资源，再跑安装脚本。

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 gateway run 后网关进程保持运行且无原生库加载报错；桌面版可正常打开并加载控制器界面。

常见问题

Q：安装后提示找不到 opensquilla 命令怎么办？

A：新开一个终端，或重新执行第 1 步里的 PATH 命令；源码安装场景可运行 uv tool update-shell 后再开新终端。

Q：企业策略禁止安装 Windows 桌面版怎么办？

A：改用 Quick terminal install 方式，用 uv 安装 release wheel，在终端里运行，不依赖桌面安装包签名。

Q：从 RC3 升级 Windows 桌面版要注意什么？

A：直接用新安装包覆盖安装，不要先卸载 RC3，其卸载程序可能删除桌面版用户数据；升级前备份 %APPDATA%OpenSquilla。

Q：路由器运行时报告原生库加载错误怎么处理？

A：uv 不会安装 macOS 的 libomp 或 Windows Visual C++ Redistributable 等系统原生运行时，需自行安装，详见 README 的 Troubleshooting 章节。

Q：可以用 pip install . 或 VCS URL 安装源码吗？

A：README 明确这两种是低级源码构建路径，不能替代官方安装脚本。本地检出须先构建 Web UI 后使用 install_source.sh；无生成产物的 VCS URL 检出会被拒绝。

注意事项

正式版 wheel 和桌面安装包已内置 Vue 控制台，无需安装 Node.js 或 npm。
源码安装每次都会在 opensquilla-webui 里执行 npm ci 和 npm run build，首次依赖下载量最大。
终端安装的 ~/.opensquilla 与桌面版 profile 相互独立，如需迁移须在 Settings 中显式操作。
v0.5.4 的 Windows 安装包仍未签名，SmartScreen 可能需要时间建立发布者信誉。

核心亮点

以 Token 效率为核心设计，相同预算下可支撑更长上下文和更多轮次交互
集成 MCP 协议与技能系统，工具调用和外部能力扩展路径清晰
内置记忆模块，适合需要跨会话保持状态的长任务型 Agent

不足之处

项目较新，生态与第三方集成丰富度有待积累
文档和社区案例尚在成长阶段，深度使用需自行摸索

适用场景

搭建对 API 成本敏感的自主智能体
需要长期记忆与多轮工具调用的任务型助手
基于 MCP 协议扩展外部工具的企业级 Agent

替代项目

LangChain、AutoGen

项目介绍

opensquilla 是一个智能体领域的开源项目，官方简介：OpenSquilla — Token-Efficient AI Agent with same budget, higher intelligence density。项目使用 Python 开发，在 GitHub 上获得 7011 星标。

上一篇：gaia

下一篇：jean