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.

docs: restructure README top for first-screen clarity

cxwaf673d4ceda4
diff --git a/README.md b/README.md
index 63bae7c5..5c21123f 100644
--- a/README.md
+++ b/README.md
@@ -1,8 +1,8 @@
# Orkas
-**An open-source, local-first AI workforce for complex work.**
+**Command a team of AI agents from one desktop chat — not one chatbot.**
-Orkas is an open-source, local-first AI workforce. A super-powered **Commander** coordinates specialist agents to complete complex work together. It runs as a desktop app on macOS, Windows, and Linux; your conversations, files, agent configs, and model keys stay local, and model calls go straight to your provider.
+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.
[![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)
@@ -12,26 +12,58 @@ Orkas is an open-source, local-first AI workforce. A super-powered **Commander**
[English](./README.md) · [简体中文](./README.zh-CN.md)
+---
+
+**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 demo](./resources/app-ui/demo.gif)
-> One super-powered Commander turns your goal into an executable path, does the general work itself, and coordinates specialist agents when the job needs a team. No flowcharts, no orchestration code. Your conversations, files, and API keys never leave your machine.
+---
+
+## Agents that ship with the app
+
+Installed and ready the first time you launch Orkas — each with its own skills, memory, and tools.
+
+| 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 |
+
+**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.
---
-## What is Orkas?
+## Why Orkas
-- **Open-source, local-first AI workforce** — a desktop GUI where you direct a coordinated workforce of specialist AI agents through one chat. Not a single chatbot, not a code framework, not a hosted SaaS.
-- **A super-powered Commander** — the Commander understands context, breaks down goals, chooses the right agents, skills, connectors, and tools, and directly handles general analysis, writing, research, file work, and automation when no specialist is a better fit.
-- **Specialist agents that work together** — agents can run in parallel or in sequence, each with focused skills, memory, and task context, so complex work can move across coding, research, data, video, and slides.
-- **Open-source ecosystem, locally orchestrated** — plug in external CLI coding agents (Claude Code, Codex, OpenCode, Cline) and onboard open-source projects like HyperFrames as local tools, all coordinated by the same Commander.
+- **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 coding agents (Claude Code, Codex, OpenCode, Cline) 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.
-- **Bring your own LLM keys** — plug in Claude, OpenAI, Gemini, DeepSeek, Kimi, GLM, Qwen, MiniMax, or Doubao. Mix providers across agents. No vendor lock-in.
+- **No vendor lock-in** — mix providers across agents: one on Claude, another on DeepSeek, another on a local endpoint.
- **Self-evolving workforce** — each agent has its own private skills and memory, and improves through reflection after each task.
> ⭐ If Orkas is useful to you, a star helps more people find the project.
---
+## Download
+
+Packaged installers for macOS and Windows. Linux runs from source today — see [Quick start](#quick-start).
+
+- **macOS Apple Silicon** -> [Orkas-mac-arm64.dmg](https://orkas.ai/download/?source=gh-orkas&entry_point=github_readme&os=mac&arch=arm64&download=1)
+- **macOS Intel** -> [Orkas-mac-x64.dmg](https://orkas.ai/download/?source=gh-orkas&entry_point=github_readme&os=mac&arch=x64&download=1)
+- **Windows x64** -> [Orkas-Setup.exe](https://orkas.ai/download/?source=gh-orkas&entry_point=github_readme&os=win&download=1)
+
+---
+
## What can you build with it?
- **Automate recurring reports & market research** — a specialist agent gathers, summarizes, and ships a weekly report.
@@ -43,13 +75,6 @@ Orkas is an open-source, local-first AI workforce. A super-powered **Commander**
---
-## Download
-
-- **Get the app** → [orkas.ai](https://orkas.ai?source=gh-orkas) (macOS · Windows installers)
-- **Run from source** → see [Quick start](#quick-start) below (currently required on Linux)
-
----
-
## How Orkas compares
| Tool | What it is | How Orkas differs |
@@ -95,13 +120,7 @@ Yes — the app is MIT licensed and free to use. Bring your own model keys and y
## Quick start
-Packaged installers are currently available for macOS and Windows. Linux users should follow the source instructions below.
-
-- **macOS Apple Silicon** -> [Orkas-mac-arm64.dmg](https://orkas.ai/download/?source=gh-orkas&entry_point=github_readme&os=mac&arch=arm64&download=1)
-- **macOS Intel** -> [Orkas-mac-x64.dmg](https://orkas.ai/download/?source=gh-orkas&entry_point=github_readme&os=mac&arch=x64&download=1)
-- **Windows x64** -> [Orkas-Setup.exe](https://orkas.ai/download/?source=gh-orkas&entry_point=github_readme&os=win&download=1)
-
-To run from source:
+Want a packaged installer instead? See [Download](#download) above. To run from source — currently the way to run Orkas on Linux:
**Requirements**: Node 20+ · Python 3 · macOS / Windows 10+ / recent Linux
diff --git a/README.zh-CN.md b/README.zh-CN.md
index 2d5d4801..5daad06e 100644
--- a/README.zh-CN.md
+++ b/README.zh-CN.md
@@ -1,8 +1,8 @@
# Orkas
-**开源、本地优先的 AI 工作团队,用来协同完成复杂工作。**
+**在一个桌面对话里指挥一支 AI 智能体团队 —— 而不是单个聊天机器人。**
-Orkas 是一个开源、本地优先的 AI 工作团队。一个超强**指挥官**会协调多个专业智能体,共同完成复杂工作。它是运行在 macOS、Windows、Linux 上的桌面应用;你的对话、文件、智能体配置和模型 key 默认留在本机,模型调用直连你选择的服务商。
+Orkas 是一个开源、本地优先的多智能体桌面应用。你描述目标,**指挥官**规划路径、亲自完成通用部分,并调度专业智能体并行或串行执行。**9 个专业智能体随应用内置**,启动即可用,marketplace 中共有 30 个。自带模型 key —— Claude · OpenAI · Gemini · DeepSeek · Kimi · GLM · Qwen · MiniMax · Doubao。支持 macOS · Windows · Linux。
[![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)
@@ -12,26 +12,58 @@ Orkas 是一个开源、本地优先的 AI 工作团队。一个超强**指挥
[English](./README.md) · [简体中文](./README.zh-CN.md)
+---
+
+**你:**“调研这个领域的 5 个竞品,写成报告,再做成一份 PPT。”
+
+**Orkas:** 指挥官把目标拆成步骤,分派给专业智能体 —— **DeepResearcher** 检索并核验来源,**ContentWriter** 撰写报告,**PptMaker** 制作幻灯片。同一个对话、同一份计划,成品文件落在你的硬盘上。
+
![Orkas 演示](./resources/app-ui/demo.gif)
-> 一个超强指挥官会把你的目标转成可执行路径,亲自处理通用工作,并在任务需要团队时协调专业智能体。无需流程图、无需编排代码。你的对话、文件和 API key 始终不离开本机。
+---
+
+## 随应用内置的智能体
+
+首次启动 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 可引用性评分、健康分与分级行动清单 |
+
+**了解内置智能体 →** [orkas.ai/agents](https://orkas.ai/agents/?source=gh-orkas) · **浏览全部 30 个 →** [智能体 marketplace](https://orkas.ai/views/marketplace/gs/agents/?source=gh-orkas) · 或者直接描述你的需求,让指挥官为你定制一个。
---
-## Orkas 是什么?
+## 为什么选 Orkas
-- **开源、本地优先的 AI 工作团队** —— 一个桌面 GUI,让你在同一个对话里指挥多个协同工作的专业智能体。不是单个聊天机器人,不是代码框架,也不是托管 SaaS。
-- **超强指挥官** —— 指挥官理解上下文、拆解目标、选择合适的智能体、技能、连接器和工具;当没有更合适的专家时,也能直接处理分析、写作、调研、文件处理和自动化。
-- **专业智能体共同完成复杂工作** —— 智能体可以并行或串行执行,每个智能体都有自己的技能、记忆和任务上下文,复杂工作可以跨代码、研究、数据、视频和幻灯片推进。
-- **本地编排开源生态** —— 接入外部 CLI 编程智能体(Claude Code、Codex、OpenCode、Cline),并把 HyperFrames 等开源项目作为本地工具接入,全部由同一个指挥官协调。
+- **超强指挥官** —— 理解上下文、拆解目标、选择合适的智能体、技能、连接器和工具;当没有更合适的专家时,也能直接处理分析、写作、调研、文件处理和自动化。
+- **驱动开源生态** —— 接入外部 CLI 编程智能体(Claude Code、Codex、OpenCode、Cline),并把 HyperFrames 等开源项目作为本地工具接入,全部由同一个指挥官协调。
- **本地优先设计** —— 对话、文件、API key、知识库、自定义智能体全部留在你的硬盘上。模型调用从你的机器直连服务商,绝不经过 Orkas 服务器。
-- **自带大模型 key** —— 接入 Claude、OpenAI、Gemini、DeepSeek、Kimi、GLM、Qwen、MiniMax、Doubao,不同智能体可混用不同服务商,无厂商锁定。
+- **无厂商锁定** —— 不同智能体可混用不同服务商:一个用 Claude,一个用 DeepSeek,一个接本地模型端点。
- **自我进化的工作团队** —— 每个智能体拥有自己私有的技能与记忆,并在每次任务后通过复盘自我改进。
> ⭐ 如果 Orkas 对你有用,点个 star 能帮助更多人发现这个项目。
---
+## 下载
+
+macOS 和 Windows 提供安装包。Linux 目前需从源码运行 —— 见 [快速开始](#快速开始)。
+
+- **macOS Apple 芯片** → [Orkas-mac-arm64.dmg](https://orkas.ai/download/?source=gh-orkas&entry_point=github_readme&os=mac&arch=arm64&download=1)
+- **macOS Intel** → [Orkas-mac-x64.dmg](https://orkas.ai/download/?source=gh-orkas&entry_point=github_readme&os=mac&arch=x64&download=1)
+- **Windows x64** → [Orkas-Setup.exe](https://orkas.ai/download/?source=gh-orkas&entry_point=github_readme&os=win&download=1)
+
+---
+
## 你能用它做什么?
- **自动化周期性报告与市场调研** —— 一个专业智能体负责收集、汇总并产出每周报告。
@@ -43,13 +75,6 @@ Orkas 是一个开源、本地优先的 AI 工作团队。一个超强**指挥
---
-## 下载
-
-- **获取应用** → [orkas.ai](https://orkas.ai?source=gh-orkas)(macOS · Windows 安装包)
-- **从源码运行** → 见下方 [快速开始](#快速开始)(Linux 当前需使用此方式)
-
----
-
## Orkas 与同类工具对比
| 工具 | 它是什么 | Orkas 的不同之处 |
@@ -95,13 +120,7 @@ Claude Desktop 是单个助理;CrewAI 和 LangChain 是代码优先的框架
## 快速开始
-目前 macOS 和 Windows 提供安装包;Linux 用户请按照下方步骤从源码运行。
-
-- **macOS Apple 芯片** → [Orkas-mac-arm64.dmg](https://orkas.ai/download/?source=gh-orkas&entry_point=github_readme&os=mac&arch=arm64&download=1)
-- **macOS Intel** → [Orkas-mac-x64.dmg](https://orkas.ai/download/?source=gh-orkas&entry_point=github_readme&os=mac&arch=x64&download=1)
-- **Windows x64** → [Orkas-Setup.exe](https://orkas.ai/download/?source=gh-orkas&entry_point=github_readme&os=win&download=1)
-
-从源码运行:
+想直接用安装包?见上方 [下载](#下载)。以下是从源码运行的方式 —— 也是目前在 Linux 上运行 Orkas 的方式:
**环境要求**:Node 20+ · Python 3 · macOS / Windows 10+ / 较新的 Linux