<p align="center"><img src="https://raw.githubusercontent.com/Cookieboty/nomi-ai/HEAD/docs/brand/nomi-wordmark.svg" alt="Nomi" width="320"></p>
<h1 align="center">Nomi·노미</h1>
<p align="center">
<b>모든 종류의 AI 능력을 당신이 사용하도록 합니다.</b><br>
One place. Every AI capability.
</p>
<p align="center">
Claude Code와 Codex를 하나의 대시보드에 병렬로 배치합니다. 모델을 단 한 번만 연결하면 공식, 서드파티 또는 로컬 모두 사용할 수 있습니다. 클라우드 계정에 바인딩하거나 CLI의 전역 설정을 변경할 필요가 없습니다.<br>데스크톱 역할은 선택 가능하며, 필요하지 않으면 끌 수 있습니다.
</p>
<p align="center">macOS · Windows · Linux | Go 코어, 설치 파일 약 25 MB | MIT</p>
<p align="center">
<a href="https://github.com/Cookieboty/nomi-ai/stargazers"><img src="https://img.shields.io/github/stars/Cookieboty/nomi-ai?style=flat&logo=github" alt="GitHub stars"></a>
<a href="https://github.com/Cookieboty/nomi-ai/releases"><img src="https://img.shields.io/endpoint?url=https%3A%2F%2Fraw.githubusercontent.com%2FCookieboty%2Fnomi-ai%2Fbadges%2Fdownloads.json&style=flat" alt="다운로드 횟수"></a>
<a href="https://github.com/Cookieboty/nomi-ai/releases/latest"><img src="https://img.shields.io/github/v/release/Cookieboty/nomi-ai?style=flat" alt="최신 릴리스"></a>
<a href="https://github.com/Cookieboty/nomi-ai/commits/main"><img src="https://img.shields.io/github/last-commit/Cookieboty/nomi-ai?style=flat" alt="최신 커밋"></a>
<a href="LICENSE"><img src="https://img.shields.io/github/license/Cookieboty/nomi-ai?style=flat" alt="라이선스: MIT"></a>
</p>
<p align="center">
<a href="https://github.com/Cookieboty/nomi-ai/releases/latest">다운로드</a> ·
<a href="https://withnomi.app">공식 웹사이트</a> ·
<a href="docs/README.md">문서</a> ·
<a href="docs/development/architecture.md">아키텍처</a> ·
<a href="CHANGELOG.md">업데이트 로그</a>
</p>
<p align="center"><b class="chinese">중국어</b> · <a href="README.en.md">English</a></p>
<p align="center">
<img src="https://raw.githubusercontent.com/Cookieboty/nomi-ai/HEAD/docs/screenshots/agent-board.webp" alt="Agent 대시보드: 누가 작업하고 있는지, 어느 단계까지 진행되었는지, 얼마나 많은 리소스를 차지하는지" width="49%">
<img src="https://raw.githubusercontent.com/Cookieboty/nomi-ai/HEAD/docs/screenshots/workspace.webp" alt="agent 3분할 작업 공간" width="49%">
</p>
작업 공간의 기능
| 능력 | Nomi에서 제공하는 기능 |
|---|
| Agents | Claude Code, Codex, Gemini CLI, Grok, dsh, Kimi Code, MiniMax Code 등 여러 에이전트가 병렬로 작동합니다. 터미널 또는 IDE에 열린 세션은 대시보드에서 읽기 전용으로 표시되며, 각 CLI에 기록된 이력은 작업장에서 이어받아 사용할 수 있습니다. |
| ... | |
이 모든 기능들은 하나의 Agent 작업대(Agent Workbench) 안에 있습니다. 누가 작업을 하고 있는지, 어느 단계까지 진행되었는지, 얼마나 많은 리소스를 사용했는지, 어디에서 막혔는지를 한눈에 파악할 수 있습니다.
왜 Nomi인가
1. 하나의 대시보드에서 병렬 실행 및 통합 관리
**Agent 대시보드(Agent Board)**에는 작동 중인 모든 에이전트가 모여 있습니다: Nomi의 대화, 백그라운드 실행되는 작업, 배포된 에이전트, 그리고 사용자가 터미널이나 IDE에서 직접 연 세션(읽기 전용). 각 카드에는 상태, 출처 디렉토리, 메모리 및 CPU 정보가 명시되어 있으며, 사용자 승인 또는 검수가 필요한 항목들이 가장 앞에 배치됩니다.
메모리가 부족할 경우, Nomi가 배포한 에이전트의 작업을 자동으로 일시 중지하여 부하를 완화하고, 나중에 이어서 실행할 수 있습니다. 또한 언제든지 수동으로 일시 중지하거나 재개할 수 있으며, 상단 제목 표시줄에 실시간 부하 지표가 표시됩니다.
Agent 세션은 작업대 내에서 직접 열립니다: Claude Code, Codex, Gemini CLI, Grok, dsh, Kimi Code, MiniMax Code 등 내장된 에이전트들을 ACP(Agent Conversation Protocol), stream-json, Codex app-server, exec 네 가지 세션 구동 방식을 통해 연결합니다. 여러 세션을 병렬로 운영할 수 있으며, 세 개의 작업 영역에서 Diff 확인, 커밋, 되돌리기 등의 작업을 할 수 있습니다. 접속 계층은 플러그인화되어 있어 ACP 어시스턴트와 같은 외부 어시스턴트도 연결할 수 있습니다. 외부 어시스턴트는 게이트웨이를 거치지 않으며 공식 계정 연동도 필요 없습니다.
→ agents · Agent 대시보드 · 에이전트 접속
2. 모델 연결은 단 한 번만 하면 됩니다
공급업체(Provider)를 단 한 번 추가하면 됩니다 (사전 설정 선택 또는 주소 입력 후 Key 붙여넣기). 출처는 공식, 서드파티, 로컬 등 다양할 수 있습니다. Claude Code, Codex, Gemini CLI, Grok, dsh, Kimi Code, MiniMax Code, Nomi 모두 이 모델을 사용할 수 있으며, 모든 것을 로컬 모델로 대체할 수도 있습니다.
로컬 게이트웨이는 Anthropic Messages / OpenAI Responses / OpenAI Chat Completions / Gemini generateContent를 자동으로 인식하고 상호 변환합니다. 스트리밍(Streaming), 도구 호출(Tool Calling), 추론(Inference), 이미지 처리, 컨텍스트 압축 등 모든 기능이 정상적으로 작동하므로, Claude Code 내에서 서드파티 모델을 직접 사용할 수 있습니다. 연결 끊김 시 동일한 Key로 재시도하며, 한 공급업체에서 반복적으로 실패할 경우 같은 모델을 제공하는 다음 공급업체로 자동으로 전환됩니다.
서드파티는 Nomi가 시작시킨 프로세스에만 영향을 미치며, CLI의 전역 설정을 변경하거나 공식 로그인을 건드리지 않습니다. 각 CLI 자체의 공식 로그인은 여전히 사용 가능하며, 필수 사항도 아닙니다. Nomi는 등록해야 할 클라우드 계정이 없습니다.
→ 통합 게이트웨이 설계 · 서드파티 공급업체 및 모델
3. 로컬 우선, 클라우드 계정 강제 없음
대화, 메모리, 지식 기반은 기본적으로 로컬(본체)에만 존재합니다. 각 CLI의 공식 로그인을 사용하거나, 사용자 자신의 API Key 또는 로컬 모델만을 사용할 수 있습니다.
macOS에서 에이전트(agent)는 시스템 샌드박스 내에서 실행됩니다 (기본 활성화). SSH 및 Git 자격 증명, 클라우드 계정 자격 증명, 브라우저 데이터, .env 파일에는 접근할 수 없으며, 프로젝트 폴더에만 쓸 수 있습니다. 차단된 경우 대화창에서 '이 세션' 또는 '항상 허용(이 프로젝트에 한해서)'으로 권한을 부여하면 자동으로 작업을 이어 나갑니다. 작업 디렉터리는 프로젝트 폴더로 제한되며 환경 변수에 있는 토큰이나 키도 상속받지 않습니다. 샌드박스를 활성화하면 에이전트가 모든 것을 자동 실행하도록 안심할 수 있습니다.
명령 실행 전, 보조 모델이 위험도에 따라 분류합니다: 저위험은 바로 실행하고, 고위험은 사용자에게 확인을 요청합니다. 외부 내용을 읽은 후(웹페이지, MCP 반환값, 스킬 파일)에는 중위험 명령도 반드시 사용자 확인이 필요하며, 이는 프롬프트 주입(prompt injection) 공격으로 Nomi를 통해 명령이 실행되는 것을 방지하기 위함입니다.
대화, 메모리, 지식 기반은 기본적으로 로컬에만 존재합니다. 타사 모델로 전송하기 전에 키는 자동으로 숨겨지며, API Key는 시스템 키체인에 저장됩니다.
→ 개인 정보 및 보안 · 에이전트의 로컬 보호
4. Nomi 자체가 에이전트입니다
파일 읽기/쓰기, 명령 실행, 브라우저 열기, MCP 및 스킬 호출이 가능하며, 사용자가 말했던 내용을 기억합니다(장기 메모리). 사용자의 폴더에서 자료를 검색하고 클릭 가능한 인용을 제공할 수 있으며, 그림 그리기, 이미지 수정, 알림 설정도 할 수 있습니다.
코딩과 같은 작업은 에이전트에게 위임합니다: 하위 태스크는 대화 옆 별도의 창에서 열리며, 중간에 개입하거나(intervene), 중지시키거나, 다시 한 라운드를 진행할 수 있고, 결과는 모두 메인 대화로 돌아옵니다. 또한 에이전트 보드(Agent 看板)를 통해 스케줄링을 모니터링합니다.
도구는 필요에 따라 제공됩니다: 잡담 중 모델에게 전송되는 도구 정의는 약 2K 토큰이며, 관련 주제가 되어야만 확장되어 사용됩니다.
→ AI 대화 · 장기 메모리 · 지식 기반
5. 데스크톱 캐릭터 선택 가능
데스크톱 캐릭터(Mascot)는 작업 공간의 전제 조건이 아닙니다. 필요할 때 상주하게 할 수 있습니다: 표정, 동작, 입 모양을 가진 투명한 작은 창입니다. 필요하지 않을 때는 도구 모음의 '더 보기'에서 끄면 작업 공간은 평소처럼 사용 가능합니다.
이것을 켜두면 많은 작업을 메인 창을 열지 않고도 할 수 있습니다: 작업 완료 또는 오류 발생 시 동작으로 알림을 제공합니다; 답변의 직전 몇 문장이 옆쪽 말풍선에 표시됩니다; 파일을 이 캐릭터 위로 드래그하면 바로 요약해 줍니다; 음성 대화가 가능하며, 더블 클릭으로 대화를 열 수 있습니다.
→ 데스크톱 캐릭터 · 음성
6. 경량: Go 코어, 네이티브 WebView
Go 코어 + Wails v3를 사용하며, Chromium을 포함하지 않습니다. macOS Apple 칩용 DMG는 약 24.5 MB이고, 설치 후에는 약 49 MiB입니다.
아키텍처
flowchart LR
subgraph View["뷰 (React 19)"]
Bench["에이전트 작업 공간<br/>보드 · 삼분할 작업 영역"]
...
뷰와 코어 사이에는 타입화된 계약(typed contract) 하나만 존재하며, 산발적인 IPC 채널은 없습니다. 어떤 창이 어떤 프로세스를 호출할 수 있는지, 무엇이 위험한 작업에 속하는지는 모두 이 계약서에 명시되어 있습니다. 자세한 내용은 아키텍처, 애플리케이션 계약을 참조하세요.
기능 개요
에이전트 작업 공간(Agent 工作台)
- 에이전트 보드: 누가 무엇을 하는지, 어느 단계까지 진행했는지, 각자 메모리와 CPU를 얼마나 사용하는지 한눈에 볼 수 있습니다; 메모리 가드(Memory Guard)가 자동으로 일시 중지/복구하며, 제목 표시줄에 부하 지표가 상주합니다.
- 에이전트: 7개의 내장 CLI, 다중 세션 병렬 처리, 삼분할 작업 공간에서 Diff, 커밋, 되돌리기 확인; 공식 계정 또는 타사 모델 선택 가능; 권한 모드(Permission Mode)는 현재 macOS에서 시스템 샌드박스에 적용됩니다.
- 작업: 지속 작업(Persistent Task), 예약 작업(Scheduled Task)을 지원하며, 실행자는 Nomi 또는 에이전트가 될 수 있습니다.
모델 및 도구
- 모델: OpenAI, Anthropic, DeepSeek, Kimi, 智谱, 通义, 豆包, Ollama 등 사전 설정되어 있으며; 다중 키 자동 전환을 지원합니다; 상위 요청마다 사용량과 비용이 기록되어 지출 내역을 확인할 수 있습니다.
- 로컬 모델: 오픈 소스 소형 모델(llama.cpp)을 원클릭으로 다운로드하거나 Ollama를 관리할 수 있습니다; 로컬 모델만 사용하거나, 로컬 모델에게 파일 읽기 권한만 부여하는 것도 가능합니다.
- MCP 및 스킬: MCP 서버와
SKILL.md를 그래픽적으로 관리하며, 다른 도구로부터 가져올 수 있습니다; 도구 호출에는 감사 로그(audit log)가 기록됩니다.
- 타사 공급업체 연결: 중계 스테이션과 모델 플랫폼에 'Nomi에 추가' 링크를 배치할 수 있습니다. 아래 타사 공급업체 연결 참조.
Nomi
- 대화: 파일 읽기/쓰기, 명령어 실행, 브라우저 열기, agent 위임; 명령 패널 및 슬래시 명령어
- 지식 기반 및 메모리: 폴더별 질의응답 (클릭 가능한 인용 포함); 대화 내용 자동 정리되어 장기 기억으로 저장되며, 내보내기 가능
- 이미지 생성: 직접 그림 그리기, 이미지 수정, 이미지로 이미지 생성(Img2Img), 동일 제조사의 이미지 모델 자동 매칭; 소재 라이브러리 통합 관리
- 음성 및 알림: 로컬 whisper.cpp 또는 클라우드 음성 입력, 음성 재생; 알림, 방해 금지 모드
- 데스크톱 캐릭터 (선택 사항): 2D 일러스트레이션 또는 Rive 애니메이션, 표정 및 입 모양 동기화, 작업 진행 상황을 동작으로 알려줌
<table>
<tr>
<td align="center" width="33%"><img src="https://raw.githubusercontent.com/Cookieboty/nomi-ai/HEAD/docs/screenshots/coding-agent.webp" alt="agent 대화"><br><sub style="font-size: 0.8em;">agents</sub></td>
<td align="center" width="33%"><img src="https://raw.githubusercontent.com/Cookieboty/nomi-ai/HEAD/docs/screenshots/settings-providers.webp" alt="공급자 및 모델"><br><sub style="font-size: 0.8em;">공급자 및 모델</sub></td>
<td align="center" width="33%"><img src="https://raw.githubusercontent.com/Cookieboty/nomi-ai/HEAD/docs/screenshots/mascot.webp" alt="데스크톱 캐릭터"><br><sub style="font-size: 0.8em;">데스크톱 캐릭터 (선택 사항)</sub></td>
</tr>
</table>
더 많은 인터페이스는 docs/screenshots를 참고하세요.
다운로드 및 설치
GitHub Releases로 이동하여 확인하세요:
| 시스템 | 설치 파일 | 설명 |
|---|
| macOS · Apple 칩 | Nomi-<버전>-arm64.dmg | '응용 프로그램' 폴더에 드래그하여 넣기 |
| ... | | |
| 已安装的版本会在应用内提示更新。 (설치된 버전은 앱 내에서 업데이트를 안내합니다.) | | |
macOS에서 '손상됨' 메시지가 표시되나요? 현재 패키지는 서명되었지만 아직 공증되지 않았습니다. '응용 프로그램' 폴더로 드래그한 후 다음 명령어를 실행하세요:
sudo xattr -dr com.apple.quarantine /Applications/Nomi.app
Windows에서 SmartScreen 경고가 표시되나요? 설치 파일이 본 저장소의 Releases에서 왔음을 확인한 후, '추가 정보 → 여전히 실행'을 선택하세요.
3분 만에 시작하기
- Nomi를 열고 첫 번째 온보딩(언어 및 외관, AI 기능, 개인화)을 완료합니다. 데스크톱 캐릭터는 기본적으로 비활성화되어 있습니다.
- Claude Code / Codex 세션을 새로 만들고 작업 디렉토리를 선택합니다. 해당 CLI의 공식 로그인 또는 모델 연결 후 '타사'를 선택할 수 있습니다. 왼쪽 탐색 모음의 'Agents'를 열어 대시보드를 확인하세요.
- '설정 → 모델 및 공급자'에서 공급자와 API Key를 한 번 추가하거나, '로컬 모델'에서 로컬 모델을 다운로드합니다. 공식, 타사 또는 로컬 모두 여기서 관리되며, 내장 agent와 Nomi 모두 선택할 수 있습니다.
- 작업을 Nomi에게 위임하세요:
Ctrl/⌘+N으로 새 대화를 시작하고, Ctrl/⌘+K로 명령 패널을 엽니다 (agent 배정, 공급자 추가, 대시보드 열기, 새 작업 생성). 코드를 작성하는 일은 agent에게 맡길 수 있습니다.
더 자세한 단계는 빠른 시작 가이드를 참고하세요.
소스 코드에서 빌드하기
Node.js ≥ 22.12, pnpm 9 (corepack enable), Go (버전은 apps/desktop-go/go.mod 참조), 그리고 cgo 툴체인(Linux의 경우 GTK3 및 WebKitGTK 4.1 개발 패키지 필요)이 필요합니다.
git clone https://github.com/Cookieboty/nomi-ai.git && cd nomi-ai
corepack enable && pnpm install
pnpm dev
...
pnpm run doctor로 개발 환경을 확인하세요. 애플리케이션 상세 정보는 apps/desktop-go를 참고하고, 패키징 및 배포는 docs/RELEASE.md를 참고하며, 개발 가이드는 docs/development에 있습니다. PR을 환영합니다. 제출 전에는 AGENTS.md의 약속 사항을 확인해 주세요.
타사 공급자 연결 (Third-Party Provider Integration)
중계 스테이션(中转站)이나 모델 플랫폼은 자체 웹페이지에 "Nomi에 추가" 버튼을 배치할 수 있으며, 사용자가 이 버튼을 클릭하면 Nomi에 연결됩니다:
nomi://provider/import: 주소와 Key를 직접 가져오기(Import) 할 수 있으며, 몇 줄의 템플릿만으로 연결 가능하고 Cherry Studio의 가져오기 형식과 호환됩니다.
nomi://provider/connect: 웹페이지 인증(OAuth + PKCE)을 사용하며, Key가 링크에 노출되지 않습니다.
두 가지 방식 모두 최종적으로 Nomi의 확인 창에 멈추며, 사용자가 확인하기 전까지는 아무것도 저장되지 않습니다. 링크 형식, 인증 흐름, 처리 규칙은 docs/integrations/provider-link.md를 참고하세요.
문제 및 제안은 GitHub Issues에 올려주세요. 위챗(WeChat) QR 코드를 스캔하여 작성자에게 추가하세요:
<table>
<tr
><td align="center"><img src="https://raw.githubusercontent.com/Cookieboty/nomi-ai/HEAD/docs/contact/qr-author-yxf.png" alt="작성자 위챗 · 언샤오판" width="160"><br><sub
>언샤오판</sub></td>
<td align="center"><img src="https://raw.githubusercontent.com/Cookieboty/nomi-ai/HEAD/docs/contact/qr-author.png" alt="작성자 위챗 · Tomo" width="160"><br><sub
>Tomo</sub></td>
</tr>
</table>
감사의 글 (Acknowledgments)
<a href="https://github.com/zihe-xu"><img src="https://avatars.githubusercontent.com/u/25056086?v=4&s=96" width="48" height="48" alt="zihe-xu" /></a>
Nomi는 Go, Wails, React, Vite, Vercel AI SDK, MCP, whisper.cpp / llama.cpp, Rive 등 오픈 소스 프로젝트를 기반으로 구축되었으며, 디자인 참고 및 감사는 CREDITS.md를 참고하세요.
라이선스 (License)
MIT. 타사 컴포넌트는 THIRD_PARTY_NOTICES.md를 참고하세요.