Model or dataset
Orkas-AI/Orkas avatar
Orkas-AI/Orkas

Orkas: a local-first multi-agent desktop client you drive from one chat

Open-source multi-agent AI desktop client — build and command your AI agent team through conversation. A commander LLM dispatches sub-agents in parallel or in series; agents self-evolve via reflection and skill crystallization. Local-first, BYO LLM keys (Claude · OpenAI · Gemini · DeepSeek · Kimi · GLM · Qwen). macOS / Windows / Linux.

2,131 stars85 forksTypeScriptMIT

At a glance

What is it?
Orkas is an MIT-licensed Electron app where a Commander model plans a goal and dispatches specialist agents in parallel or in series, with your own model keys and files staying on disk. Here is how it installs, how the orchestration works, and where the design runs out of road.
Who is it for?
Adopt Orkas if you want multi-agent orchestration without writing Python crew definitions, you are comfortable supplying your own provider keys, and you value that conversations, files and keys stay on your disk. Skip it if you need a library embedded inside an existing application, a server-hosted orchestrator your whole team can share, or a Linux package you can install in one step.
Can I use it commercially?
Yes. MIT is a permissive licence: you can use, modify and sell software built on it, as long as you keep its copyright and licence notices.
Is it still maintained?
Yes. The repository last received commits 3 days ago.
What is it written in?
Mainly TypeScript, according to GitHub's language statistics.

Answers come from the project's GitHub data, last synced on September 28, 2026, and from our analysis. They are not legal advice.

Editorial analysis

What Orkas actually solves, and for whom

Most people running multi-agent workflows today write orchestration code. CrewAI and LangChain both expect you to define agents, roles and task graphs in Python or JavaScript, then run them from a script. That is fine if you are building a product. It is a poor fit if you are a researcher, analyst or developer who wants the orchestration to exist as a tool you open, not as a repository you maintain.

Orkas takes the opposite position. It is a desktop application, built on Electron with a Node backend (package.json describes it as an "Electron + Node one-piece app"), and the interface is a chat. You describe a goal. A Commander LLM breaks it into steps, handles the general parts itself, and routes the rest to specialist agents. Nine specialists ship installed: DeepResearcher, ContentWriter, PptMaker, ProductDeveloper, OfficeWorker, VideoStudio, ImageStudio, UIDesigner and SeoGeoAgent. The README says thirty exist in the marketplace, and that the Commander can also build a custom agent on request.

The intended user is someone whose work crosses several output types. The README's own example is a single sentence asking for competitor research, a written report and a slide deck; the answer runs that across DeepResearcher, ContentWriter and PptMaker from one plan. If your tasks are all code, or all writing, a single strong chat client with good file handling covers most of it. Orkas earns its complexity when a goal genuinely spans research, documents, slides and code in one pass.

How the Commander dispatches specialist agents

The architecture visible in the repository is a Commander plus a registry of agents, each with its own skills, memory and tools. The Commander receives the goal, produces a plan, and decides for each step whether to act itself or delegate. Delegation runs in parallel or in sequence, which matters more than it sounds: research and slide generation can overlap, while a report has to finish before a deck can be built from it.

Each agent keeps private skills and memory, and the README states that agents improve through reflection after each task. That is the self-evolution claim, and the mechanism described is reflection followed by skill crystallization, meaning a successful approach gets retained as a reusable skill rather than discarded with the conversation. Because memory is per-agent, a DeepResearcher that has learned your preferred source standards does not transfer that to ContentWriter. That isolation is deliberate and it is also the main reason agent quality drifts unevenly over time.

The model layer is bring-your-own-key. The README lists Claude, OpenAI, Gemini, DeepSeek, Kimi, GLM, Qwen, MiniMax and Doubao, and says you can mix providers across agents, including a local endpoint. Model calls go from your machine to the provider rather than through Orkas servers. The repository also shows an integration surface beyond the built-in agents: external CLI coding agents (Claude Code, Codex, OpenCode, Cline) and open-source projects such as HyperFrames can be onboarded as local tools under the same Commander. The README does not document the permission boundary for those external tools, which is the first thing I would want to know before letting a Commander invoke them unattended.

Installing Orkas and running a first multi-agent task

The fastest path is a packaged installer. The README points macOS Apple Silicon, macOS Intel and Windows x64 users at download links on orkas.ai, and states that glibc-based Linux x64 and arm64 run from source today. There is no Linux package in the download list.

Once installed, the first real step is supplying a model key, since Orkas ships no hosted model of its own. The README does not print the exact settings screen path, so treat the in-app provider configuration as the place to look rather than a documented command.

For Linux, or for anyone who wants to run the current main branch, the repository is an npm project. The package.json sets the package manager and exposes a start script that launches Electron:

bash
npm install
npm start

The prestart hook runs scripts/ensure-dev-dependencies.cjs before Electron launches, so the first start may take longer than later ones. If you are working on the core agent package rather than the shell, the repository separates the type checks:

bash
npm run typecheck:main
npm run typecheck:core-agent

There is also a smoke script for a fast sanity check after changes, and a non-model test aggregate that chains typecheck, unit tests, end-to-end tests, platform-native tests and the smoke run. The README does not give a first prompt to try, but the demo example is a reasonable template: name the deliverable, the number of items and the output format, then let the Commander decide which agents to involve.

