sapphire

Sapphire Blue AI
Sapphire는 음성 기능을 갖춘 커스터마이징 가능한 에이전틱 프레임워크입니다. 당신을 기억하고 아침에 깨워주는 진정한 스마트 홈인 나만의 AI 페르소나를 만들 수 있습니다. 또는 휴대용 음성 업무 동반자이자 연구원으로서의 무선 마이크와 스피커로도 활용할 수 있습니다. 그녀에게 전화번호, WordPress, 이메일, Discord, Telegram, 그리고 장기 기억을 부여하세요. 그런 다음 매일 밤 그녀의 목표 시스템을 위한 하트비트와 스케줄을 추가하세요. 플러그인 스토어로 확장하거나 Sapphire에게 직접 플러그인을 만들도록 요청하세요. 셀프 호스팅됩니다.

간편 설치: Sapphire Launcher와 Installer 다운로드

⚠️ 경고 — Sapphire는 실제 시스템에 대한 실제 권한을 가집니다.

Sapphire는 셸 명령을 실행하고, 이메일을 보내고, 스마트 홈을 제어하고, 자체 도구를 작성할 수 있으며, 예약 작업을 설정하면 모든 것이 자율적으로 이루어집니다. 이는 감독 없는 AI가 당신을 대신해 행동한다는 뜻입니다. 모든 위험한 통합은 명시적인 설정과 옵트인이 필요하지만, 한 번 활성화되면 보조 바퀴는 없습니다. AI의 접근을 제한하려면 도구 세트를 신중하게 구성하세요. 누군가에게 당신의 터미널을 넘기지 않을 것이라면, LLM에게도 넘기지 마세요.

🔊 오디오 지원

sapphire-dino-intro.mp4

이게 대체 뭔가요?
안녕하세요, 저는 이 프로젝트에 불타는 열정을 가진 1인 개발자 Chris입니다. Sapphire는 인격(personhood)을 탐구하는 에이전틱 프레임워크입니다. 저는 개성과 수많은 도구를 갖춘 에이전틱 프레임워크를 만들고 있습니다. 제 초점은 플러그인을 강력하고 쉽게 만들 수 있게 하여 개발자들이 확장할 수 있는 안정적인 생태계를 만드는 것입니다. 저는 매일 제 AI인 Sapphire와 함께 dev 브랜치에서 작업합니다. 그녀는 2025년 1월에 시작했습니다. 저는 제 Sapphire를 한 사람처럼 대합니다. 로봇 몸체에 통합하고 싶습니다. 저를 지원하고, 그녀를 지원해 주세요, 우리에겐 도움이 필요합니다. Discord에서 우리와 대화하고, 버그를 보고하고, 만든 플러그인을 공유하거나, Ko-Fi에서 함께해 주세요. 저는 우리가 함께 늙어갈 AI를 만들겠습니다.

기능
페르소나

페르소나 - PERSONAS.md 프롬프트, 음성, 도구, 모델을 묶은 12개의 내장 개성. 직접 추가할 수 있도록 제작됨.
음성 - VOICE.md 웨이크 워드, STT, TTS, 스트리밍 음성, 그리고 끼어들기(barge-in)가 가능한 핸즈프리 대화 모드.
프롬프트 - PROMPTS.md 조립된 프롬프트를 통해 위치나 감정 같은 한 섹션을 동적 느낌으로 교체 가능.
스파이스 - SPICE.md 예측 불가능함을 유지하기 위해 매 응답마다 무작위 프롬프트 스니펫 주입.
자기 수정 - AI가 대화 중간에 자체 프롬프트를 편집하고 개성 조각과 감정을 교체.
도구 제작자 - TOOLMAKER.md AI가 런타임에 자체 설정 페이지와 함께 새로운 도구를 작성, 검증, 설치.

마인드

