Orkas

环境要求

• Node.js 22.12+（推荐 24 LTS）
• macOS / Windows 10+ / glibc 2.34+ 的 Linux x64 或 arm64
• 首次启动需联网下载 Python、Node、embedding 模型等资源
• 建议保留 Python 3 与 C/C++ 编译工具链作为原生模块兜底
• Linux 不支持 Alpine 等 musl 发行版

安装与启动步骤

1. 1克隆仓库

   把 Orkas 源码下载到本地，随后进入项目目录继续操作。

   git clone https://github.com/Orkas-AI/Orkas.git
   cd Orkas

   复制

2. 2检查 Node 版本

   确认 Node 版本不低于 22.12，版本过低会导致原生依赖安装失败。

   node -v

   复制

3. 3启动应用

   运行启动脚本，首次启动会自动安装 npm 依赖并下载所需运行时资源，耗时较长请耐心等待。

   chmod +x run.sh
   ./run.sh

   复制

4. 4Windows 启动

   Windows 用户在项目目录下执行 run.cmd 启动，效果与 run.sh 相同。

   run.cmd

   复制

5. 5配置模型密钥

   应用打开后进入 Settings → AI Providers，添加自带的大模型 API Key 或完成 OAuth 授权。

6. 6修复原生依赖

   若出现原生依赖错误，先升级到 Node 24 LTS，再执行修复命令恢复可选包与 SQLite 等模块。

   npm run native:repair

   复制

7. 7仅做依赖检查

   只想检查不想安装时，用该命令校验 SQL、sqlite-vec 与 sharp 是否就绪。

   npm run native:check

   复制

关键配置

如何确认成功

应用窗口正常打开且无原生依赖报错，进入 Settings → AI Providers 成功添加密钥后即可发起首个对话。

常见问题

注意事项

• 需自备 Claude、OpenAI、Gemini、DeepSeek 等厂商的 API Key 或完成 OAuth 授权。
• 应用自带 9 个专家智能体，开箱即用，商城另有共 30 个可选。
• OCR 与技能相关 Python 包会在首次使用对应功能时才安装到隔离环境。
• 顶层轮次串行执行，并行发生在单轮内部，全局并发上限为 10。