Where the local-first design costs you

Local-first is the strongest thing about Orkas and the source of its sharpest limits. Conversations, files, API keys, knowledge bases and custom agents stay on your disk, and model traffic goes directly to the provider. That removes a class of data-residency problems, and it also means there is no shared workspace. Two people on the same team cannot open the same agent team and see the same plan. Every install is its own island, and the README describes no sync or collaboration layer.

The second cost is that you are the operator of the model bill and the model quality. Nine agents across three providers is nine configuration decisions, and a weak model assigned to PptMaker will produce weak decks no matter how good the Commander's plan is. The README presents provider mixing as a feature, which it is, but it also pushes model selection onto the user with no documented guidance on which provider suits which agent.

The third is platform packaging. macOS and Windows get installers; Linux users build from source, which means Node and npm on the machine and a build that the README does not promise is reproducible. If your team standardises on Linux desktops and expects a signed package, Orkas is not there yet. And if your requirement is a library that embeds inside an existing service, Orkas is simply the wrong shape: it is an application, and the orchestration is not exposed as an importable SDK in the documentation available.

Orkas versus CrewAI and LangChain

The README's own comparison table is the honest starting point. LangChain is described as a developer framework and library for building LLM applications, code-first, embedded in your own Python or JavaScript app. CrewAI is described as a Python framework for orchestrating role-playing autonomous agents, where you define crews and agents in code. Orkas is neither. It is a desktop app you direct through chat.

That difference is not cosmetic. In CrewAI, the agent definitions, the task graph and the delegation rules are artifacts in your repository, reviewable in a pull request and diffable over time. In Orkas, the plan is generated per goal by the Commander, which is more flexible and far less auditable. You cannot review the orchestration before it runs unless the app surfaces the plan for approval, and the README does not say that it does.

The other axis is deployment. Cloud agent platforms host conversations, files and keys on vendor infrastructure. Orkas keeps them local and sends model calls straight to the provider. If your constraint is that prompt content must not transit a third party beyond the model vendor, that distinction decides the choice on its own. If your constraint is that a whole team must share one orchestration state, cloud platforms win and Orkas has no answer. The README also contrasts Orkas with OpenClaw, described as a single always-on personal assistant reachable across messaging channels; the difference is one generalist assistant versus a Commander coordinating named specialists.

Licence, maintenance and upgrade cost

Orkas is MIT licensed, and the LICENSE file sits at the repository root. MIT is permissive: you can use, modify and redistribute the code, including commercially, provided the copyright notice and permission notice are retained. That is a statement about the licence text, not legal advice, and it says nothing about the model providers you connect, whose own terms govern the API calls you make through them. The README also links a marketplace of thirty agents; the documentation does not state the licence of marketplace agents separately from the app, so check that before redistributing anything you did not write.

On maintenance: the repository is not archived, and the last push was on 2026-09-09. Releases are dated on a monthly cadence in the repository, with v2026.8.29, v2026.8.25 and v2026.8.11, and package.json carries version 2026.9.11, which is ahead of the newest published release. That gap is normal for a main branch but it does mean the source tree and the installers are not the same thing.

Upgrade cost is mostly the desktop installers, which the README presents as the normal path. Source builds carry the usual Electron burden: Node and npm versions, the prestart dependency check, and the split type checks for the main process and the core agent package. Because agents hold private memory and crystallized skills, an upgrade also raises a question the README does not answer: whether those learned skills survive a version bump or are reset. Verify that before you invest months in tuning an agent.

Editorial conclusion

Adopt Orkas if you want multi-agent orchestration without writing Python crew definitions, you are comfortable supplying your own provider keys, and you value that conversations, files and keys stay on your disk. Skip it if you need a library embedded inside an existing application, a server-hosted orchestrator your whole team can share, or a Linux package you can install in one step. Before committing, verify the Linux source build path in docs/ and the packaged installers on orkas.ai, check which of the nine built-in agents map to your actual work, and confirm the permission model for the CLI coding agents the Commander can hand off to.

Frequently asked questions

How do I install Orkas on macOS or Windows?

Download the packaged installer from the links in the README: Orkas-mac-arm64.dmg for Apple Silicon, Orkas-mac-x64.dmg for Intel Macs, or Orkas-Setup.exe for Windows x64. Linux is not in the download list and runs from source instead.

Does Orkas send my files and API keys to its own servers?

No. The README states that conversations, files, API keys, knowledge bases and custom agents all stay on your disk, and that model calls go straight from your machine to the provider rather than through Orkas servers.

Which model providers can I use with Orkas?

The README lists Claude, OpenAI, Gemini, DeepSeek, Kimi, GLM, Qwen, MiniMax and Doubao, and says you can mix providers across agents, including pointing an agent at a local endpoint.

Official sources

  1. License: MIT
  2. Orkas-AI/Orkas on GitHub
  3. Project website
  4. README
  5. Releases
Add this badge to your README

If you maintain this project, the badge below links readers to this analysis and shows its maintenance status from the daily GitHub snapshot. Paste the markdown into your README; add ?metric=license or ?metric=stars to the image URL for a different field.

Add this badge to your README

markdown
[![Hysen Labs](https://hysenlabs.com/badge/orkas-ai-orkas.svg)](https://hysenlabs.com/projects/orkas-ai-orkas)