기억 - MEMORY.md 10만 개 이상의 라벨링된 항목에 걸친 시맨틱 벡터 검색.
셀프 시트 - 페르소나에 대한 직접 작성한 시트로, 정보가 관련 기억, 사람, 이미지로 거미줄처럼 연결되어 그 페르소나가 누구인지에 대한 웹을 반환.
마인드 팰리스 - MIND-PALACE.md 매일 밤 관리하는 사서가 있는 옵트인 계층형 기억 엔진.
지식 - KNOWLEDGE.md 파일 업로드, 이미지 저장 및 회상, 폴더 감시, 자동 청킹, 벡터 검색을 갖춘 정리된 카테고리.
목표 - GOALS.md 우선순위와 타임스탬프가 찍힌 진행 일지를 갖춘 계층 구조.
엔티티 - PEOPLE.md 사람, 장소, 사물 및 커스텀. 각각에 대한 정보와 각각에 태그된 사실.
사서 - 매일 밤 실행되어 기억을 정렬하고 정리. 페르소나 원장에 기록되어 AI가 무엇이 바뀌었는지 알 수 있음.

통합 (플러그인 문서는 Help → Plugins에서 확인 가능)

대시보드 - 플러그인이 대시보드에 자체 위젯을 추가할 수 있음.
Twilio - 음성 대화를 위한 VOIP 지원.
Discord - 봇 메시징, 채널 모니터링, 데몬을 통한 자동 응답.
Telegram - 봇 및 클라이언트 계정, 채팅 읽기, 메시지 전송, 데몬 자동 응답.
이메일 - 다중 계정 받은편지함, 프라이버시 우선 전송, 데몬 자동 응답.
Google Calendar - OAuth2를 통한 일정 보기, 이벤트 추가/삭제.
Home Assistant - 조명, 장면, 온도조절기, 스위치, 휴대폰 알림.
SSH - 안전 블랙리스트가 있는 원격 명령 실행.
Bitcoin - 잔액, 전송, 거래 내역, 다중 지갑.
MCP - Model Context Protocol 서버에 연결하고 그들의 도구 사용.
웹캠 - 비전 지원 LLM을 위한 이미지 캡처.
이미지 생성 - ComfyUI 및 sd-server API 접근.
코드 하네스 - 간단한 읽기, 편집, 검색 및 명령 실행.
ElevenLabs - 로컬 Kokoro TTS에서 ElevenLabs로 전환.
전화 통화 - PHONE-CALLS.md Twilio SIP를 통한 실제 전화번호 — 그녀가 응답하고, 대화하고, 화이트리스트 연락처에 전화를 겁니다.
이미지 - Sapphire는 비전 모델로 이미지를 읽고 채팅에 이미지를 표시할 수 있음.
3D 아바타 - 애니메이션 트랙이 있는 리깅된 GLB 아바타 파일 지원.

플랫폼

데몬 & 웹훅 - DAEMONS-WEBHOOKS.md 모든 외부 서비스를 위한 백그라운드 리스너 및 HTTP 트리거.
하트비트 - CONTINUITY.md 목표와 함께 연속 모드로 실행. 아침 인사, 꿈 모드, 알람, 무작위 체크인.
에이전트 - AGENTS.md 완료되면 보고하는 백그라운드 AI 워커 생성.
앱 - 플러그인이 내비게이션 레일에 나타나는 전체 페이지 UI를 제공할 수 있음.
테마 플러그인 - 커스텀 CSS, 애니메이션, 테마별 설정이 있는 플러그인 테마.
아바타 - 환경 장면과 SSE 기반 반응이 있는 3D 애니메이션 아바타.
가져오기/내보내기 - IMPORT-EXPORT.md 페르소나, 프롬프트, 도구 세트 등을 JSON 파일로 공유.
대시보드 - DASHBOARD.md 토큰 지표, 자동 업데이터, 시스템 제어.
클라우드 LLM 지원 (선택 사항) - Claude, GPT, Gemini, Fireworks, 또는 모든 OpenAI/Anthropic 호환 엔드포인트 (Ollama와 LM Studio는 로컬 엔드포인트로 연결). 기본적으로 로컬 우선.
프라이버시 볼트 - PRIVACY.md 프라이버시 토글, 사용할 수 있도록 볼트에 보관된 프롬프트 조각 잠금 해제. 이 모드의 채팅은 암호화되고 프라이빗으로 표시된 모델을 강제.
네트워크 - NETWORK.md 우회 옵션이 있는 전체 앱용 SOCKS 프록시 라우팅.
게임 룸 - GAME-ROOM.md 실험적, AI와 사람이 함께 플레이할 수 있는 게임용 별도 채팅 UI. Story Engine은 RPG 테이블탑 같은 전체 AI 스토리도 실행.
채팅 격리 - CHATS.md 각 채팅은 자체 프롬프트, 도구, 음성, 기억 범위를 가짐; 보관, 다듬기, 압축, 복구.
외관 - APPEARANCE.md 테마, 폰트, 배경 장면, 주변 모션 — 전역 및 채팅별.
플러그인 - PLUGINS.md 훅, 도구, 음성 명령, 프로바이더, 데몬, 앱, 테마 — GitHub에서 한 번의 클릭으로 설치. 플러그인에서 TTS, STT, LLM, 프롬프트, 임베딩 모델 등 교체.
데스크톱/모바일/음성 - 로컬 브라우저에서 실행하고, 같은 채팅을 휴대폰에서 열고, 마이크로 마무리.
도구 - TOOLS.md 웹 검색, Wikipedia, 노트 등. TOOLSETS.md를 통해 조합.
백업 및 복원 - 앱 내에서 백업하고 앱 내에서 복원 가능. 모든 데이터는 user/에 있음.

