컴퓨터에서 작동하는 개인용 로컬 기반 음성 비서입니다.
마치 제3자가 방에 있는 것처럼 자연스럽게 대화하세요.
음성 우선 · 로컬 AI · 개인 메모리 · 구독료 없음
Jarvis 다운로드 → · 시작하기 · 앱 탐색 · 프로젝트 지원
Jarvis는 대화의 일부가 되도록 설계되었습니다. 아이디어에 대해 이야기하고, 친구와 계획을 논의한 다음 “Jarvis, 어떻게 생각해?”라고 물어보세요. 듣는 동안 주변 발화를 짧고 임시적인 순환 기록(rolling transcript)으로 유지하여 방금 논의된 내용을 활용해 진행 중인 대화에 참여할 수 있습니다.
문장 어디에서든 Jarvis를 이름으로 부르고 자연스럽게 후속 질문을 이어가세요. 음성 인식, 언어 모델 및 음성 합성은 사용자가 제어하는 하드웨어에서 실행됩니다.
사용자의 대화와 모든 데이터는 오직 컴퓨터에만 저장됩니다. 민감한 정보는 로컬임에도 불구하고 모델 컨텍스트나 저장된 일기장(diary)에 도달하기 전에 편집되어 개인 정보의 보안을 보장합니다. 웹 검색, 날씨 및 연결된 도구는 네트워크를 사용하지만, 해당 기능을 요청할 때 필요한 것만 전송합니다.
대화 속에서의 음성, 얼굴, 그리고 장소입니다.
1. 앱 다운로드. GitHub Releases에서 플랫폼을 선택하세요.
| 플랫폼 | 패키지 | 열기 |
|---|
| macOS · Apple Silicon | Jarvis-macOS-arm64.zip | 압축 해제 후 Applications로 이동, 그리고 마우스 오른쪽 버튼 클릭 → 열기 |
| macOS · Intel | Jarvis-macOS-x64.zip | 압축 해제 후 Applications로 이동, 그리고 마우스 오른쪽 버튼 클릭 → 열기 |
| Windows · x64 | Jarvis-Windows-x64.zip | 압축 해제 후 Jarvis.exe 실행 |
| Linux · x64 | Jarvis-Linux-x64.tar.gz | 압축 해제 후 ./Jarvis/Jarvis 실행 |
2. 로컬 모델 선택. 설정 마법사(setup wizard)가 음성 인식 및 모델 서버를 안내합니다. Ollama를 사용하거나, LM Studio, oMLX 또는 llama.cpp와 같이 이미 실행 중인 OpenAI 호환 서버에 연결하세요.
3. 나만의 것으로 만들기. 마이크 접근을 허용하고 첫 번째 모델 다운로드가 완료될 때까지 기다리세요. Jarvis가 듣고 있다고 보고하면 다음을 시도해 보세요:
“Jarvis, 오늘 하루를 생각하는 것을 도와줘.”
얼굴을 마우스 오른쪽 버튼으로 클릭하거나 트레이 메뉴를 사용하여 **채팅(Chat)**을 엽니다. 텍스트 답변은 조용합니다.
하드웨어 및 모델 선택
메모리 요구 사항은 모델 크기, 양자화(quantisation), 컨텍스트 길이, 음성 인식에 따라 달라집니다. Ollama와 OpenAI 호환 설정 모두 메모리 예산을 보여주며, OpenAI 호환 엔드포인트를 통해 서비스되는 모델의 추정치는 수정할 수 있습니다. 작은 모델은 낮은 리소스 사용량과 교환하여 기능을 낮춥니다.
| 시작점 | 채팅 모델 |
|---|
| 하드웨어 사양이 낮은 경우 | qwen3.5:0.8b |
| ... | |
| 메모리 예산에는 Whisper와, 채팅과는 다를 경우 음성 의도 및 도구 라우팅에 사용되는 빠른 모델이 포함됩니다. Apple Silicon은 통합 메모리를 사용하며, 다른 GPU는 전용 VRAM을 사용합니다. 설정 시 선택한 Whisper 모델과 함께 채팅 및 빠른 작업을 위한 메모리 예산을 구성하며, 빠르고 가벼운 작업에는 E2B를 사용하거나 메모리를 절약하기 위해 두 역할 모두에 걸쳐 E4B를 공유할 수 있습니다. Apple Silicon 추정치는 macOS용 메모리를 예약합니다. 저장된 모델 선택은 유지되며, 메모리가 부족하면 CPU 폴백(fallback) 지침이 표시됩니다. | |
방 안에 있는 제3의 인물. 친구들과 진행 중인 대화에 Jarvis를 참여시키거나, 큰 소리로 문제에 대해 논하거나, 결정에 대한 의견을 물어볼 수 있습니다. “Jarvis, 어떻게 생각해?”는 단지 그 한 문장뿐만 아니라 최근 논의된 내용을 활용합니다.한 세션 이상 기억하기. 과거 대화, 선호도 및 계획에 대해 질문할 수 있습니다. 메모리 뷰어(Memory Viewer)에서 로컬 다이어리와 지식 그래프를 탐색합니다.일을 처리하다. 내장 도구에는 웹 검색, 날씨, 시간, 스크린샷 OCR, 파일 접근, 영양 추적 및 선택적 위치 인식이 포함됩니다.**자신만의 도구 연결하기.**MCP 서버는 브라우저 자동화, 스마트 홈 제어 및 기타 통합 기능을 추가합니다.다른 앱에 구술 입력하기. 단축키를 누르고 말한 다음 놓으면 로컬로 전사된 텍스트를 붙여넣을 수 있습니다. 먼저 플랫폼 제한 사항을 확인하세요.필요할 때 타이핑하기. 동반 채팅(companion chat)은 음성 대화와 메모리를 공유합니다. 텍스트 답변은 조용하며, 보낸 메시지를 되감아 그 지점부터 다시 생성할 수 있습니다.
당신: 내일 소풍 갈 수 있을 것 같아.
친구: 날씨에 따라 다를 것 같네. 실내에서 할 만한 걸 계획할까?
당신: Jarvis, 어떻게 생각해?
Jarvis는 최근 대화를 활용하여 당신이 마지막 문장을 독립적인 질문으로 취급하기보다 소풍의 날씨에 대해 묻고 있다는 것을 이해할 수 있습니다. 이것이 이 경험을 구축하는 기반입니다. 개인화된 요청은 외부 도구가 필요하지 않을 때 저장된 대화 기록도 참조할 수 있습니다. 얼마나 신뢰성 있게 문맥을 이해하는지는 음성 인식과 선택한 모델에 따라 다르므로, 평가 결과를 참고하세요.
설정, 활동 및 옵션을 손이 닿는 곳에 유지하세요.
사용자 기기에 맞는 실행 환경을 선택하세요. 설정은 구성 파일을 편집할 필요 없이 로컬 모델, 음성 및 선택적 기능을 안내합니다.
활동 타임라인은 일반적인 이벤트를 읽기 쉽게 유지합니다. 다운로드는 다운로더가 전송된 바이트, 백분율, 속도 및 남은 시간을 제공하는 별도의 카드를 가집니다. 로딩과 워밍업은 구별되는 단계입니다.
트레이 메뉴의 설정에서 모델을 선택하고, 음성 인식을 조정하며, 도구를 구성하고, 저전력 모드(Low Power Mode)를 활성화하세요.
채팅(Chat)을 열어 같은 대화에서 조용한 답변을 받으세요. **음성 듣기 일시 중지(Pause Voice Listening)**는 회의 중에 방 녹음을 멈추지만 채팅과 받아쓰기는 계속 사용할 수 있습니다.
Jarvis는 주로 macOS용으로 개발되었습니다. Windows와 Linux에서의 동작은 다를 수 있으니, 테스트된 기능은 평가 결과를 참고하세요.
정확도와 속도는 사용자의 모델과 하드웨어에 따라 달라집니다. 더 작은 모델은 복잡한 요청의 일부를 놓칠 수 있으며, 느린 음성 인식은 발화를 누락할 수 있습니다. macOS 26+에서는 받아쓰기가 사용할 수 없습니다(#172). Linux에서 받아쓰기를 사용하려면 X11이 필요하며 Wayland 지원은 제한적입니다.**Jarvis가 말하는 동안
가이드는 로컬 모델 서버, 음성 인식, 저전력 모드(Low Power Mode), 목소리, 받아쓰기(dictation), 위치(location), MCP 통합 등을 다루고 문제 해결 방법을 안내합니다.
| 플랫폼 | 기본 단축키 |
|---|
| Windows | Ctrl + Win |
| ... | |
| 녹음을 위해 길게 누르고 놓아 붙여넣습니다. 핸즈프리 녹음은 두 번 탭하세요. 설정(Settings)에서 선택적 필러워드 제거, 사용자 지정 사전, 받아쓰기 기록을 사용할 수 있습니다. macOS는 접근성 권한(Accessibility permission)이 필요하며, Linux는 X11이 필요하고 Wayland 지원은 제한적입니다. | |
브라우저 자동화, Home Assistant, GitHub, 데이터베이스 등과 연결하려면 MCP 서버를 사용하세요. 자격 증명 및 네트워크 액세스는 선택하는 도구에 따라 달라집니다. 서버를 활성화하기 전에 권한을 검토하세요.
🔇
음성 출력 불가: 음성 모델 또는 종속성(dependency) 실패로 인해 현재 실행에서 음성 출력이 비활성화되었습니다. 로그(Logs)에서 이유를 확인하고, 음성 모델 설정이나 누락된 종속성을 수정한 후 Jarvis를 다시 시작하세요. -
🔊
Piper 다운로드 중단: 연결 재설정 및 시간 초과는 제한된 횟수만큼 재시도됩니다. 지속될 경우, 연결 상태를 확인하고 Jarvis를 다시 시작하세요. 완료된 음성 파일은 보존됩니다. 인증서 오류는 신뢰 구성(trust configuration)을 수정해야 합니다. -
📥
Whisper 다운로드 실패: Faster-whisper 다운로드는 별도의 프로세스에서 5분 제한으로 실행됩니다. 다운로드가 충돌하거나 시간 초과되면, Jarvis를 다시 시작하여 재개하세요. 캐시된 모델은 오프라인에서도 사용 가능합니다. -
🎤
Whisper 캐시 오류: Jarvis는 시작 시 한 번의 클린 다운로드 복구(clean download recovery)를 시도합니다. 실패하면 연결 상태와 디스크 공간을 확인하고, 인쇄된 캐시 가이드를 따라 재시작하세요. 장치 폴백(Device fallbacks)은 복구 중에 다운로드된 파일을 보존합니다.
기본 마이크를 찾을 수 없음
Jarvis 설정에서 사용 가능한 마이크를 선택하거나, 시스템 설정에서 기본 녹음 입력을 설정한 후 Jarvis를 다시 시작하세요. Jarvis는 시작하는 동안 선택된 입력값을 유지하며, 기본값이 사용 불가능할 때 자동으로 다른 마이크를 선택하지 않습니다.
블루투스 마이크가 시작되지 않음
헤드셋의 재생 장치가 아닌 설정(Settings)에서 마이크/입력 프로필을 선택하세요. Jarvis는 선택된 입력을 듣기 및 받아쓰기에 사용하며, 호환 가능한 모노, 스테레오 및 기기 기본 캡처 형식을 시도한 후 다채널 입력을 음성 인식용으로 모노로 변환합니다. 해당 입력이 사용할 수 없다면 설정에서 다른 마이크를 선택하세요. 여전히 캡처에 실패하면, 마이크가 시스템의 녹음기에서 작동하는지 확인하고 로그(Logs)에서 오류를 공유해 주세요. Bluetooth 드라이버/프로필 제한으로 인해 여전히 캡처가 불가능할 수 있습니다.
Linux에서 듣기는 되지만 음성을 전혀 인식하지 못함
로그에서 missing-callback 또는 silent-input 경고가 있는지 확인하세요. PipeWire/PulseAudio에서 녹음 소스와 음소거 상태를 확인하고, 출력 모니터 대신 마이크를 선택하세요. 캡처 수준 진단을 위해 설정(Settings)에서 voice_debug을 활성화하세요. 문제 해결 가이드를 참고하세요.
다운로드가 일시 정지된 것처럼 보임
트레이에서 **로그(Logs)**를 여세요. 진행 상황 카드는 사용 가능한 경우 전송 세부 정보를, 업데이트가 일시 중단될 때 경과 대기 시간을 보여줍니다. 다운로드 후 모델을 메모리에 로드하는 것은 별도의 단계입니다.
웜업은 통과했지만 요청이 시간 초과됨
웜업(Warmup)은 전체 요청이 아닌 작은 프로브로 모델 로드를 확인합니다. 음성 의도 감지(Voice intent detection)는 채팅과는 별도의 시간 초과가 있습니다. 로그에 표시된 제한과 로컬 서버의 응답성을 확인하세요.
Mac에서 발열되거나 백그라운드 사용량을 낮추고 싶을 때
**설정(Settings) → 기능(Features) → 저전력 모드(Low Power Mode)**를 활성화하세요. 이 기능을 사용하면 LLM 시작 웜업을 건너뛰고 음성 인식을 준비 상태로 유지하면서 Ollama 모델 체류 시간을 단축합니다. 유휴 상태 이후의 첫 번째 모델 요청은 더 오래 걸릴 수 있습니다.
소스에서 실행하기
git clone https://github.com/isair/jarvis.git
cd jarvis
# macOS
...
소스에서 실행하면 Chatterbox TTS도 활성화됩니다. Piper는 패키징된 설치와 소스 설치 모두에서 작동합니다.
스크린샷 새로고침하기
파이썬 환경에 데스크톱 종속성이 설치되어 있는 경우:
PYTHONPATH=src python scripts/capture_readme_screenshots.py
캡처 스크립트는 실제 위젯과 예시 데이터를 사용하며, 설정을 임시 디렉터리에 격리하고 네트워크 연결 및 백그라운드 워커를 차단합니다. 데몬을 실행하거나 개인 대화를 사용하지 않습니다. 스크린샷은 읽기 쉬운 너비로 별도의 행에 유지하세요.
평가 결과 · 버그 신고 · 기여하기
Local AI는 유료 업그레이드가 아닌 기본 기능입니다. 클라우드 AI 서비스가 필요하지 않습니다.
로컬 파일 접근: 홈 디렉터리로 제한됩니다. 디렉터리 목록은 심볼릭 링크를 식별하고 외부 디렉터리에 도달하는 패턴을 거부합니다.대화 메모리: ~/.local/share/jarvis 아래에 로컬로 저장됩니다.
민감 정보: 모델 컨텍스트 및 저장된 일기 항목 전에 마스킹 처리됩니다. 인메모리 채팅은 여전히 사용자가 입력한 내용을 보여줍니다.네트워크 경계: 모델 다운로드, 웹 도구 및 활성화된 통합은 네트워크 요청을 할 수 있습니다. 외부 모델 엔드포인트는 사용자님이 전송하는 요청을 받습니다.
선택적 네트워크 접근 줄이기
로컬 모델 엔드포인트를 사용하고 필요한 모델을 먼저 다운로드하며, 웹 도구를 비활성화하고 MCP 통합은 비워두세요. 이러한 설정은 검색 및 자동 위치 감지 기능을 끕니다:
{
"web_search_enabled": false,
"wikipedia_fallback_enabled": false,
...
}
이러한 옵션들은 네트워크 방화벽이 아닙니다. 다른 온라인 도구 및 앱 업데이트 확인은 여전히 네트워크를 사용할 수 있으므로, 필요한 경우 별도로 네트워크 제한을 적용하세요.
Jarvis는 개인 사용에 무료입니다. 상업적 용도의 경우 문의해 주세요.
만약 데스크톱에서 자리를 얻었다면, 계속 성장하는 것을 도와주세요.