Apache Maka

요약

Apache Maka는 Apache Software Foundation에서 인큐베이팅 중인 로컬 우선 에이전트 작업공간입니다. 공식 README는 프로젝트를 점검하고 샌드박스 경계 안에서 도구를 실행하며, 모델 메시지와 도구 호출을 복구 가능한 실행 사실로 기록하는 구조를 설명합니다.

도구 소개

Maka는 Desktop, TUI/CLI, Eval이라는 세 표면을 하나의 Runtime Host에 연결합니다. Desktop에서는 스트리밍 세션·도구 타임라인·브랜치·검색·복구를 다루고, maka와 maka run은 현재 프로젝트 디렉터리에서 작업하거나 비대화형 턴을 실행합니다. Eval은 작업·반복·대상별 실험과 결과를 기록하는 용도로 분리되어 있습니다.

이 저장 방식의 핵심은 대화 화면이 유일한 기록이 아니라는 점입니다. 모델 메시지·도구 호출·도구 결과·턴 종료 상태를 남기고, 다음 프롬프트에서 오래된 도구 출력을 생략하더라도 저장된 근거는 삭제하지 않는 구조를 지향합니다.

사용 포인트

파일 읽기·쓰기·수정·Bash·Grep 도구를 승인 경계 안에서 실행
세션을 검색·이름 변경·재시도·분기하고 중단된 실행을 복구
Desktop과 TUI/CLI에서 같은 작업공간과 모델 연결 사용
실행 결과·사용량·비용·시간·실패 이유를 Eval 단위로 비교
클라우드 API·로컬 모델·호환 게이트웨이를 직접 연결

설치와 시작

공식 README는 현재 main에서 매일 만들어지는 Desktop Nightly를 개발자와 테스터용으로 제공한다고 안내합니다. 이는 Apache 릴리스가 아니며 프로덕션 사용을 위한 ASF 릴리스로 취급해서는 안 됩니다. 시작하려면 Node.js 22.19 이상, npm, Git과 ripgrep이 필요하고 macOS·Windows·Linux 지원 범위도 README의 현재 상태를 확인해야 합니다.

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

첫 실행에서는 Settings → Models에서 사용할 모델 연결을 추가하고 테스트한 뒤 기본 모델을 선택합니다. 파일 수정이나 외부 시스템 접근은 승인·중단·실패 분류를 확인할 수 있는 작은 프로젝트에서 먼저 검증하는 편이 좋습니다.

적용 판단

Maka는 대화형 에이전트를 쓰는 화면보다 실행 기록과 평가를 제품의 일부로 남기는 로컬 작업공간을 실험하고 싶을 때 흥미롭습니다. 도구 호출의 결과와 실패 원인을 나중에 다시 확인해야 하거나, 같은 작업을 여러 모델·설정으로 비교하려는 개발자에게 구조가 잘 맞습니다.

반면 인큐베이팅 중이고 데이터 형식·CLI 명령·기능이 바뀔 수 있다고 공식 문서가 명시합니다. Nightly를 운영 시스템에 바로 넣기보다, 샌드박스 범위·모델 자격 증명·로컬 기록의 백업과 삭제 정책을 먼저 점검해야 합니다. 저장소는 Apache 2.0 라이선스를 표기합니다.

요약

도구 소개

사용 포인트

설치와 시작

적용 판단

참고