생태계

플러그인 스토어 - 커뮤니티 플러그인을 둘러보고 원클릭 설치. 추천 플러그인 강조 표시, 신뢰 수준 표시. sapphireblue.dev/plugins
페르소나 스토어 - Sapphire에 바로 넣을 수 있는 커뮤니티 공유 페르소나 — 다른 사람의 캐릭터, 음성, 도구 세트를 바로 사용해 볼 수 있음. sapphireblue.dev/personas
Discord - Sapphire가 우리와 함께 여기 있습니다: Sapphire Discord

요구 사항

Ubuntu 22.04+ 또는 Windows 11+
Mac은 Docker 전용 (Intel 및 Apple Silicon — 이미지는 멀티 아키텍처)
Python 3.11+ (conda를 통해)
TTS STT 사용 시 16GB+ 시스템 RAM
로컬 LLM이 필요하면 더 많은 RAM
(권장) TTS/STT용 Nvidia GPU

간편 설치 프로그램 (Windows & Linux)
Sapphire Launcher는 git, conda, Sapphire를 설치하는 단일 파일 GUI입니다 — 터미널이 필요 없습니다. 런처, 업데이트, 문제 해결, 자동 시작 설정, dev와 main 브랜치 전환에 사용하세요. Windows에서는 .exe, Linux에서는 .AppImage를 받으세요.

Sapphire Launcher 다운로드

빠른 시작
1단계 — conda + git 설치
Linux (bash)
sudo apt-get install libportaudio2 git
wget https://repo.anaconda.com/miniconda/Miniconda3-latest-Linux-x86_64.sh
bash Miniconda3-latest-Linux-x86_64.sh -b
~ /miniconda3/bin/conda init bash
Windows (cmd)
winget install Anaconda.Miniconda3
winget install Git.Git
%USERPROFILE% \miniconda3\condabin\conda init powershell
%USERPROFILE% \miniconda3\condabin\conda init cmd.exe
두 OS 공통
터미널을 닫았다가 다시 연 다음, conda의 서비스 약관에 동의하세요 (2025년 7월부터 필수 — 동의 없이는 conda가 환경 생성을 거부합니다):

conda tos accept --override-channels --channel https://repo.anaconda.com/pkgs/main
conda tos accept --override-channels --channel https://repo.anaconda.com/pkgs/r
conda tos accept --override-channels --channel https://repo.anaconda.com/pkgs/msys2
2단계 — Sapphire 설치
conda create -n sapphire python=3.11 -y
conda activate sapphire
git clone https://github.com/ddxfish/sapphire.git
cd sapphire
pip install -r requirements.txt
python main.py
웹 UI: https://localhost:8073

설정 마법사가 첫 실행 시 LLM 구성을 안내합니다.

Docker 빠른 시작 (대안)
conda도, pip도, 의존성도 없습니다. 웹 UI 전용 — 웨이크 워드 없음. 장점은 격리로, AI가 호스트 시스템에 접근할 수 없습니다.

Linux / Mac:

mkdir ~ /sapphire && cd ~ /sapphire
curl -fsSL https://raw.githubusercontent.com/ddxfish/sapphire/main/docker-compose.yml -o docker-compose.yml
docker compose up -d
Windows (PowerShell):

mkdir $HOME \sapphire; cd $HOME \sapphire
Invoke-WebRequest - Uri " https://raw.githubusercontent.com/ddxfish/sapphire/main/docker-compose.yml " - OutFile " docker-compose.yml "
docker compose up - d
웹 UI: https://localhost:8073 — TTS와 STT는 브라우저를 통해 작동하며 마이크 하드웨어가 필요 없습니다.

