Hadamard: Agents as an Engineering Team
CI
Publish npm Package
npm version
Docs
English | Chinese
LLM 활용체(harnesses)는 강력하지만 실제 엔지니어링 및 연구 작업—소프트웨어 배포, AI-for-Science (AI4S) 파이프라인 실행, 신경망 훈련 및 실험 조정 등—에서 관리하기 어렵습니다. 컨텍스트가 넘치고, 도구 호출(tool calls)이 산재하며, 실행 과정이 계획에서 벗어나고, 단일 에이전트 루프는 결코 두 번째 의견을 얻지 못합니다.
Hadamard는 에이전트 엔지니어링 및 연구를 제어 가능하게 만들기 위해 존재합니다. 여러 제공업체(providers)의 다중 에이전트가 서로 소통하여 문제를 병렬로 조사하고, 검토하며, 할당함으로써 문제가 더욱 철저하게 고려되도록 합니다. 하나의 TypeScript 런타임은 도구, 스킬, 지속적인 세션(durable sessions), 메모리, 그리고 MCP를 제공하며, 또한 설치된 에이전트 CLI (Claude Code, Codex, Cursor, Pi, CodeWhale, Reasonix, Crush)를 자식 프로세스로 관리하는 브릿지를 포함합니다. 이 런타임은 터미널 UI와 데스크톱 GUI도 함께 제공됩니다.
Claude Code, Codex, Deepagents 및 광범위한 에이전트 생태계에서 영감을 받았습니다. Hadamard는 자체 공개 API와 문서를 통해 독립성을 유지합니다.
<p align="center">
<img src="https://raw.githubusercontent.com/DeconBear/hadamard/main/docs/assets/screenshots/gui-home.png" alt="Hadamard 데스크톱 GUI — 프로젝트 개요" width="49%">
<img src="https://raw.githubusercontent.com/DeconBear/hadamard/main/docs/assets/screenshots/gui-chat.png" alt="Hadamard 데스크톱 GUI — 모델과의 채팅" width="49%">
</p>
<p align="center">
<img src="https://raw.githubusercontent.com/DeconBear/hadamard/main/docs/assets/screenshots/tui-home.png" alt="Hadamard TUI — 터미널 시작 화면" width="90%">
</p>
<p align="center"><em>데스크톱 GUI(상단: 프로젝트 개요 및 채팅 세션)와 터미널 UI(하단).</em></p>
패키지 이름: 배포된 npm 패키지는 actoviq-agent-sdk입니다. 제품, 리포지토리, CLI 및 설정 경로는 Hadamard (hadamard-*, ~/.hadamard, .hadamard/)를 사용합니다.
설치 (Install)
Node.js 22.13 이상 또는 Node.js 24가 필요합니다.
npm install actoviq-agent-sdk zod
위의 npm install은 SDK 사용을 위한 것이며 ('actoviq-agent-sdk'에서 가져옴), CLI는 이후 npx를 통해 사용할 수 있습니다 (예: npx hadamard-tui). hadamard-tui / hadamard-gui / hadamard / actoviq를 PATH에 직접 실행하려면 대신 전역으로 설치하세요:
npm install -g actoviq-agent-sdk
프로바이더 설정을 ~/.hadamard/settings.json에 넣으세요. Anthropic과 호환되거나 OpenAI와 호환되는 프로바이더라면 무엇이든 작동합니다.
빠른 시작 (Quick Start)
SDK
import { createAgentSdk, loadDefaultHadamardSettings } from 'actoviq-agent-sdk';
await loadDefaultHadamardSettings();
...
리포지토리의 동일한 예제를 npm run example:hadamard-quickstart로 실행하세요.
터미널 UI (hadamard-tui)
npx hadamard-tui [작업 디렉터리]
메시지를 입력하고 Enter를 누르세요. 클로드 코드 스타일 터미널 REPL에서 에이전트와 채팅하는 것과 같습니다. /을 누르면 슬래시 명령어 메뉴가 열립니다(/team, /bridge, /plan, /mcp, /doctor 등). 일반적인 플래그는 다음과 같습니다: --model, --permission-mode, --resume <세션-id>, --continue.
데스크톱 GUI (hadamard-gui)
npx hadamard-gui [작업-디렉토리]
이 명령어는 로컬호스트 전용 서버에 기반을 둔 Electron 채팅 창을 열어줍니다. 메시지를 보내 첫 대화를 시작할 수 있습니다. 시각적 에이전트 그래프 편집기는 아직 개발 중(iterating)이므로, 프로덕션 워크플로우에는 저장된 팀과 /team 사용을 권장합니다.
Hadamard는 전용 모듈 창으로도 실행될 수 있습니다:
npx hadamard-harness [작업-디렉토리]
npx hadamard-canvas [작업-디렉토리]
메인 앱은 활성화된 모든 모듈을 조합하여 구성합니다. Harness / Canvas는 **설정(Settings) → 개인화(Personalization) → 모듈(Modules)**에서 설정할 수 있습니다. 자세한 내용은 docs/en/surfaces-and-modules.md를 참조하세요.
데모 (Demo)
데스크톱 GUI의 50초 분량 워크스루 영상입니다: 채팅(Chats) 보기 열기, 새 대화 시작, 질문하기, 그리고 생각하는 지표와 코드 렌더링과 함께 스트리밍되는 답변을 확인합니다. (전체 해상도 MP4)
<p align="center">
<img src="https://raw.githubusercontent.com/DeconBear/hadamard/main/docs/assets/screenshots/gui-demo.gif" alt="Hadamard 데스크톱 GUI 데모 — 새 채팅에서 코드 블록이 포함된 스트리밍 답변까지의 대화" width="90%">
</p>
문서 (Documentation)
개발 (Development)
npm run typecheck
npm test
npm run build
기여 (Contributing)
기여는 환영합니다. 버그나 문서의 누락 부분을 발견했다면, 이슈를 열거나 풀 리퀘스트(pull request)를 제출해 주세요.
MIT License에 따라 라이선스되었습니다.
