judahpaul16/gpt-home

어떤 프로젝트인가요?

핵심 기능

• 01LiteLLM을 통해 100개 이상의 LLM 제공업체에 연결하며, .env 또는 웹 UI에서 API 키를 설정할 수 있습니다.
• 02알람, 리마인더, 할 일 목록, CalDAV 캘린더 이벤트를 처리합니다.
• 03OpenWeatherMap 및 Open-Meteo를 통해 날씨를 조회합니다.
• 04Spotify 재생과 Philips Hue 조명을 제어합니다.
• 05pgvector를 사용하는 PostgreSQL에 지속성 메모리를 저장합니다.
• 06Raspberry Pi 및 기타 Linux 시스템용 설치 스크립트와 함께 Docker Compose 서비스로 실행됩니다.

활용 사례

• 상용 스마트 스피커의 개인정보 보호 중심 대안으로 Raspberry Pi에 홈 음성 비서를 구축합니다.
• DIY 스마트홈에 Spotify와 Philips Hue 조명의 대화형 제어 기능을 추가합니다.
• LLM, 음성 입력, 스마트홈 연동을 결합하는 음성 비서 파이프라인을 실험합니다.

빠른 시작

1. 1

   README에 있는 공식 설정 스크립트를 실행합니다(원격 스크립트를 bash로 파이프하므로 직접 실행하세요).

2. 2

   .env 파일에서 LITELLM_API_KEY를 설정합니다(또는 gpt-home.local/settings의 웹 인터페이스에서 설정합니다).

3. 3

   새 키를 적용하려면 서비스를 재시작합니다.

   docker compose down && docker compose up -d
4. 4

   로그를 확인해 어시스턴트가 실행 중인지 확인합니다.

   docker compose logs -f

사용 전 알아둘 점

• !Raspberry Pi 및 Linux 시스템용으로 설계되었으며, 스피커와 마이크 같은 오디오 하드웨어가 필요합니다.
• !LLM 제공업체의 API 키가 필요하며 사용 요금이 발생할 수 있습니다.
• !카피레프트 라이선스인 GPL-3.0에 따라 제공되며, 파생 저작물은 오픈 소스로 공개해야 합니다.

포함된 컬렉션

토픽

자주 묻는 질문

gpt-home은(는) 무엇인가요?

LiteLLM과 LangGraph를 사용해 ChatGPT 스타일의 대화를 스마트홈에 도입하는 Raspberry Pi용 셀프 호스팅 음성 비서입니다. GPT Home은 Raspberry Pi나 다른 Linux 머신에 직접 설치해 사용하는 음성 비서로, Google Nest Hub나 Amazon Alexa 같은 상용 스마트 스피커의 셀프 호스팅 대안입니다. LiteLLM을 통해 요청을 전달하므로 OpenAI, Anthropic, Google을 포함해 LiteLLM이 지원하는 100개 이상의 제공업체 중 원하는 언어 모델을 사용할 수 있습니다. API 키는 .env 파일이나 웹 설정 페이지에서 지정할 수 있습니다.

gpt-home은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

gpt-home은(는) GPL-3.0 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

gpt-home은(는) 아직 유지보수되고 있나요?

6개월 이내 업데이트. gpt-home의 마지막 커밋은 2026년 9월 13일입니다.

gpt-home은(는) 어디에 사용할 수 있나요?

상용 스마트 스피커의 개인정보 보호 중심 대안으로 Raspberry Pi에 홈 음성 비서를 구축합니다. DIY 스마트홈에 Spotify와 Philips Hue 조명의 대화형 제어 기능을 추가합니다. LLM, 음성 입력, 스마트홈 연동을 결합하는 음성 비서 파이프라인을 실험합니다.

gpt-home는 어떻게 설치하나요?

README에 있는 공식 설정 스크립트를 실행합니다(원격 스크립트를 bash로 파이프하므로 직접 실행하세요). .env 파일에서 LITELLM_API_KEY를 설정합니다(또는 gpt-home.local/settings의 웹 인터페이스에서 설정합니다). 새 키를 적용하려면 서비스를 재시작합니다.: docker compose down && docker compose up -d 로그를 확인해 어시스턴트가 실행 중인지 확인합니다.: docker compose logs -f

gpt-home은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/judahpaul16/gpt-home