Skip to content

armgit / Orkas

Public Imported from GitHub
0

Orkas is an open-source (MIT), local-first AI team for your desktop: a Commander turns your goal into to-dos and coordinates 16 built-in specialist agents plus Claude Code, Codex, OpenCode, OpenClaw and Hermes, with projects, scheduled automations and connectors. Free app for macOS & Windows; built-in models or your own keys.

Rewrite bilingual README around finished work and ongoing automation

BlueSkyID666bf9e51d42d63
diff --git a/README.md b/README.md
index 2d66b6cd..d872884b 100644
--- a/README.md
+++ b/README.md
@@ -1,14 +1,16 @@
# Orkas
-**Command a team of AI agents from one desktop chat — not one chatbot.**
+**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, local-first multi-agent desktop app. Describe a goal; its **Commander** plans the work, handles the general parts itself, and coordinates specialist agents in parallel or in sequence. **Nine specialist agents ship with the app**, ready the moment you launch it, out of 30 in the marketplace. Bring your own model keys — Claude · OpenAI · Gemini · DeepSeek · Kimi · GLM · Qwen · MiniMax · Doubao. macOS · Windows · Linux.
+Orkas is an open-source (MIT), local-first multi-agent desktop app — an AI assistant that works as a team. Describe a goal and the **Commander** turns it into to-dos, handles the general parts itself, and coordinates **16 built-in specialist agents** — research, writing, slides, video, voice, design, code, SEO and e-commerce — plus the coding and personal agents you already use: **Claude Code, Codex, OpenCode, OpenClaw and Hermes-Agent**. Projects keep goals, memory and files together; Auto-advance and scheduled automations keep the work moving; finished work comes back for your review.
+
+**[⬇ 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.
+
+[![Download for macOS & Windows](https://img.shields.io/badge/Download-macOS%20%26%20Windows-5b57d6?style=for-the-badge)](https://orkas.ai/download/?source=gh-orkas&entry_point=github_readme&download=1)
[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](./LICENSE)
[![Stars](https://img.shields.io/github/stars/Orkas-AI/Orkas?style=social)](https://github.com/Orkas-AI/Orkas/stargazers)
[![Release](https://img.shields.io/github/v/release/Orkas-AI/Orkas?color=blue)](https://github.com/Orkas-AI/Orkas/releases)
-[![Platform](https://img.shields.io/badge/platform-macOS%20%7C%20Windows%20%7C%20Linux-blue)](https://orkas.ai?source=gh-orkas)
-[![Download](https://img.shields.io/badge/download-orkas.ai-black)](https://orkas.ai/download/?source=gh-orkas&entry_point=github_readme&download=1)
[![X: @leochenpm](https://img.shields.io/badge/X-%40leochenpm-black?logo=x)](https://x.com/leochenpm)
[English](./README.md) · [简体中文](./README.zh-CN.md)
@@ -17,39 +19,81 @@ Orkas is an open-source, local-first multi-agent desktop app. Describe a goal; i
**You:** *"Research the top 5 competitors, write it up, and turn it into a deck."*
-**Orkas:** the Commander breaks the goal into steps and runs them across specialists — **DeepResearcher** gathers and verifies the sources, **ContentWriter** drafts the report, **PptMaker** builds the slides. One chat, one shared plan, finished files on your disk.
+**Orkas:** the Commander turns the goal into to-dos and runs them across specialists — **DeepResearcher** gathers and verifies the sources, **ContentWriter** drafts the report, **PptMaker** builds the slides. One chat, one shared plan, finished files in your project.
-![Orkas demo: the Commander turns a goal into a step-by-step plan, dispatches it to specialist agents, and delivers the finished file](./resources/app-ui/demo-en.gif)
+![Orkas demo: the Commander turns a goal into to-dos, dispatches them to specialist agents, and delivers the finished files](./resources/app-ui/demo-en.gif)
---
-## Agents that ship with the app
+## 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. On a paid plan, publish it as a web app with a public link.
+- **Shared projects** — invite a teammate or VA, and give each to-do to a person or an agent.
+
+Cloud sync, shared projects, voice input and web-app publishing are part of the packaged app; most of the rest also works in the source build.
+
+---
+
+## 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
+
+Sixteen 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>
-Installed and ready the first time you launch Orkas — each with its own skills, memory, and tools.
+| 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 |
+| | **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>
+
+---
-| Agent | What it does |
-| --- | --- |
-| **DeepResearcher** | Evidence-grounded research — plans the investigation, verifies sources, flags contradictions, ships an auditable report with citations |
-| **ContentWriter** | Turns a goal, source material, or a rough draft into publish-ready posts, articles, newsletters, and case studies |
-| **PptMaker** | Turns a topic, outline, or document into an attractive, editable, reviewable PPTX deck |
-| **ProductDeveloper** | Repo-aware engineering — implement a PRD, fix bugs, refactor, review code, with verifiable results |
-| **OfficeWorker** | Create, edit, check, and deliver Word / Excel / PowerPoint / PDF files, one at a time or in batches |
-| **VideoStudio** | Make and edit video — narration, AI presenters, captions and dubbing, highlight clips, localization |
-| **ImageStudio** | Posters, covers, social images, infographics — HTML/CSS/SVG first, image models when the shot needs them |
-| **UIDesigner** | Product goals, PRDs, screenshots, or Figma material into editable, HTML-first UI deliverables |
-| **SeoGeoAgent** | Give it a URL — technical audit, content quality, Core Web Vitals, GEO citability, health score, ranked fix list |
+## Run Claude Code, Codex and OpenCode together
-**More on the built-in agents →** [orkas.ai/agents](https://orkas.ai/agents/?source=gh-orkas) · **Browse all 30 →** [agent marketplace](https://orkas.ai/views/marketplace/gs/agents/?source=gh-orkas) · or just describe what you need and the Commander builds a custom agent for you.
+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 super-powered Commander** — understands context, breaks down goals, chooses the right agents, skills, connectors, and tools, and directly handles analysis, writing, research, file work, and automation when no specialist is a better fit.
-- **Drives the open-source ecosystem** — plug in external CLI agents as local sessions — the coding agents Claude Code, Codex and OpenCode, plus the personal agents OpenClaw and Hermes-Agent — and onboard open-source projects like HyperFrames as local tools, all coordinated by the same Commander.
-- **Local-first by design** — conversations, files, API keys, knowledge bases, and custom agents all stay on your disk. Model calls go straight from your machine to the provider — never through Orkas servers.
-- **No vendor lock-in** — mix providers across agents: one on Claude, another on DeepSeek, another on a local endpoint.
-- **Agents that get better** — each agent has its own private skills and memory, and improves through reflection after each task.
+- **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, and reflects when a task signals it should (a correction, a recovered error, a known weakness) to improve the next run.
+- **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.
@@ -57,20 +101,28 @@ Installed and ready the first time you launch Orkas — each with its own skills
## Download
-Packaged installers for macOS and Windows. glibc-based Linux x64/arm64 runs from source today — see [Quick start](#quick-start).
+| | 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 | Cloud sync, shared projects, voice input, web-app publishing | — |
+| Get it | **[Download Orkas](https://orkas.ai/download/?source=gh-orkas&entry_point=github_readme&download=1)** | [Quick start](#quick-start) |
-[Download Orkas](https://orkas.ai/download/?source=gh-orkas&entry_point=github_readme&download=1)
+The download link detects your system and starts the right installer.
---
-## What can you build with it?
-
-- **Automate recurring reports & market research** — a specialist agent gathers, summarizes, and ships a weekly report.
-- **Turn a product spec into dev tasks** — the Commander breaks a PRD into tasks and dispatches them across agents.
-- **Chat with your documents & run local data analysis** — drop files in, keep the data on your machine.
-- **Go beyond code — video, slides, and more** — the Commander drives open-source tools like HyperFrames and hands off to CLI agents — the coding agents Claude Code, Codex and OpenCode, plus the personal agents OpenClaw and Hermes-Agent — and other local agents, so one chat produces code, research, video, and slide decks.
+## What people use it for
-**Explore use cases →** [research workflows](https://orkas.ai/use/researchers?source=gh-orkas) · [data analysis](https://orkas.ai/use/data-analysis?source=gh-orkas) · [chat with documents](https://orkas.ai/use/chat-with-documents?source=gh-orkas) · [for developers](https://orkas.ai/use/developers?source=gh-orkas) · [automate your workspace](https://orkas.ai/use/automate-workspace?source=gh-orkas)
+- **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)
---
@@ -78,51 +130,65 @@ Packaged installers for macOS and Windows. glibc-based Linux x64/arm64 runs from
| Tool | What it is | How Orkas differs |
| --- | --- | --- |
-| **LangChain** | A developer framework/library for building LLM apps and agents — code-first, embedded in your own Python/JS app. | Orkas is a local-first multi-agent desktop app you direct through chat, not by writing orchestration code. Data and keys stay 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 **local-first storage** and per-agent self-evolution built in. |
-| **Cloud agent platforms** (SaaS orchestrators) | Server-hosted; conversations, files, and API keys live on the vendor's infrastructure. | Orkas is **local-first**: everything stays on your machine, and model API calls go straight to the provider — never archived by Orkas. |
-| **OpenClaw** | A single always-on personal assistant reaching you across messaging channels. | Orkas gives you a team rather than one assistant: the Commander coordinates specialist agents from one desktop chat, and OpenClaw plugs in as an Orkas CLI backend. |
-| **Hermes-Agent** | Nous Research's self-improving personal agent (TUI + multi-channel gateway). | Orkas is a local-first multi-agent desktop app, with per-agent private skills and meta-cognition — and Hermes-Agent plugs in as an Orkas CLI backend. |
+| **Claude Cowork** | Anthropic's agentic desktop experience, built on Claude. | Orkas is open source (MIT) and model-agnostic — the built-in Orkas model or your own keys from any provider — and coordinates Claude Code, Codex and OpenCode alongside its own specialists. [Claude Cowork alternatives →](https://orkas.ai/compare/claude-cowork-alternatives/?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 single always-on personal assistant reaching you across messaging channels. | Orkas gives you a team rather than one assistant, and OpenClaw plugs in as one of its CLI agents. |
+| **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, a desktop GUI with file drop-in and visual agent management, and your data, keys, and agents on your own disk rather than a vendor cloud.
+**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, a fully hosted/cloud team where your data lives on a vendor's servers, or a pure code library to embed in your own app.
+**Not for you if** you just want a single all-purpose chatbot, or a pure code library to embed in your own app.
-**Full side-by-side comparisons →** [vs Claude Code](https://orkas.ai/compare/orkas-vs-claude-code?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)
+**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 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)
---
## FAQ
**What is Orkas?**
-Orkas is an open-source, local-first multi-agent desktop app. A super-powered Commander plans your goal and coordinates specialist agents to complete it together — nine of them ship with the app. Not a single chatbot, not a code framework, not a hosted SaaS.
+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 but calls the models you choose through your own API keys (or a local model endpoint). It orchestrates agents and tools — it is not itself a model.
+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.
+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. Conversations, files, knowledge bases, agents, and keys stay local; model calls go straight from your machine to the provider and are never proxied or archived by Orkas.
+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 app is fully offline-capable — only the model calls need network. Point agents at a local model endpoint and you can run without the cloud.
+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. Either way your model keys are your own and stay on your machine.
+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. Beyond its own Commander and specialist agents, 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.
+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 Desktop / CrewAI / LangChain?**
-Claude Desktop is a single assistant; CrewAI and LangChain are code-first frameworks. Orkas is a local-first multi-agent desktop app: the Commander coordinates specialist agents, keeps data and keys local, and gives each agent its own private skills and memory. See the [full comparisons](https://orkas.ai/compare/orkas-vs-langchain?source=gh-orkas).
+**How is Orkas different from Claude Cowork / Claude Desktop / CrewAI / LangChain?**
+Claude Cowork and Claude Desktop are built on Claude alone; 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 (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.
+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. Bring your own model keys and you pay only your model providers; Orkas never takes a cut. Optionally, the desktop app also offers a built-in **Orkas model** for people who don't want to manage API keys — that one is billed by Orkas in credits (membership or credit packs). It is entirely opt-in, and every other feature works on your own keys. [Pricing →](https://orkas.ai/pricing/?source=gh-orkas)
+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)
---
diff --git a/README.zh-CN.md b/README.zh-CN.md
index e293e3b1..7adc5ff8 100644
--- a/README.zh-CN.md
+++ b/README.zh-CN.md
@@ -1,76 +1,128 @@
# Orkas
-**在一个桌面对话里指挥一支 AI 智能体团队 —— 而不是单个聊天机器人。**
+**开源的 AI 智能体团队,就在你的桌面上——把目标变成交付成果,并持续推进。**
-Orkas 是一个开源、本地优先的多智能体桌面应用。你描述目标,**指挥官**规划路径、亲自完成通用部分,并调度专业智能体并行或串行执行。**9 个专业智能体随应用内置**,启动即可用,marketplace 中共有 30 个。自带模型 key —— Claude · OpenAI · Gemini · DeepSeek · Kimi · GLM · Qwen · MiniMax · Doubao。支持 macOS · Windows · Linux。
+Orkas 是一个开源(MIT)、本地优先的多智能体桌面应用,也是一支协同工作的 AI 助手团队。你描述目标,**指挥官(Commander)**将它拆成待办、亲自完成通用部分,并协调 **16 个内置专业智能体**完成研究、写作、幻灯片、视频、语音、设计、代码、SEO 和电商工作;还可接入你已在使用的编程与个人智能体:**Claude Code、Codex、OpenCode、OpenClaw 和 Hermes-Agent**。项目汇集目标、记忆和文件,Auto-advance(自动推进)与定时自动化让工作持续推进,完成的成果交回给你审核。
-[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](./LICENSE)
+**[⬇ 下载 Orkas:macOS 与 Windows](https://orkas.ai/download/?source=gh-orkas&entry_point=github_readme&download=1)** —— 免费使用,内置 Orkas 模型赠送 500 积分,开始使用无需 API Key。也可以用自己的 Key:Claude · OpenAI · Gemini · DeepSeek · Kimi · GLM · Qwen · MiniMax · Doubao,或接入本地 OpenAI 兼容模型端点。
+
+[![下载 macOS 与 Windows 版](https://img.shields.io/badge/Download-macOS%20%26%20Windows-5b57d6?style=for-the-badge)](https://orkas.ai/download/?source=gh-orkas&entry_point=github_readme&download=1)
+
+[![许可证:MIT](https://img.shields.io/badge/License-MIT-green.svg)](./LICENSE)
[![Stars](https://img.shields.io/github/stars/Orkas-AI/Orkas?style=social)](https://github.com/Orkas-AI/Orkas/stargazers)
[![Release](https://img.shields.io/github/v/release/Orkas-AI/Orkas?color=blue)](https://github.com/Orkas-AI/Orkas/releases)
-[![Platform](https://img.shields.io/badge/platform-macOS%20%7C%20Windows%20%7C%20Linux-blue)](https://orkas.ai?source=gh-orkas)
-[![Download](https://img.shields.io/badge/download-orkas.ai-black)](https://orkas.ai/download/?source=gh-orkas&entry_point=github_readme&download=1)
[![X: @leochenpm](https://img.shields.io/badge/X-%40leochenpm-black?logo=x)](https://x.com/leochenpm)
[English](./README.md) · [简体中文](./README.zh-CN.md)
---
-**你:**“调研这个领域的 5 个竞品,写成报告,再做成一份 PPT。”
+**你:** *“研究排名前 5 的竞品,写成报告,再做成一份幻灯片。”*
-**Orkas:** 指挥官把目标拆成步骤,分派给专业智能体 —— **DeepResearcher** 检索并核验来源,**ContentWriter** 撰写报告,**PptMaker** 制作幻灯片。同一个对话、同一份计划,成品文件落在你的硬盘上。
+**Orkas:** 指挥官把目标拆成待办,再协调专业智能体执行:**DeepResearcher** 收集并核实来源,**ContentWriter** 撰写报告,**PptMaker** 制作幻灯片。一个对话、一份共享计划,成品留在你的项目里。
-![Orkas 演示:指挥官把目标拆成分步计划,分派给专业智能体,并交付成品文件](./resources/app-ui/demo.gif)
+![Orkas 演示:指挥官把目标拆成待办,调度专业智能体并交付成品](./resources/app-ui/demo.gif)
---
-## 随应用内置的智能体
+## 让工作持续推进
-首次启动 Orkas 即已安装可用,每个都有自己的技能、记忆和工具。
+完成一项任务只是开始。Orkas 也为需要持续开展的工作而设计。
-| 智能体 | 能做什么 |
-| --- | --- |
-| **DeepResearcher** | 证据型深度研究 —— 拆解问题、检索多源、核验引用、标注矛盾点,输出可复核的带引用报告 |
-| **ContentWriter** | 把一句目标、资料或草稿写成可发布内容 —— 社媒成稿、文章、newsletter、教程、案例 |
-| **PptMaker** | 把主题、提纲或文档做成好看、实用、可编辑、可复核的 PPTX |
-| **ProductDeveloper** | 仓库级研发 —— 把 PRD、issue、bug 报告落成最小代码变更、工程测试与可审计验证 |
-| **OfficeWorker** | 创建、编辑、检查并交付 Word / Excel / PowerPoint / PDF,单个或批量处理 |
-| **VideoStudio** | 做视频也剪视频 —— 解说动画、AI 口播数字人、字幕配音、高光切片、本地化 |
-| **ImageStudio** | 海报、封面、社媒图、信息图 —— 优先用 HTML/CSS/SVG 生成,需要时再调用图片模型 |
-| **UIDesigner** | 把产品目标、PRD、截图或 Figma 材料转成以 HTML 呈现、可连续修改的 UI 设计产物 |
-| **SeoGeoAgent** | 给一个 URL —— 技术审计、内容质量、核心网页指标、GEO 可引用性评分、健康分与分级行动清单 |
+- **项目** —— 目标与规则、记忆、文件随项目共享,每个新对话都能接着做,不必从头交代背景。
+- **待办与 Auto-advance** —— 项目中的待办可交给人或智能体;开启自动推进后,团队会自行接手下一项工作,并将完成的成果交回给你审核。
+- **定时自动化** —— 按小时、每天、每周或每月执行任务。Orkas 在你的电脑上运行;从 1.9 起,电脑唤醒或应用启动后,每个自动化会补跑 12 小时内最近一次错过的任务。
+- **连接器** —— 接入 Gmail、Google Calendar、Sheets、Drive、Notion、Slack、Shopify、Stripe 等服务。默认情况下,Orkas 会在发送、发帖或删除前询问你。
+- **应用** —— 描述你需要的工具,Orkas 就能将它做成桌面应用内的本地应用;付费会员还可以将其发布为带公开链接的网页应用。
+- **共享项目** —— 邀请同事或虚拟助理加入,将每条待办分配给人或智能体。
-**了解内置智能体 →** [orkas.ai/agents](https://orkas.ai/agents/?source=gh-orkas) · **浏览全部 30 个 →** [智能体 marketplace](https://orkas.ai/views/marketplace/gs/agents/?source=gh-orkas) · 或者直接描述你的需求,让指挥官为你定制一个。
+云同步、共享项目、语音输入和网页应用发布属于安装版功能,其余多数能力也可在源码版使用。
---
-## 为什么选 Orkas
+## 团队能交付什么
+
+- **视频、配音与图片** —— VideoStudio、VoiceStudio、ImageStudio
+- **研究报告、SEO 审计与市场分析** —— DeepResearcher、SeoGeoAgent、StockAnalyser
+- **帖子、文章、简报与幻灯片** —— ContentWriter、PptMaker
+- **网站、UI 与代码** —— UIDesigner、ProductDeveloper
+- **Word、Excel、PowerPoint 与 PDF 文件** —— OfficeWorker
+- **电商工作** —— 5 个电商智能体负责选品、商品文案、评价分析、经营分析与商品运营
-- **超强指挥官** —— 理解上下文、拆解目标、选择合适的智能体、技能、连接器和工具;当没有更合适的专家时,也能直接处理分析、写作、调研、文件处理和自动化。
-- **驱动开源生态** —— 以本地会话接入外部 CLI 智能体——编程智能体 Claude Code、Codex、OpenCode,以及个人智能体 OpenClaw、Hermes-Agent——并把 HyperFrames 等开源项目作为本地工具接入,全部由同一个指挥官协调。
-- **本地优先设计** —— 对话、文件、API key、知识库、自定义智能体全部留在你的硬盘上。模型调用从你的机器直连服务商,绝不经过 Orkas 服务器。
-- **无厂商锁定** —— 不同智能体可混用不同服务商:一个用 Claude,一个用 DeepSeek,一个接本地模型端点。
-- **会自我进化的智能体** —— 每个智能体拥有自己私有的技能与记忆,并在每次任务后通过复盘自我改进。
+16 个专业智能体随应用内置,各有自己的技能、记忆和工具。[智能体库](https://orkas.ai/views/marketplace/gs/agents/?source=gh-orkas)中有 30+ 个智能体可供选择;也可以描述所需角色,让指挥官为你创建自定义智能体。
-> ⭐ 如果 Orkas 对你有用,点个 star 能帮助更多人发现这个项目。
+<details>
+<summary><b>全部 16 个内置智能体</b></summary>
+
+| 领域 | 智能体 | 交付内容 |
+| --- | --- | --- |
+| 研究与分析 | **DeepResearcher** | 核实来源、标记矛盾,交付有依据、可追溯的研究报告 |
+| | **SeoGeoAgent** | 从 URL 开始,审计技术 SEO、内容质量、Core Web Vitals 和 AI 回答引用能力(GEO),按优先级列出修复项 |
+| | **StockAnalyser** | 股票研究、因子筛选、回测与组合风险检查,附可追溯的数据看板 |
+| 内容与媒体 | **ContentWriter** | 将目标、来源或初稿写成可发布的帖子、文章、简报与案例 |
+| | **PptMaker** | 从主题、大纲或文档制作可编辑、可审核的 PPTX 幻灯片 |
+| | **ImageStudio** | 海报、封面、社媒图片与信息图 |
+| | **VideoStudio** | 视频制作与编辑,包括旁白、AI 主播、字幕、配音、片段提取与本地化 |
+| | **VoiceStudio** | 旁白、多角色音频、转写与字幕、音频编辑和混音 |
+| | **UIDesigner** | 从产品目标、PRD、截图或 Figma 素材制作以 HTML 为主的可编辑 UI |
+| 开发与办公 | **ProductDeveloper** | 理解代码仓库,落实 PRD、修复缺陷、重构和审查代码,交付可验证的结果 |
+| | **OfficeWorker** | 创建、编辑、检查和交付 Word、Excel、PowerPoint 与 PDF,支持单份或批量处理 |
+| 电商 | **ECommerceResearcher** | 按预算、市场和采购限制筛选产品,给出候选、淘汰理由和验证计划 |
+| | **ECommerceWriter** | 按品牌语气撰写标题、详情页、FAQ、图片文案与视频脚本 |
+| | **ECommerceReviewer** | 分析评价与口碑,归纳客户主题、差评根因和改进优先级 |
+| | **ECommerceAnalyzer** | 从导出文件核对销售、利润、广告、退款与库存指标,给出经营建议 |
+| | **ECommerceOperator** | 规划商品、价格、促销与库存调整,仅通过你已连接的工具执行 |
+
+了解各智能体 → [orkas.ai/agents](https://orkas.ai/agents/?source=gh-orkas)
+
+</details>
---
-## 下载
+## 一起运行 Claude Code、Codex 和 OpenCode
+
+Orkas 将你已安装的 CLI 智能体作为本地会话运行,与内置专业智能体一起工作:包括编程智能体 **Claude Code、Codex 和 OpenCode**,以及个人智能体 **OpenClaw 和 Hermes-Agent**。指挥官协调分工,并在它们之间保持同一份计划,让一个对话完成缺陷修复、变更审查和发布说明撰写。HyperFrames 等开源工具也可接入同一工作流。
+
+[一起使用 Claude Code 和 Codex →](https://orkas.ai/blog/claude-code-codex-together/?source=gh-orkas)
+
+---
+
+## 为什么选择 Orkas
-macOS 和 Windows 提供安装包。基于 glibc 的 Linux x64/arm64 目前需从源码运行 —— 见 [快速开始](#快速开始)。
+- **会规划、分工,也会亲自完成工作的指挥官** —— 拆解目标,选择合适的智能体、技能、连接器与工具;没有更合适的专业智能体时,亲自处理分析、写作、研究和文件工作。
+- **本地优先** —— 对话、文件、知识库和自定义智能体默认保存在本机,安装版可选择开启云同步。使用自己的 Key 时,模型调用从本机直连服务商;内置 Orkas 模型通过 Orkas 托管服务运行。
+- **模型随时可切换** —— 指挥官与内置智能体共用一个模型设置,可选择内置 Orkas 模型、自有服务商或本地端点;外接 CLI 智能体保留各自的模型设置。
+- **能积累经验的智能体** —— 各自保留私有技能与记忆,在被纠正、错误恢复或遇到已知弱项等信号触发时反思,改进后续工作。
+- **开源、可审查** —— MIT 许可证,可以查看 Orkas、智能体与技能的具体实现。
-[下载 Orkas](https://orkas.ai/download/?source=gh-orkas&entry_point=github_readme&download=1)
+> ⭐ 如果 Orkas 对你有用,点一颗 Star 能帮助更多人发现它。
---
-## 你能用它做什么?
+## 下载
+
+| | 安装版(推荐) | 源码版 |
+| --- | --- | --- |
+| 平台 | macOS 12+(Apple Silicon 与 Intel)、Windows 10+ | macOS、Windows、glibc 2.34+ Linux x64/arm64 |
+| 账号 | 登录即送 500 积分 | 无需账号 |
+| 模型 | 内置 Orkas 模型,或使用自己的 Key | 自己的 Key,或本地模型端点 |
+| 另含 | 云同步、共享项目、语音输入、网页应用发布 | — |
+| 获取方式 | **[下载 Orkas](https://orkas.ai/download/?source=gh-orkas&entry_point=github_readme&download=1)** | [快速开始](#快速开始) |
+
+下载链接会识别你的系统,并开始下载对应安装包。
+
+---
-- **自动化周期性报告与市场调研** —— 一个专业智能体负责收集、汇总并产出每周报告。
-- **把产品需求拆成开发任务** —— 指挥官把 PRD 拆成任务,分派给多个智能体。
-- **与你的文档对话、做本地数据分析** —— 拖入文件,数据全程留在本机。
-- **不止于代码 —— 视频、幻灯片等** —— 指挥官可驱动 HyperFrames 等开源工具,并把任务交接给 CLI 智能体——编程智能体 Claude Code、Codex、OpenCode,以及个人智能体 OpenClaw、Hermes-Agent——及其他本地智能体,于是一个对话就能产出代码、研究、视频与幻灯片。
+## 使用场景
-**查看使用场景 →** [研究工作流](https://orkas.ai/use/researchers?source=gh-orkas) · [数据分析](https://orkas.ai/use/data-analysis?source=gh-orkas) · [与文档对话](https://orkas.ai/use/chat-with-documents?source=gh-orkas) · [面向开发者](https://orkas.ai/use/developers?source=gh-orkas) · [自动化你的工作区](https://orkas.ai/use/automate-workspace?source=gh-orkas)
+- **营销内容** —— 用你的品牌语气制作发布视频、产品页面、帖子与简报。[内容写作](https://orkas.ai/use/content-writing/?source=gh-orkas) · [视频](https://orkas.ai/use/make-videos/?source=gh-orkas)
+- **店铺经营** —— 销售周报、评价回复、商品文案与竞品检查。[电商](https://orkas.ai/use/ecommerce/?source=gh-orkas)
+- **研究与报告** —— 按需或定期交付带来源的报告与幻灯片。[研究](https://orkas.ai/use/researchers/?source=gh-orkas) · [数据分析](https://orkas.ai/use/data-analysis/?source=gh-orkas)
+- **和文档对话** —— 基于你自己的文件回答问题,并标注来源段落,方便核对。[文档问答](https://orkas.ai/use/chat-with-documents/?source=gh-orkas)
+- **客户项目** —— 按你的模板制作会议简报、客户月报与进度幻灯片。[客户月报模板](https://orkas.ai/blog/monthly-client-report-template/?source=gh-orkas)
+- **产品发布** —— 落地页、带测试的缺陷修复、更新日志与发布帖子。[面向开发者](https://orkas.ai/use/developers/?source=gh-orkas)
+- **做应用** —— 报价计算器、预约表单、内部工具。[做应用](https://orkas.ai/use/build-apps/?source=gh-orkas)
+- **小团队协作** —— 人与智能体在同一个项目里协作。[小团队](https://orkas.ai/use/small-teams/?source=gh-orkas)
---
@@ -78,51 +130,65 @@ macOS 和 Windows 提供安装包。基于 glibc 的 Linux x64/arm64 目前需
| 工具 | 它是什么 | Orkas 的不同之处 |
| --- | --- | --- |
-| **LangChain** | 面向开发者的框架/库,用于构建 LLM 应用与智能体 —— 代码优先,嵌入你自己的 Python/JS 应用中。 | Orkas 是一个通过对话指挥的本地优先多智能体桌面应用,而不是靠你写编排代码。数据与 key 默认留在本地。 |
-| **CrewAI** | 一个 Python 框架,用于编排扮演角色的自治智能体 —— 你用代码定义 crew 和智能体。 | Orkas 把多智能体编排带进桌面应用,内置**本地优先存储**与每个智能体的自我进化。 |
-| **云端智能体平台**(SaaS 编排器) | 服务器托管;对话、文件、API key 都存在厂商的基础设施上。 | Orkas **本地优先**:一切留在你的机器上,模型 API 调用直连服务商 —— 绝不被 Orkas 归档。 |
-| **OpenClaw** | 一个常驻的单一个人助理,跨即时通讯渠道触达你。 | Orkas 给你的是一支团队而非单个助理:指挥官在一个桌面对话里协调多个专业智能体,且 OpenClaw 可作为 Orkas 的 CLI 后端接入。 |
-| **Hermes-Agent** | Nous Research 的自我改进个人智能体(TUI + 多渠道网关)。 | Orkas 是一个本地优先的多智能体桌面应用,每个智能体拥有私有技能与元认知 —— 且 Hermes-Agent 可作为 Orkas 的 CLI 后端接入。 |
+| **Claude Cowork** | Anthropic 基于 Claude 构建的桌面智能体体验。 | Orkas 开源(MIT),可使用内置 Orkas 模型或自有服务商,并协调 Claude Code、Codex、OpenCode 与内置专业智能体。[Claude Cowork 替代方案 →](https://orkas.ai/compare/claude-cowork-alternatives/?source=gh-orkas) |
+| **LangChain** | 面向开发者的 LLM 应用与智能体框架,通过代码嵌入 Python/JS 应用。 | Orkas 是通过对话指挥的桌面应用,数据默认保存在本地。 |
+| **CrewAI** | 通过 Python 代码定义团队与角色、编排自治智能体的框架。 | Orkas 将多智能体编排做成桌面应用,内置项目、待办、自动化与各智能体的经验积累。 |
+| **OpenClaw** | 跨消息渠道与你联系的常驻个人助理。 | Orkas 协调一支团队,OpenClaw 也可作为其中一个 CLI 智能体接入。 |
+| **Hermes-Agent** | Nous Research 的自我改进智能体,具备记忆与技能,提供 CLI、消息网关和桌面版。 | Orkas 由指挥官协调多个专业智能体与外部 CLI 智能体,Hermes-Agent 也可作为其中一员接入。 |
-**如果你想要的是:**一支智能体团队而非单个助理、一个支持拖入文件与可视化管理智能体的桌面 GUI、并希望数据/key/智能体都在自己的硬盘上而非厂商云端 —— 那么 Orkas 适合你。
+**适合你,如果你希望:**让智能体团队协作,跨天持续推进工作,并将数据、Key 与智能体默认保存在自己的硬盘上。
-**以下情况 Orkas 不适合你:**只想要一个万能单点聊天机器人、想要一个数据托管在厂商服务器上的全云端团队、或想要一个嵌入自己应用的纯代码库。
+**不适合你,如果你只需要:**一个通用聊天机器人,或嵌入自己应用的纯代码框架。
-**逐项对比 →** [vs Claude Code](https://orkas.ai/compare/orkas-vs-claude-code?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)
+**选择编程智能体?** [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 替代方案](https://orkas.ai/compare/claude-code-alternatives/?source=gh-orkas)
+
+**逐项对比 →** [vs Claude Code](https://orkas.ai/compare/orkas-vs-claude-code?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)
---
## 常见问题(FAQ)
**Orkas 是什么?**
-Orkas 是一个开源、本地优先的多智能体桌面应用。一个超强指挥官规划你的目标,并协调多个专业智能体共同完成 —— 其中 9 个随应用内置。不是单个聊天机器人,不是代码框架,也不是托管 SaaS。
+Orkas 是开源(MIT)、本地优先的多智能体桌面应用。指挥官将目标拆成待办,协调 16 个内置专业智能体,以及 Claude Code、Codex、OpenCode、OpenClaw 和 Hermes-Agent,交付成品文件。
+
+**需要 API Key 吗?**
+不需要。安装版赠送 500 积分,可直接使用内置 Orkas 模型。用完后可购买积分、选择付费会员,或添加自己的模型服务商 Key;自有服务商的费用单独计算。
**Orkas 是本地大模型吗?**
-不是。Orkas 运行在你的机器上,但通过你自己的 API key(或本地模型端点)调用你选择的模型。它编排智能体与工具,本身不是模型。
+不是。Orkas 在你的电脑上运行,调用你选择的内置 Orkas 模型、自有 API Key 或本地模型端点。它负责协调智能体与工具,本身不是模型。
+
+**能基于我的文档回答问题,并标注出处吗?**
+可以。把 PDF 和文档加入本地资料库,Orkas 可搜索这些文件,并在回答中引用来源段落,方便打开原文核对。索引在本机建立。
+
+**能使用 Ollama、LM Studio 等本地模型吗?**
+可以。打开 **账号设置 → 模型 → 对话 → 添加模型 → 自定义**,选择 **OpenAI 兼容** 或 **Anthropic 兼容**,填写基础地址、准确的模型 ID 和 API Key,然后在任务的模型控件中选择已保存的模型。
+
+**API Key 和数据存在哪里?**
+默认保存在本机。你自己的服务商 Key 在本地加密保存,并排除在云同步之外。使用自己的 Key 时,模型调用从本机直连服务商;内置 Orkas 模型使用 Orkas 托管服务。安装版的可选云同步和共享项目会将所选数据保存在 Orkas 服务器上。[安全与数据处理 →](https://orkas.ai/security/?source=gh-orkas)
-**能用 Ollama、LM Studio 这类本地模型吗?**
-可以。打开 **账号设置 → 模型 → 对话 → 添加模型 → 自定义**,选择 **OpenAI 兼容** 或 **Anthropic 兼容** 协议,填写基础地址、准确模型 ID 和 API key。保存后,在任务输入框的模型控件中选择该模型。
+**Orkas 能完全离线使用吗?**
+源码版配合本地模型端点可以完全离线运行。安装版需要登录,云端模型调用需要联网。
-**我的 API key 和数据存在哪里?**
-在你的硬盘上。对话、文件、知识库、智能体和 key 都留在本地;模型调用从你的机器直连服务商,绝不被 Orkas 代理或归档。
+**电脑关机后还会继续工作吗?**
+不会。Auto-advance 和定时自动化需要电脑保持唤醒,且 Orkas 正在运行。从 1.9 起,电脑唤醒或应用启动后,每个自动化会补跑 12 小时内最近一次错过的任务。
-**Orkas 能离线用吗?**
-应用本身可完全离线运行 —— 只有模型调用需要网络。把智能体指向本地模型端点,就能脱离云端运行。
+**能做应用和发布应用吗?**
+可以。在 Orkas 内运行的本地应用免费。将网页应用发布为公开链接需要付费会员,Lite、Pro、Max 分别可发布 5、8、15 个;公开网页应用不包含 Orkas 桌面应用内的全部能力。
-**需要注册 Orkas 账号吗?**
-安装包版本在首次启动时会要求登录。本仓库的源码版本完全没有账号模块,启动后直接进入应用。两种方式下,模型 key 都是你自己的,并且留在本机。
+**需要 Orkas 账号吗?**
+安装版首次启动时需要登录。本仓库的源码版没有账号模块,启动后直接进入应用。
-**Orkas 能驱动 Claude Code 等 CLI 智能体吗?**
-能。除了自己的指挥官与专业智能体,Orkas 还能把五个外部 CLI 智能体作为本地子进程驱动:编程智能体 Claude Code、Codex、OpenCode,以及个人智能体 OpenClaw、Hermes-Agent;并接入 HyperFrames 等开源项目,全部在同一个对话里指挥。
+**能驱动 Claude Code 等 CLI 智能体吗?**
+可以。Orkas 能将五个外部 CLI 智能体作为本地子进程运行:Claude Code、Codex、OpenCode、OpenClaw 和 Hermes-Agent;也可接入 HyperFrames 等开源工具,在同一个对话中协调工作。
-**Orkas 和 Claude Desktop / CrewAI / LangChain 有什么不同?**
-Claude Desktop 是单个助理;CrewAI 和 LangChain 是代码优先的框架。Orkas 是一个本地优先的多智能体桌面应用:指挥官协调多个专业智能体,数据与 key 留在本地,每个智能体拥有私有技能与记忆。见[逐项对比](https://orkas.ai/compare/orkas-vs-langchain?source=gh-orkas)。
+**和 Claude Cowork、Claude Desktop、CrewAI、LangChain 有什么不同?**
+Claude Cowork 和 Claude Desktop 基于 Claude;CrewAI 和 LangChain 是代码优先的框架。Orkas 是开源桌面应用,由指挥官协调专业智能体与 CLI 智能体,可选择不同模型服务商,数据与 Key 默认保存在本地。[查看完整对比](https://orkas.ai/compare/?source=gh-orkas)。
**支持哪些平台?**
-macOS(Apple 芯片与 Intel)和 Windows 10+ 提供安装包。基于 glibc 2.34+ 的 Linux x64/arm64 目前从源码运行,暂时没有安装包。本地语音转写通过首次启动时准备的固定版本 whisper.cpp 运行时提供。当前不支持 Alpine 及其他基于 musl 的发行版。源码启动需要 Node 22.12+;只有在原生 npm 包没有匹配的预编译二进制、必须本地编译时,才额外需要 Python 3 和 C/C++ 构建工具链。
+macOS 12+(Apple Silicon 与 Intel)和 Windows 10+ 提供安装包。glibc 2.34+ Linux x64/arm64 目前通过源码运行,尚无安装包;首次启动会准备固定版本的 whisper.cpp 运行时,支持本地语音转写。不支持 Alpine 等基于 musl 的发行版。源码启动需要 Node 22.12+;只有原生 npm 包缺少兼容的预编译文件、需要本地重建时,才需要 Python 3 和 C/C++ 构建工具链。
**Orkas 免费且开源吗?**
-是的 —— 应用本身 MIT 许可证、免费使用。自带模型 key 时,你只需为你的模型服务商付费,Orkas 不抽成。此外,桌面版还提供一个可选的内置 **Orkas 模型**,供不想自己配置 key 的用户使用 —— 这部分由 Orkas 按 credits 计费(会员或 credits 包)。它完全可选,其余所有功能用你自己的 key 即可。[价格 →](https://orkas.ai/pricing/?source=gh-orkas)
+是的,应用采用 MIT 许可证,可免费使用。安装版赠送 500 积分;付费会员每月 $11.99 起,增加月度积分、云同步、更多共享项目和网页应用发布能力。使用自己的 Key 时,模型用量由服务商计费,Orkas 不加价。[价格 →](https://orkas.ai/pricing/?source=gh-orkas)
---