项目介绍
Agent 智能体 · 2026-11-09 更新 · 本站尚未实测
Orkas 是来自 GitHub 仓库 Orkas-AI/Orkas 的开源(MIT)多智能体桌面应用,README 将其定位为“local-first multi-agent desktop app”。它不是单一聊天机器人,也不是可嵌入自建项目的代码框架,而是安装在电脑上的桌面工作台:你把目标告诉 Commander,它自行完成部分任务,较大工程则拆解步骤,并调用内置专家 Agent 及你已安装的外部 CLI Agent 协作完成。
项目以工作持续运转为核心:项目保存目标、规则、记忆与文件,新对话可在既有上下文上继续;待办清单把任务分派给人和 Agent;开启 Auto-advance 后团队会自行接续下一项;定时自动化可按小时、日、周、月重复例行工作。对话、文件、知识库与自定义 Agent 默认保存在本地磁盘。
核心能力
点击能力名称查看输入、输出和原文依据。
- Commander 调度:通过
dispatch_to(调用指定 Agent 并返回结果)、hand_off_to(把剩余工作转交指定 Agent 并结束当前回合)、run_worker(执行匿名隔离子任务)三类工具组织工作。 - 16 个内置专家 Agent:覆盖研究与分析(DeepResearcher、SeoGeoAgent、StockAnalyser)、内容与媒体(ContentWriter、PptMaker、ImageStudio、VideoStudio、VoiceStudio、UIDesigner)、构建与办公(ProductDeveloper、OfficeWorker)以及 5 个电商 Agent。
- 兼容外部 CLI Agent:可将 Claude Code、Codex、OpenCode、OpenClaw、Hermes-Agent 作为本地会话运行,同一对话中协作。
- 本地资料问答:Library 在本机抽取文档段落并建立 SQLite 向量索引,回答可引用原文段落。
- Agent 学习机制:应用空闲时后台复盘新活动,可能更新自我评估、可复用方法与习得技能。
实际应用场景
适用场景
README 列举的典型用途包括:营销内容与发布视频、店铺运营简报与评论分析、调研报告、与自有文档对话、客户月报、产品发布(落地页、修复、更新日志)、制作小型内部工具,以及小团队把人和 Agent 放在同一项目中协作。
不适合的情况:只想要单一通用聊天机器人,或想要嵌入自己应用的纯代码库。README 也说明,由于运行在你自己的电脑上,Auto-advance 与定时自动化需要电脑保持唤醒并运行 Orkas;v1.9 起,电脑唤醒或 Orkas 启动后 12 小时内会补跑最近一次错过的自动化。
安装与接入
打包版(推荐):从官方下载页获取安装包,支持 macOS 12+(Apple Silicon 与 Intel)、Windows 10+,首次启动需登录,附赠内置 Orkas 模型的 500 credits。
源码运行(目前也是 Linux 上的运行方式):要求 Node 22.12+,macOS / Windows 10+ / glibc 2.34+ 的 Linux x64 或 arm64;原文给出的启动方式为:
git clone https://github.com/Orkas-AI/Orkas.git
cd Orkas
./run.sh # macOS / Linux
run.cmd # Windows
首次启动会安装锁定版本的 npm 依赖,并准备 Python、uv、Node、嵌入模型(约 95 MB)、OfficeCLI、FFmpeg、whisper.cpp 多语言语音模型等资源;工作区默认创建在 ~/.orkas/(macOS / Linux)或系统盘下的 .orkas\(Windows)。随后在 Settings → AI Providers 添加 API Key 或 OAuth。若遇到原生依赖错误,原文建议使用 Node.js 24 LTS 并执行 npm run native:repair,可用 npm run native:check 仅做检查。Alpine 等 musl 发行版不受支持。
使用本地模型(如 Ollama、LM Studio)时,README 指引在 Account settings → Models → Chat → Add model → Custom 选择 OpenAI 兼容或 Anthropic 兼容,填写 base URL、模型 ID 与 API Key。仓库中未见 MCP 配置或服务端配置文件。
使用条件与限制
- 是否需要部署
- 需自行准备运行环境,具体要求见正文
- 是否需要注册
- 账号和认证要求见正文;未明确说明的项目仍待核验
- 是否需要 API Key
- 待核验
- 费用与额度
- 费用边界见正文,项目许可不代表模型或托管服务免费
- 所需权限
- 待核验
- 许可证与服务条款
- 待核验
权限费用与限制
- 账户与凭据:打包版首次启动需登录;源码版无账户层。自有提供商密钥在本地加密,且不纳入云同步。
- 费用:应用本身 MIT 许可且免费;打包版含内置模型的 500 credits,之后可购买 credits、选择付费方案或接入自有密钥,提供商费用另计。README 提到付费方案自 $11.99/月起,具体价格、额度与权益需向官方核验。
- 模型调用路径:使用自有密钥时调用由本机直达提供商;内置 Orkas 模型经由 Orkas 托管模型服务;语音输入音频会发送至 Orkas 识别并消耗 key 所有者 credits。
- 开源版功能边界:共享项目、云同步、Web 应用发布仅在打包版提供,开源构建尚不支持。本地应用免费;发布为公开链接需付费方案,README 称 Lite/Pro/Max 分别支持 5/8/15 个应用,此处额度与价格均应向官方核验。
- 网络依赖:源码版可对本地模型端点完全离线运行;打包版需登录,云端模型需联网。外部 CLI Agent 各自保留模型设置。
- 未覆盖内容:数据存储地域、国内网络可用性、境内合规情况,资料未说明,待核查。
国内使用情况
网友核验 用户经验分享
与站长实测独立,不代表官方认证或本站已实测。
最近核验:暂无有效核验。参与人数按当前项目有效身份去重;不同核验项分别统计,不合并成用户总结果。仅统计审核通过且未过期的记录。
分项统计、有效期与样本量
| 核验项目 | 有效人数 | 成功 / 部分 / 失败 / 无法判断 | 成功率 | 最近核验 / 有效期 |
|---|---|---|---|---|
| 官方网站访问 | 0 | 0 / 0 / 0 / 0 | 样本不足 | 暂无 / 7 天 |
| GitHub 仓库访问 | 0 | 0 / 0 / 0 / 0 | 样本不足 | 暂无 / 7 天 |
| 安装与运行 | 0 | 0 / 0 / 0 / 0 | 样本不足 | 暂无 / 30 天 |
| 官方服务国内连接 / MCP 连接 | 0 | 0 / 0 / 0 / 0 | 样本不足 | 暂无 / 30 天 |
| 国内网络情况 | 0 | 0 / 0 / 0 / 0 | 样本不足 | 暂无 / 7 天 |
| 国内模型兼容性 | 0 | 0 / 0 / 0 / 0 | 样本不足 | 暂无 / 30 天 |
| 自定义 API | 0 | 0 / 0 / 0 / 0 | 样本不足 | 暂无 / 30 天 |
| 海外服务依赖 | 0 | 0 / 0 / 0 / 0 | 样本不足 | 暂无 / 30 天 |
| 海外账号要求 | 0 | 0 / 0 / 0 / 0 | 样本不足 | 暂无 / 30 天 |
| 中文界面 | 0 | 0 / 0 / 0 / 0 | 样本不足 | 暂无 / 30 天 |
| 客户端兼容性 | 0 | 0 / 0 / 0 / 0 | 样本不足 | 暂无 / 30 天 |
| 账号及费用信息 | 0 | 0 / 0 / 0 / 0 | 样本不足 | 暂无 / 30 天 |
成功率 = 成功 ÷(成功 + 部分成功 + 失败);无法判断不计入分母。至少 5 份可判断结果才显示成功率。账号、费用、海外依赖与语言等事实项,成功表示核查结论与资料吻合,具体观察另行统计;不表示免费或没有海外依赖。不同网络、客户端和版本的结果不能直接等同。
最近有效核验
暂无审核通过且未过期的网友核验。欢迎提交真实使用记录。
查看全部有效核验 →国内实测状态:国内可用性待核验。协议兼容和官方资料说明不等于国内网络可用。
- 官方网站访问
- 尚未实测 待核验
- GitHub 仓库访问
- 尚未实测 待核验
- 官方服务国内连接
- 尚未实测 待核验
- 国内网络情况
- 尚未实测 待核验
- 国内模型兼容性
- 尚未实测 待核验
- 自定义 API
- 尚未实测 待核验
- 海外服务依赖
- 尚未实测 待核验
- 海外账号要求
- 尚未实测 待核验
- 中文界面
- 尚未实测 待核验
- 国内最后核验时间
- 尚未实测
许可与国内使用
仓库代码采用 MIT 许可证(LICENSE 文件为 MIT,版权声明年份 2026)。需注意 MIT 许可覆盖仓库代码,不等同于内置 Orkas 模型服务、云同步、共享项目、Web 应用发布等托管或商业功能的授权与免费;这些服务的条款、计费与数据处理应由用户向官方确认。第三方模型(如 Claude、OpenAI、Gemini 及本地模型)受各提供商条款约束,费用由其计收。
国内使用方面:README 列出的可选模型包含 DeepSeek、Kimi、GLM、Qwen、MiniMax、Doubao,但未说明其境内网络连通性、延迟或合规适配,也未说明语音识别等托管服务的地区可用性,均待核查。源码运行与 Linux 支持情况以 README 为准,未做实测验证。
项目资料与来源
字段依据与待核验事项
access:来源确认 · git clone https://github.com/Orkas-AI/Orkas.git
project_type:来源确认 · Orkas is an open-source (MIT), local-first multi-agent desktop app — an AI assistant that works as a team.
原始 README(折叠技术参考)
# Orkas **An open-source team of AI agents on your desktop — it turns your goals into finished work and keeps it moving.** Orkas is an open-source (MIT), local-first multi-agent desktop app — an AI assistant that works as a team. Tell the **Commander** what you need: it finishes many tasks on its own, and for bigger work it plans the steps and brings in specialist agents along with the coding and personal agents you already use — **Claude Code, Codex, OpenCode, OpenClaw and Hermes-Agent** — to work on it together. Orkas is built to keep a project moving, not just answer one prompt. A **project** holds the goal, rules, memory and files, so every new conversation picks up where the last one left off. **To-dos** split the work between people and agents, **Auto-advance** lets the team take on the next to-do by itself, and **scheduled automations** repeat routine work hourly, daily, weekly or monthly. All your data stays on your computer, and finished work comes back for your review — so you can trust Orkas with the ongoing work of your business. **[⬇ Download Orkas for macOS & Windows](https://orkas.ai/download/?source=gh-orkas&entry_point=github_readme&download=1)** — free, with 500 credits for the built-in Orkas model, so you don't need an API key to start. Prefer your own keys? Claude · OpenAI · Gemini · DeepSeek · Kimi · GLM · Qwen · MiniMax · Doubao, or a local OpenAI-compatible endpoint. [](https://orkas.ai/download/?source=gh-orkas&entry_point=github_readme&download=1) [](./LICENSE) [](https://github.com/Orkas-AI/Orkas/stargazers) [](https://github.com/Orkas-AI/Orkas/releases) [](https://x.com/leochenpm) [](https://orkas.ai/?source=gh-orkas) [English](./README.md) · [简体中文](./README.zh-CN.md) · [日本語](./README.ja.md) --- https://github.com/user-attachments/assets/4f8b16c8-a192-45a4-b19f-80e8d02c3dab  --- ## What the team delivers - **Videos, voice-overs and images** — VideoStudio, VoiceStudio, ImageStudio - **Research reports, SEO audits and market analysis** — DeepResearcher, SeoGeoAgent, StockAnalyser - **Posts, articles, newsletters and slide decks** — ContentWriter, PptMaker - **Websites, UI and code** — UIDesigner, ProductDeveloper - **Word, Excel, PowerPoint and PDF files** — OfficeWorker - **E-commerce work** — product research, listings, review analysis, sales analysis and catalog changes, from five e-commerce agents - **Complex work that takes several agents** — the Commander splits it up, hands each part to the right agent and combines the results; for example, market research that becomes a report, a slide deck and a launch video 16 specialists ship with the app, each with its own skills, memory and tools. Browse 30+ agents in the [agent marketplace](https://orkas.ai/views/marketplace/gs/agents/?source=gh-orkas), or describe the role you need and the Commander builds a custom agent for you. <details> <summary><b>All 16 built-in agents</b></summary> | Area | Agent | What it delivers | | --- | --- | --- | | Research & analysis | **DeepResearcher** | Evidence-grounded research with verified sources, flagged contradictions and an auditable report | | | **SeoGeoAgent** | Give it a URL — technical audit, content quality, Core Web Vitals, AI-answer (GEO) citability, ranked fix list | | | **StockAnalyser** | Equity research, factor screens, backtests and portfolio risk checks, with traceable dashboards | | Content & media | **ContentWriter** | Publish-ready posts, articles, newsletters and case studies from a goal, sources or a rough draft | | | **PptMaker** | Editable, reviewable PPTX decks from a topic, outline or document | | | **ImageStudio** | Posters, covers, social images and infographics | | | **VideoStudio** | Narration, AI presenters, captions and dubbing, highlight clips, localization, and reference-video recreation with your own content and footage | | | **VoiceStudio** | Narration, multi-voice audio, transcripts and subtitles, audio editing and mixing | | | **UIDesigner** | Editable, HTML-first UI from product goals, PRDs, screenshots or Figma material | | Build & office | **ProductDeveloper** | Repo-aware engineering — implement a PRD, fix bugs, refactor, review, with verifiable results | | | **OfficeWorker** | Create, edit, check and deliver Word / Excel / PowerPoint / PDF files, one at a time or in batches | | E-commerce | **ECommerceResearcher** | Product selection by budget, market and sourcing limits — candidates, rejection reasons, validation plans | | | **ECommerceWriter** | Titles, detail pages, FAQs, image copy and video scripts in your brand voice | | | **ECommerceReviewer** | Review and reputation analysis — customer themes, root causes of bad reviews, priorities | | | **ECommerceAnalyzer** | Sales, profit, ads, refunds and inventory from your exports — reconciled metrics and decisions | | | **ECommerceOperator** | Plans catalog, price, promotion and inventory changes; executes only through tools you connect | More on each agent → [orkas.ai/agents](https://orkas.ai/agents/?source=gh-orkas) </details> ### Recreate a reference video with your own content **VideoStudio** can recreate a viral video's narrative structure, visual style and editing pace using your own product, script and footage. Supply a reference video file and your assets: the agent analyzes the hook, information order, visual beats and call to action, then proposes what to preserve and what to replace before production. This works best for motion-graphic explainers, SaaS or app demos, and product ads built from your existing footage. Locally authored text, captions, narration and clips can be revised separately; text baked into AI-generated footage requires changing that footage. > "Use reference.mp4 as a reference for a 30-second vertical promo. Keep its hook, typography and pacing, replace the content with my product and screen recordings, and show me the breakdown and plan first." Start with a video file the agent can read; social-platform share-link downloading is not built in. Exact camera moves, human performances and frame-by-frame matching are not guaranteed. See the [reference-recreation workflow](./resources/builtin/marketplace/agents/79df9cc89f5f/skills/video-craft/references/reference-recreation.md). --- ## Keep the work moving One task is a good start. Orkas is built for the work that keeps going. - **Projects** — goals & rules, memory and files that every conversation in the project starts from, so you never brief from scratch. - **To-dos and Auto-advance** — every project has a to-do list for people and agents; with Auto-advance on, the team picks up the next item on its own and brings finished work back for your review. - **Scheduled automations** — run any task hourly, daily, weekly or monthly. Orkas runs on your computer. From v1.9, each automation catches up its most recent missed run within 12 hours when the computer wakes or Orkas starts. - **Connectors** — Gmail, Google Calendar, Sheets and Drive, Notion, Slack, Shopify, Stripe and many more. By default, Orkas asks before it sends, posts or deletes anything. - **Apps** — describe a tool and Orkas builds it as a local app inside the desktop app. In the packaged app, paid plans can also publish it as a web app with a public link. - **Shared projects** *(packaged app)* — invite a teammate or VA, and give each to-do to a person or an agent. > [!NOTE] > Shared projects, cloud sync and web-app publishing are only in the packaged app — the open-source build doesn't support them yet. To use them, **[download Orkas for macOS & Windows](https://orkas.ai/download/?source=gh-orkas&entry_point=github_readme&download=1)** (free, with 500 credits to start). Voice input also works in the source build. Configure an **Orkas API Key** in **Settings → Models**, then click the microphone beside a composer. Allow microphone access when prompted. Audio is sent to Orkas for recognition and uses the key owner’s Orkas credits. Click again to stop, review the text, and send it yourself. If access was denied, enable the microphone in your system settings. --- ## Run Claude Code, Codex, OpenCode, OpenClaw and Hermes-Agent together Orkas runs the CLI agents you already have installed as local sessions, next to its own specialists — the coding agents **Claude Code, Codex and OpenCode**, and the personal agents **OpenClaw and Hermes-Agent**. The Commander hands each one the part it's best at and keeps one plan across all of them, so a single chat can fix the bug, review the change and draft the release note. Open-source tools such as HyperFrames plug in the same way. [Using Claude Code and Codex together →](https://orkas.ai/blog/claude-code-codex-together/?source=gh-orkas) --- ## Why Orkas - **A Commander that plans, delegates and does the rest** — it breaks down goals, picks the right agents, skills, connectors and tools, and handles analysis, writing, research and file work itself when no specialist is a better fit. - **Local-first by design** — conversations, files, knowledge bases and custom agents stay on your disk by default. Cloud sync is optional in the packaged app. With your own keys, model calls go straight from your machine to the provider; the built-in Orkas model runs through Orkas's managed model service. - **Any model, switch any time** — the Commander and built-in agents share one model setting: the built-in Orkas model, your own provider, or a local endpoint. External CLI agents keep their own model settings. - **Agents that get better** — each agent keeps private skills and memory. Background reviews examine new activity when the app is idle and can refine self-assessment, reusable methods and learned skills. - **Open source, no black box** — MIT licensed. Read exactly what Orkas and every agent and skill do. > ⭐ If Orkas is useful to you, a star helps more people find the project. --- ## Download | | Packaged app (recommended) | Run from source | | --- | --- | --- | | Platforms | macOS 12+ (Apple Silicon & Intel), Windows 10+ | macOS, Windows, glibc 2.34+ Linux x64/arm64 | | Account | Sign in — 500 free credits | None | | Models | Built-in Orkas model, or your own keys | Your own keys or a local endpoint | | Also includes | Project collaboration, app publishing, cloud sync, and more | — | | Get it | **[Download Orkas](https://orkas.ai/download/?source=gh-orkas&entry_point=github_readme&download=1)** | [Quick start](#quick-start) | The download link detects your system and starts the right installer. --- ## What people use it for - **Marketing content** — launch videos, product pages, posts and newsletters in your voice. [Content writing](https://orkas.ai/use/content-writing/?source=gh-orkas) · [Videos](https://orkas.ai/use/make-videos/?source=gh-orkas) - **Store operations** — weekly sales briefs, review replies, listings and competitor checks. [E-commerce](https://orkas.ai/use/ecommerce/?source=gh-orkas) - **Research and reports** — sourced reports and decks, on demand or every week. [Research](https://orkas.ai/use/researchers/?source=gh-orkas) · [Data analysis](https://orkas.ai/use/data-analysis/?source=gh-orkas) - **Chat with your documents** — answers grounded in your own files, with citations back to the source passages. [Chat with documents](https://orkas.ai/use/chat-with-documents/?source=gh-orkas) - **Client work** — meeting briefs, monthly client reports and update decks in your template. [Monthly client report template](https://orkas.ai/blog/monthly-client-report-template/?source=gh-orkas) - **Product launch** — landing pages, bug fixes with tests, changelogs and launch posts. [Developers](https://orkas.ai/use/developers/?source=gh-orkas) - **Build an app** — quote calculators, booking forms, internal tools. [Build apps](https://orkas.ai/use/build-apps/?source=gh-orkas) - **Small teams** — one project for people and agents. [Small teams](https://orkas.ai/use/small-teams/?source=gh-orkas) --- ## How Orkas compares | Tool | What it is | How Orkas differs | | --- | --- | --- | | **Claude Code** | Anthropic's agentic coding tool — in the terminal, IDE, desktop and web, built on Claude models. | Not either-or: Orkas runs Claude Code as one of its agents. Around it, Orkas adds a model-agnostic team for the work beyond code — research, content, video and more — with projects, to-dos and automations that keep it moving. [Orkas vs Claude Code →](https://orkas.ai/compare/orkas-vs-claude-code/?source=gh-orkas) | | **Codex** | OpenAI's coding agent — in the terminal, your editor and the cloud. | Not either-or: Orkas runs Codex as one of its agents, next to Claude Code and OpenCode. The Commander can hand the coding to Codex and the review to another agent, then cover the non-code half of a release — docs, launch posts and videos. [Orkas vs Codex →](https://orkas.ai/compare/orkas-vs-codex/?source=gh-orkas) | | **Claude Cowork** | Anthropic's agent for everyday work, now part of Claude — on desktop, web and mobile with a paid Claude plan. It runs in Anthropic's cloud by default and uses Claude models. | An open-source (MIT) alternative to Claude Cowork that's free to start, with 500 credits. Orkas runs its agents on your computer and keeps your data local by default, with the built-in Orkas model, your own provider keys or a local endpoint. The Commander can also bring in Claude Code, Codex and other CLI agents. The trade-off: Orkas needs your computer awake, while Cowork's cloud tasks can keep running without it. [Claude Cowork alternatives →](https://orkas.ai/compare/claude-cowork-alternatives/?source=gh-orkas) | | **Manus** | An AI agent that plans and runs tasks in Manus's cloud by default. The Manus Studio desktop app (macOS and Windows) can also work in a folder you choose, with tasks still planned in the cloud. | An open-source (MIT) alternative to Manus. Orkas runs its agents on your computer and keeps your data local by default, with the built-in Orkas model, your own provider keys or a local endpoint. Projects, to-dos and automations keep the work moving. The trade-off: Orkas needs your computer awake, while Manus's cloud tasks can keep running without it. [Open-source Manus alternative →](https://orkas.ai/open-source-manus-alternative/?source=gh-orkas) | | **LangChain** | A developer framework/library for building LLM apps and agents — code-first, embedded in your own Python/JS app. | Orkas is a desktop app you direct through chat, not by writing orchestration code. Data stays local by default. | | **CrewAI** | A Python framework for orchestrating role-playing autonomous agents — you define crews and agents in code. | Orkas brings multi-agent orchestration into a desktop app, with projects, to-dos, automations and per-agent self-improvement built in. | | **OpenClaw** | A personal-agent platform with messaging integrations, multi-agent routing and sub-agents. | Orkas provides a desktop workspace for finished deliverables, with built-in specialists and coordination across Claude Code, Codex, OpenCode and other CLI agents. OpenClaw can join that workflow as a CLI agent. | | **Hermes-Agent** | Nous Research's self-improving agent — one agent with memory and skills, available as a CLI, a messaging gateway and a desktop app. | Orkas coordinates a team: the Commander directs many specialists and other CLI agents, and Hermes-Agent plugs in as one of them. | **Orkas is for you if** you want a team of agents rather than one assistant, work that keeps moving across days, and your data, keys and agents on your own disk. **Not for you if** you just want a single all-purpose chatbot, or a pure code library to embed in your own app. **Choosing between coding agents?** [Codex vs OpenCode](https://orkas.ai/compare/codex-vs-opencode/?source=gh-orkas) · [Claude Code vs Codex vs OpenCode](https://orkas.ai/compare/claude-code-vs-codex-vs-opencode/?source=gh-orkas) · [Claude Code alternatives](https://orkas.ai/compare/claude-code-alternatives/?source=gh-orkas) **Full side-by-side comparisons →** [vs Claude Code](https://orkas.ai/compare/orkas-vs-claude-code?source=gh-orkas) · [vs Codex](https://orkas.ai/compare/orkas-vs-codex?source=gh-orkas) · [vs Cline](https://orkas.ai/compare/orkas-vs-cline?source=gh-orkas) · [vs LangChain](https://orkas.ai/compare/orkas-vs-langchain?source=gh-orkas) · [vs ChatGPT](https://orkas.ai/compare/orkas-vs-chatgpt?source=gh-orkas) · [vs OpenClaw](https://orkas.ai/compare/orkas-vs-openclaw?source=gh-orkas) · [vs Hermes-Agent](https://orkas.ai/compare/orkas-vs-hermes-agent?source=gh-orkas) --- ## Quick start Want a packaged installer instead? See [Download](#download) above. To run from source — currently the way to run Orkas on Linux: **Requirements**: Node 22.12+ · macOS / Windows 10+ / glibc 2.34+ Linux x64 or arm64. Keep Python 3 and a C/C++ build toolchain available for the uncommon native-module source-build fallback. ```bash git clone https://github.com/Orkas-AI/Orkas.git cd Orkas ./run.sh # macOS / Linux run.cmd # Windows ``` Linux source runs require glibc 2.34+. Alpine and other musl-based distributions are not supported. Local speech transcription downloads and verifies the target-native whisper.cpp runtime and multilingual model during the first source launch. `run.sh` / `run.cmd` installs the locked npm dependency tree and prepares the pinned Python, uv, Node, embedding model (~95 MB), OfficeCLI, FFmpeg, whisper.cpp, and multilingual speech model resources on first launch. Linux startup then verifies the platform-native modules and Whisper runtime under Electron's ABI before opening the app. OCR and Skill-specific Python packages are installed into isolated local environments when those features are first used. First launch creates a workspace under `~/.orkas/` (macOS / Linux) or `<smallest non-system drive>:\.orkas\` (Windows). Then open **Settings → AI Providers** to add an API key or OAuth. Native dependency errors: use Node.js 24 LTS (minimum 22.12.0), then run `npm run native:repair` from this checkout. This restores optional packages, repairs SQLite for Electron, prepares bundled Node for isolated image processing, and checks SQL, sqlite-vec and sharp before success. Use `npm run native:check` for a check without installation. See the [native dependency verification script](./scripts/verify-native-dependencies.cjs) for the checks performed. --- ## How it works ### Task routing The Commander handles general work itself and delegates specialist work through three tools: - **`dispatch_to`** runs a named agent and returns its result for continued work. It can wait for the result or run asynchronously and notify the Commander when the task finishes. - **`hand_off_to`** transfers the remaining work to a named agent and ends the current Commander turn. The agent delivers its own reply; an optional continuation lets the Commander resume a broader task afterward. - **`run_worker`** runs an anonymous, isolated sub-task and returns a private result. It does not receive conversation history or a named agent's skills. Named agent tasks and anonymous workers have separate concurrency controls. See the [dispatch implementation](./src/main/features/group_chat/bus.ts) and [execution locks](./src/main/util/locks.ts). ### Context management The runtime budgets context against the selected model's usable input capacity, accounting for prompts, tools and persistent runtime state. Completed dialogue uses a bounded recent-history window; long active tasks use checkpoints to condense earlier process messages while retaining recent work. File reads, file changes and command executions also have structured records that can survive context compaction. See [context budgets](./src/core-agent/src/agent/context-budget.ts), [session history and checkpoints](./src/core-agent/src/agent/session.ts) and [workspace records](./src/core-agent/src/agent/workspace-state.ts). ### Memory and the Library Durable notes keep user preferences, project facts and each agent's reusable knowledge in separate scopes. These notes are distinct from the Library's document index and the stored conversation history. The Library extracts documents into passages and stores a local SQLite vector index. Its embedding model runs on your machine; the `library` tool can list files, search relevant passages and read source content from the global or current-project Library. Earlier conversations are retrieved separately through `chat_history`. See [scoped memory](./src/main/features/memory.ts), [document extraction](./src/main/util/file_to_chunks.ts), [Library tools](./src/main/model/core-agent/kb-tools.ts) and [conversation retrieval](./src/main/model/core-agent/chat-history-tools.ts). ### Execution limits and recovery Session locks and concurrency limits bound parallel work. Tool-round budgets, progress checkpoints, repeated-call checks and phase-aware idle watchdogs help contain runs that stall or repeat work. Named agent tasks can be tracked and cancelled individually; an admitted or queued task is not treated as a completed result. See [actor budgets](./src/main/features/group_chat/actor-budgets.ts), the [agent runtime](./src/core-agent/src/agent/runner.ts) and the [desktop model adapter](./src/main/model/core-agent/client.ts). ### Learning from activity Background reviews examine new agent activity when the app is idle, subject to cooldowns and execution limits. A review may update an agent's self-assessment (`COMPETENCE.md`), reusable methods (`LEARNING_STRATEGIES.md`) or learned skills. Reviews depend on new activity rather than task count, and can conclude that there is nothing worth saving. See the [reflection scheduler](./src/main/features/reflection-orchestrator.ts) and [review prompt](./src/core-agent/src/evolution/metacognition.ts). --- ## FAQ **What is Orkas?** Orkas is an open-source (MIT), local-first multi-agent desktop app. Its Commander turns your goal into to-dos and coordinates 16 built-in specialist agents — plus Claude Code, Codex, OpenCode, OpenClaw and Hermes-Agent — to deliver finished files. Not a single chatbot, not a code framework, not a hosted SaaS. **Do I need an API key?** No. The packaged app comes with 500 credits for the built-in Orkas model. After that, buy credits, choose a paid plan or add your own provider keys; provider charges are separate. **Is Orkas a local LLM?** No. Orkas runs on your machine and calls the models you choose — the built-in Orkas model, your own API keys, or a local model endpoint. It orchestrates agents and tools; it is not itself a model. **Can Orkas answer questions from my documents, with citations?** Yes. Add PDFs and documents to your local Library; Orkas can search them and answer with citations to source passages, so you can open the original and check. The index is built on your machine. **Can I use local models like Ollama or LM Studio?** Yes. Open **Account settings → Models → Chat → Add model → Custom**, select **OpenAI-compatible** or **Anthropic-compatible**, and enter the base URL, exact model ID, and API key. Choose the saved model from the task's model control. **Where are my API keys and data stored?** On your disk by default. Your own provider keys are encrypted locally and excluded from cloud sync. With your own keys, model calls go straight from your machine to the provider; the built-in Orkas model uses Orkas's managed service. Optional cloud sync and shared projects in the packaged app store the selected data on Orkas servers. [Security and data handling →](https://orkas.ai/security/?source=gh-orkas) **Does Orkas work offline?** The source build can run fully offline against a local model endpoint. The packaged app needs to sign in, and cloud models need a network connection. **Does it keep working when my computer is off?** No — Orkas runs on your computer, so Auto-advance and automations need the computer awake and Orkas running. From v1.9, each automation catches up its most recent missed run within 12 hours when the computer wakes or Orkas starts. **Can I build and publish apps?** Yes. Local apps that run inside Orkas are free. Publishing a web app to a public link needs a paid plan (Lite 5, Pro 8, Max 15 apps), and published web apps don't include every capability available inside Orkas. **Do I need an Orkas account?** The packaged desktop app asks you to sign in when you first launch it. The source build in this repository has no account layer at all — it boots straight into the app. **Can Orkas drive Claude Code and other CLI agents?** Yes. Orkas can drive five external CLI agents as local subprocesses — the coding agents Claude Code, Codex and OpenCode, plus the personal agents OpenClaw and Hermes-Agent — and onboard open-source projects like HyperFrames, all directed from the same chat. **How is Orkas different from Claude Code / Codex / CrewAI / LangChain?** Claude Code and Codex are coding agents — Orkas runs both as members of its team, so you don't have to choose between them; CrewAI and LangChain are code-first frameworks. Orkas is an open-source desktop app where a Commander coordinates a team of specialist agents and your CLI agents, with any model provider, and keeps data and keys local. See the [full comparisons](https://orkas.ai/compare/?source=gh-orkas). **Which platforms does Orkas support?** macOS 12+ (Apple Silicon and Intel) and Windows 10+ have packaged installers. glibc 2.34+ Linux x64/arm64 runs from source today, with no installer yet. Local speech transcription is supported on Linux through the pinned whisper.cpp runtime prepared on first launch. Alpine and other musl-based distributions are not supported. The source bootstrap needs Node 22.12+; Python 3 and a C/C++ build toolchain are needed only when a native npm package has no compatible prebuilt binary and must be rebuilt locally. **Is Orkas free and open source?** Yes — the app is MIT licensed and free to use. The packaged app includes 500 credits for the built-in Orkas model; paid plans from $11.99/month add monthly credits, cloud sync, more shared projects and app publishing. With your own keys, model usage is billed by your provider; Orkas does not add a markup. [Pricing →](https://orkas.ai/pricing/?source=gh-orkas) --- ## License [MIT](./LICENSE)
历史前置条件说明(补充参考)
打包版:macOS 12+ 或 Windows 10+,首次启动需登录;源码版:Node 22.12+,Linux 需 glibc 2.34+ 且不支持 musl 发行版,必要时需 Python 3 与 C/C++ 构建工具链;模型可使用打包版内置 Orkas 模型(含 500 credits)或自备 Claude/OpenAI/Gemini/DeepSeek/Kimi/GLM/Qwen/MiniMax/Doubao 密钥或本地 OpenAI 兼容端点;付费方案价格、额度与云同步/发布权益待向官方核验;国内网络与合规可用性待核查。
项目来源与清单版权许可
https://github.com/Orkas-AI/Orkas
整理来源:https://github.com/slavakurilyak/awesome-ai-agents
清单版权与许可:
MIT License
Copyright (c) 2024 Slava Kurilyak
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.