apache /maka

Apache Maka (Incubating) is a high-performance agent workspace that keeps a complete record of everything it did.

★ 5,934⑂ 574👁 24▤ 46
TypeScriptCreated 2026-05-27
+0
Daily
+0
Weekly
+229
Monthly
5,934
stars
574
forks
24
watchers
–
prs
–
issues
46
releases

README

Apache Maka (Incubating)


Apache Maka (Incubating) is a high-performance agent workspace that keeps a complete record of everything it did.


  Website ·
  Documentation ·
  Download ·
  中文文档



  
  
  



  
  


 What Maka is

An agent harness exists to finish tasks. We hold it to one measure: how many it completes and at what cost. We publish every run: same model, same official verifier, full per-task record.

- Measured, not claimed. Maka is benchmarked against other harnesses on the same model with the official verifier, and the per-task results ship with every report in docs/eval/.
- The log is the runtime. Every model message, tool call, permission decision and termination is an append-only RuntimeEvent. The UI, the next prompt and crash recovery are projections of that log, never the only copy. Old tool output can leave the next prompt without leaving the log.
- Your machine, your model. Sessions, settings and run records stay local. You bring the model: a cloud API, a local model or a compatible gateway.
- One Runtime Host. Desktop, the TUI and CLI, and Eval are thin clients of one execution authority; Eval owns only the experiment and its scores.

The website walks through one turn of the log and links the published runs. ARCHITECTURE.md has the system map.

 Get Maka

Apache Releases: The latest Apache release is 0.2.2 (incubating). The signed source archive is the official release; packages distributed elsewhere are convenience artifacts. See the downloads page and .github/ASF_SOURCE_RELEASE.md for candidate criteria, signing procedures, and verification steps.

Development testing: To contribute or help test unreleased changes, see CONTRIBUTING and the development mailing list. Development builds are not approved Apache releases.

Build from source: To compile and run Desktop, the TUI, or the CLI, see the Build from source section below.

 Build from source

 Requirements

- Node.js 22.19 or newer on the 22 line, or Node.js 24 or newer (CI uses Node.js 24; Node.js 23 is not supported);
- npm (the lockfile and scripts use npm; the current packageManager is npm 11);
- GnuPG to verify a release archive, or Git for contributor development;
- ripgrep, used by Runtime's Grep tool.

 Build an Apache release

Download and verify the signed source archive using the downloads page. Extract it, then build and start Desktop from the extracted directory:

sh
npm ci
npm run dev:full


 Contributor development

For unreleased development builds, start from a Git checkout:

sh
git clone https://github.com/apache/maka.git
cd maka
npm ci
npm run dev


npm run dev starts the Desktop development environment with HMR. To build every workspace before starting Electron, use:

sh
npm run dev:full


Direct Peer and Peer Mesh development additionally requires Rust stable 1.98 or newer and the
platform linker (Xcode Command Line Tools on macOS, MSVC Build Tools on Windows). Use the
peer-enabled entry point so the native addon is built before Desktop starts:

Snapshot: 2026-11-04T14:00:00Z · Data license Apache-2.0 · JSON