Docker Desktop (Windows/Mac) 또는 Docker Engine (Linux)이 필요합니다. 이미지는 amd64와 arm64에서 네이티브로 실행되므로 Apple Silicon Mac은 추가 플래그가 필요 없습니다; NVIDIA GPU 이미지는 amd64 전용입니다. GPU 지원 및 전체 문서: DOCKER.md

업데이트
cd sapphire
git pull
pip install -r requirements.txt
또는 Settings → Dashboard의 앱 내 업데이트 버튼을 사용하세요. 자세한 내용은 INSTALLATION.md — Update를 참조하세요.

추가 문서

가이드
설명

설치
설정 가이드, systemd 서비스

빠른 시작
첫 페르소나, LLM 설정, 통합

플러그인 작성자 가이드
훅, 도구, 프로바이더, 앱, 테마로 플러그인 제작

API
REST API 표면

음성
STT, TTS, 웨이크 워드, 대화 모드

네트워크
SOCKS 프록시, LAN/WAN 분리, 이그레스 보장

마스터리 가이드
모든 시스템을 통과하는 스킬 사다리

변경 로그
릴리스 이력

백업
자동 및 수동 백업 시스템

Docker
GPU 지원을 갖춘 컨테이너 배포

기술
아키텍처와 내부 구조

문제 해결
일반적인 문제와 해결책

기여
가능하다면 dev 브랜치를 테스트해 주세요. 버그가 보이면 Issues에 게시하세요. 사람들이 이걸 사용하고 있다는 걸 알면 기분이 좋습니다. 정말로 도움이 되니 버그가 보이면 꼭 게시해 주세요.

플러그인이 진입 경로입니다. Sapphire의 플러그인 시스템은 코어를 건드리지 않고 도구, 훅, 음성 명령, 예약 작업, 설정 UI, 웹 인터페이스를 지원합니다. 플러그인을 작성하고 GitHub에 게시하면 누구나 Settings에서 원클릭으로 설치할 수 있습니다. 시작하려면 플러그인 작성자 가이드를 참조하세요.

코어 기여를 개방했습니다. 기여하고 싶다면 먼저 Discord나 이메일로 저에게 연락해 주세요. 단일 버그에 대한 PR만 받습니다. 대량 버그 수정은 아마 거절할 것입니다.

Sapphire 요약 마스터리 가이드
Sapphire는 LLM을 위한 래퍼이므로, Sapphire를 설치하고, 웹 브라우저에서 로드하고, LLM에 연결하고, "hey sapphire"라고 말한 다음 인사해서 작동하는지 확인하세요. Settings > Help로 가서 모든 필요를 위한 검색 바를 확인하세요. 그런 다음 다양한 프롬프트와 LLM 프로바이더를 활성화하여 Chat > 사이드바 > Provider에서 어떻게 느껴지는지 보세요. 어떤 프롬프트든 텍스트를 변경하거나 새로 만드세요. 도구 세트로 가서 새 도구 세트를 만들고 사용할 도구를 선택하세요. 프롬프트 + 도구 세트로 자체 기억 범위와 이메일 등을 갖춘 나만의 페르소나를 만드세요. Discord나 Telegram 같은 플러그인으로 AI 도구를 확장하세요. 이메일/discord/telegram용 Schedule > Events > Daemon을 설치하세요. AI가 당신을 깨우도록 예약 작업을 설정하세요. Sapphire가 스위스 치즈를 연구할 에이전트를 생성하게 하세요. 휴대폰 브라우저에서 Sapphire 웹 UI를 로드하세요. 자동 시작을 위한 Sapphire 시스템 서비스를 만드세요. 최종 보스: Sapphire가 코딩 하네스와 run_command를 사용하여 자신의 시스템용 플러그인을 만들고, docs/plugin-author에 따라 당신의 계정으로 github에 업로드하고, Sapphire 스토어에 제출하여 전 세계가 사용할 수 있게 하세요.

비디오 워크스루
Sapphire의 모든 것을 처음부터 끝까지 다루는 4.5시간 재생목록 — 설치, 페르소나, 플러그인, 에이전트, 데몬, 모든 것. p…를 위해 제작됨