Orkas is an open-source desktop agent harness and workflow orchestrator developed by Orkas-AI. Built to bridge autonomous AI execution with local operating system environments, it manages agent task lifecycles, structured desktop integrations, and persisted execution state across tasks. In practical use, Orkas functions as an orchestration layer that executes agentic workflows locally. It coordinates task-scoped permissions, controls access to host resources, handles desktop rendering and window continuity, and processes multi-modal inputs using integrated local subsystems like embedded Whisper runtimes for audio and voice commands. Orkas distinguishes itself from purely terminal-bound coding harnesses by focusing on desktop-level task orchestration, combining file and office document reading, structural runtime verification, and explicit task-level access controls with deterministic agent recovery paths. Orkas is published under an open-source license on GitHub and supports cross-platform environments including Windows, macOS, and Linux.
Desktop agent orchestration — Coordinates execution loops, persistent results, and recovery paths for autonomous desktop tasks. - Task-scoped permission grants — Enforces bounded execution safety and local filesystem/system access restrictions on a per-task basis. - Embedded Whisper integration — Bundles local Whisper audio processing for voice-driven developer and agent workflows. - Structured document processing — Provides batched office document parsing and structural checks natively within the harness runtime. - Cross-platform runtime — Supports cross-compilation and native execution across Windows, Linux, and macOS environments.
Use cases
Use Case: Desktop Task Automation Developers use Orkas to orchestrate multi-step agent workflows that interact directly with local desktop environments, filesystem resources, and local tools under explicit permission boundaries.
Use Case: Local Multimodal and Voice Interaction Teams integrate local Whisper-driven audio capture to trigger, direct, and monitor automated orchestration tasks without sending raw audio to cloud endpoints.
Use Case: Document and Workspace Batch Verification Engineers run automated analysis agents across local repositories and office documents to perform structural validation and persist execution reports.
Who it is for
Orkas is designed for developers and systems engineers seeking an open-source, local-first agent harness capable of bridging terminal commands with desktop workflow orchestration. It is less suitable for teams looking solely for a lightweight, single-file CLI coding assistant that lives strictly inside an IDE or shell prompt.
Install guide
Installation Clone the repository and build the project using standard platform build scripts: bash git clone https://github.com/Orkas-AI/Orkas.git cd Orkas # Install project dependencies npm install # Build binaries and packaged resources npm run build
First Run Configure your environment keys and start the runtime: bash export OPENAI_API_KEY="your-api-key" npm start
Example Session Launch Orkas in headless or desktop mode to initialize a task-scoped orchestration plan: bash orkas run --task "Analyze structural integrity of docs/ and output status report" --grant local-read
nanoclaw — nanoclaw is an open-source CLI agent framework and containerized execution harness developed by Nanoco AI. Designed around Claude-powered workflows and…
Hermes Agent — Hermes Agent is an open-source terminal-based AI coding agent developed by NousResearch. Designed to bridge terminal workflows and modern IDE…
Nullclaw — Nullclaw is an open-source, lightweight AI coding assistant and agent harness designed to operate with minimal overhead. Developed using Zig…
SWE-agent — SWE-agent is an open-source autonomous software engineering agent harness built and maintained by researchers from Princeton University and Stanford University.…
Stratless — Stratless is an open-source agent harness and execution orchestrator developed by the Stratless AI team. It provides a modular infrastructure…
Agentic Engineering Framework — Agentic Engineering Framework is an open-source orchestration harness and governance layer developed by Dimitri Geelen. It is designed to constrain,…