<div align="center">
<picture>
<source media="(prefers-color-scheme: dark)" srcset=".github/assets/jazz-logo-on-dark.svg">
<img alt="Jazz" src="https://raw.githubusercontent.com/lvndry/jazz/HEAD/.github/assets/jazz-logo-on-light.svg" height="80">
</picture>
하나의 에이전트. 모든 환경에서. 사용자의 규칙에 따라.
TypeScript License: MIT npm version
<video src="https://github.com/user-attachments/assets/e39dc2ec-1d68-4679-8077-2e2917819747" controls width="100%"></video>
</div>
Jazz는 에이전트 하네스(agent harness)입니다. 즉, 모델을 사람이 감시하지 않아도 실행할 수 있는 에이전트로 변환하는 루프(loop), 가드레일(guardrails), 그리고 다양한 표면(surfaces)을 제공합니다. 사용자는 하나의 JSON 파일에 에이전트(primary 및 companion 모델), 페르소나, 도구(tools), 권한 등을 정의할 수 있으며, Jazz는 이를 사용자의 터미널에서 스크립트로, 예약된 시간에, 또는 소유한 Telegram이나 Discord 봇 뒤에서 실행합니다. 기본적으로 에이전트는 사용자의 파일, git, 웹과 연동하여 작동하며, 인박스(inbox), Obsidian 볼트 또는 검색 제공업체를 연결하면 일상적인 비서로 성장합니다.
한 번 설치하면 어디서든 실행할 수 있습니다. 터미널 REPL, 스크립트 내부의 일회성 명령어(one-shot command), 예약된 워크플로우, 풀 리퀘스트를 검토하는 GitHub Action, 또는 소유한 서버의 Telegram 및 Discord 봇 등입니다. 동일한 에이전트, 동일한 도구, 동일한 메모리를 사용합니다. 봇 대화 중에는 작업에 사용자의 승인이 필요할 때 바로 요청하며, 다른 곳에서는 작업을 보류(parks)하고 notify target을 통해 휴대폰으로 알려주어 채팅에서 승인할 수 있습니다.
OpenAI(API 키 또는 ChatGPT Plus/Pro 플랜 사용), Anthropic(API 키 또는 자체 Claude Code 로그인 사용), Google, Mistral, Groq, OpenRouter를 포함하여 25개의 제공업체가 지원됩니다. 또한 서버가 요구하는 경우가 아니라면 API 키 없이 사용할 수 있는 self-hosted 모델용 ollama, llama.cpp, vllm, sglang도 지원합니다. 그 외 모든 것은 MCP를 통해 연결됩니다.
하나의 에이전트는 역량(capability)에 따라 다양한 모델을 조합할 수 있습니다. 추론 및 도구 사용에 신뢰하는 모델은 그대로 유지하고, 이미지, 오디오, 비디오 이해 또는 생성용 별도의 동반자(companion)를 연결하면 됩니다. 페르소나, 메모리, 권한, 표면적인 인터페이스는 동일하게 유지되지만, 각 미디어 유형별로 가장 적합한 모델에 전달됩니다.
시작하기
curl -fsSL https://github.com/lvndry/jazz/releases/latest/download/install.sh | bash
jazz
이 명령어는 ~/.local/bin에 단일의 독립적인 바이너리 파일을 설치합니다. Node나 npm 같은 다른 것은 설치할 필요가 없습니다. 설치 위치를 다르게 지정하려면 JAZZ_INSTALL_DIR을 설정하십시오. 만약 npm을 통해 진행하는 것을 선호한다면:
npm install -g jazz-ai
jazz
어떤 방법을 사용하든, jazz update를 실행하면 제자리에서 업그레이드가 이루어집니다.
Jazz는 첫 실행 시 제공자(provider) 설정을 안내합니다. 비용이 들지 않을 수도 있습니다: OpenRouter의 무료 모델 라우터는 신용카드가 필요 없으며, ollama는 전적으로 사용자의 하드웨어에서 실행됩니다.
그 후 원하는 것을 요청하십시오. 이 기능들은 마법사(wizard)가 완료되는 즉시 작동합니다. 추가 키나 설치 과정이 필요 없습니다:
> ~/Desktop/bitcoin.pdf의 요약(TL;DR)을 알려줘
> 지난 5개 커밋을 검토하고 위험한 항목이 있는지 플래그 지정해줘
> https://en.wikipedia.org/wiki/Jazz를 가져와서 간략하게 설명해줘
제공자별 가격 정보가 알려져 있으면, Jazz는 예상 비용을 보고합니다. 청구되는 금액을 반환하는 제공자는 실제 호출당 요금을 보고할 수 있습니다. 가격이 불분명한 경우 '무료'로 표시하기보다는 '알 수 없음(unknown)'으로 표시됩니다.
각각의 설정은 1분이 걸리지만, Jazz는 더 큰 작업도 수행합니다:
> 읽지 않은 이메일을 확인하고 중요한 내용을 요약하며 나머지는 보관해줘 # `himalaya`가 구성된 후
> 삼체 문제에 대해 심층 연구하고 내 Obsidian 볼트에 작성해줘 # 웹 검색 키가 설정된 후
> 매일 아침 7시에 날씨와 입을 옷을 알려줘 # 예약된 워크플로우로
가이드에서 전체 설정 과정을 안내합니다.
작동 환경
| 플랫폼(Surface) | 실행 방법(How you run it) |
|---|
| Terminal | jazz |
| ... | |
| Slack, Google Chat 또는 자체 앱도 동일하게 작동합니다. 채팅 플랫폼을 참조하세요. | |
문서화 (Documentation)
docs/index.md에서 시작하세요.
- 시작하기(Getting started): 설치, 첫 실행 및 첫 사용자 지정 에이전트
- 개념(Concepts): 에이전트(agents), 도구(tools), 메모리(memory), 자동화(automation), 컴패니언(companions), 원격 작업(remote work)
- 플랫폼(Surfaces): 터미널(terminal), 헤드리스(headless), 스케줄(schedules), CI, 채팅(chat), 웹훅(webhooks), 피어(peers)
- 가이드(Guides): 실행할 수 있는 전체 설정 구성
- 보안(Security): 권한(permissions), 승인(approvals), 비밀 정보(secrets), 이그레스(egress), 원격 액세스(remote access)
- 구성(Configure): 모델(models), 에이전트(agents), 워크플로우(workflows), MCP, 검색(search), 텔레메트리(telemetry)
- 유지보수자(Maintainers): 코드 기반 아키텍처 및 런타임 추적(runtime traces)
Discord · Discussions · Issues · 기여(Contributing) · 보안(Security)
MIT 라이선스입니다. LICENSE를 참조하세요.
