apache/maka

项目概览

该项目以日志即运行时为设计核心：仅追加的 RuntimeEvents 同时驱动界面、下一轮提示与崩溃恢复，会话与设置数据保留在本地，模型由用户提供，不存在捆绑的共享模型账户。

项目类型

AI Agent · AI 编程 · 评测观测

应用场景

编程开发 · 自动化执行

部署方式

查看项目说明

License

Apache-2.0

适合谁

• 希望对智能体的消息、工具调用与权限决策留下持久记录，并自行选择模型的开发者。
• 需要本地保存会话、设置与运行记录的用户。

核心能力

• 提供终端界面与非交互式命令行，用于开始对话轮次和执行仓库任务。
• 将模型消息、工具调用、权限决策和终止记录为仅追加的 RuntimeEvents，作为界面、提示与崩溃恢复的基础。
• 用户可添加 API、本地模型或受支持的账户连接并选择默认模型，项目不捆绑共享模型账户。
• 写入文件或运行 shell 的工具必须先通过沙箱边界。
• 提供实验单元、尝试、结果以及执行器与被测对象适配器，用于评估 Maka 被测对象。
• 在桌面端以及通过 CLI/TUI 的 resume 命令，支持显式恢复被中断的对话轮次。
• 在仓库的 skills 目录中附带智能体技能。

限制与风险

• Maka 尚未发布 Apache 版本；在其他渠道分发的包仅为便利性产物，采用前需自行确认。
• 仓库概览中将 Windows 和 Linux 标注为预览平台，在这些系统上的使用需自行验证。
• API 密钥等机密存储在本地明文凭据文件中，可被当前操作系统账户读取，需评估所在环境的安全风险。
• 项目处于活跃开发中，数据格式、CLI 命令和实验性能力可能仍会变化。
• 工作区升级时不会导入旧的 JSONL 转录文件和 Electron safeStorage 凭据文件。

如何开始

• 需要 Node.js 22.19 或更高版本、npm、Git 和 ripgrep。桌面端路线需要克隆仓库、安装依赖并运行开发命令：git clone https://github.com/apache/maka.git，然后 cd maka、npm ci、npm run dev。
• 首次启动需在 Settings → Models 中添加 API、本地模型或受支持的账户连接，测试连接、选择默认模型后即可开始任务。

核验依据

• README: Apache Maka (Incubating) is a high-performance agent workspace that keeps a complete record of everything it did.
• README: 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 t…
• README: Sessions, settings and run records stay local. You bring the model: a cloud API, a local model or a compatible gateway.
• README: apps/desktop/ Electron main / preload / React renderer packages/core/ Pure contracts for Sessions, Events, Permissions, and Connections packages/storage/ SQLite operational state,…
• README: Apache Releases: Maka has not made an Apache release yet.

来源更新时间：2026-09-28T03:23:27Z

打开原始 GitHub 项目