Repolode
judahpaul16

judahpaul16/gpt-home

Un asistente de voz autohospedado para Raspberry Pi que usa LiteLLM y LangGraph para llevar conversaciones al estilo de ChatGPT a un hogar inteligente.

Alternativa open source a:Amazon AlexaGoogle Nest Hub

Estrellas
653
Forks
68
Issues abiertos
0
Último commit
hace 2 meses

¿Qué es?

GPT Home es un asistente de voz que puedes montar tú mismo en una Raspberry Pi u otro equipo Linux, como alternativa autohospedada a altavoces inteligentes comerciales como Google Nest Hub o Amazon Alexa. Dirige las solicitudes a través de LiteLLM, por lo que puede usar cualquiera de los más de 100 proveedores compatibles, incluidos OpenAI, Anthropic y Google. La clave de API se puede configurar en un archivo .env o desde una página de ajustes web.

El asistente responde preguntas generales, traduce, consulta el clima en OpenWeatherMap u Open-Meteo y gestiona alarmas, recordatorios, listas de tareas y el acceso a calendarios CalDAV. También controla la reproducción de Spotify y las luces Philips Hue, y conserva la memoria de forma persistente en PostgreSQL con pgvector. El proyecto se ejecuta como un conjunto de servicios de Docker Compose: un backend de voz, un servidor FastAPI, un frontend React, nginx como proxy inverso y un servicio Spotify Connect.

La configuración se realiza mediante un script que instala Docker y las dependencias relacionadas. También incluye un script para configurar Wi-Fi en placas Pi sin Ethernet. La entrada y salida de audio funcionan con dispositivos ALSA o PortAudio, y una pequeña pantalla I2C o SPI opcional puede mostrar el estado.

Funciones clave

  • 01Se conecta a más de 100 proveedores de LLM a través de LiteLLM; la clave de API se configura mediante .env o la interfaz web.
  • 02Gestiona alarmas, recordatorios, listas de tareas y eventos de calendario CalDAV.
  • 03Consulta el clima mediante OpenWeatherMap y Open-Meteo.
  • 04Controla la reproducción de Spotify y las luces Philips Hue.
  • 05Almacena memoria persistente en PostgreSQL con pgvector.
  • 06Se ejecuta como servicios de Docker Compose e incluye un script de configuración para Raspberry Pi y otros sistemas Linux.

Casos de uso

  • Montar un asistente de voz doméstico en una Raspberry Pi como alternativa a los altavoces inteligentes comerciales que prioriza la privacidad.
  • Añadir control conversacional de Spotify y las luces Philips Hue a un hogar inteligente de fabricación propia.
  • Experimentar con flujos de trabajo de asistentes de voz que combinan LLM, entrada de voz e integraciones para hogares inteligentes.

Inicio rápido

  1. 1

    Ejecuta el script oficial de configuración indicado en el README (envía un script remoto a bash, así que ejecútalo tú mismo).

  2. 2

    Configura LITELLM_API_KEY en el archivo .env (o desde la interfaz web en gpt-home.local/settings).

  3. 3

    Reinicia los servicios para aplicar la nueva clave.

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

    Consulta los registros para comprobar que el asistente está en ejecución.

    docker compose logs -f

Antes de usarlo

  • Diseñado para Raspberry Pi y sistemas Linux; requiere hardware de audio, como un altavoz y un micrófono.
  • Necesita una clave de API de un proveedor de LLM, lo que puede generar costes de uso.
  • Se distribuye con la licencia GPL-3.0, una licencia copyleft que exige que las obras derivadas sean de código abierto.

En colecciones

Temas

Preguntas frecuentes

¿Qué es gpt-home?
Un asistente de voz autohospedado para Raspberry Pi que usa LiteLLM y LangGraph para llevar conversaciones al estilo de ChatGPT a un hogar inteligente. GPT Home es un asistente de voz que puedes montar tú mismo en una Raspberry Pi u otro equipo Linux, como alternativa autohospedada a altavoces inteligentes comerciales como Google Nest Hub o Amazon Alexa. Dirige las solicitudes a través de LiteLLM, por lo que puede usar cualquiera de los más de 100 proveedores compatibles, incluidos OpenAI, Anthropic y Google. La clave de API se puede configurar en un archivo .env o desde una página de ajustes web.
¿gpt-home es gratuito? ¿Qué licencia tiene?
gpt-home es open source bajo la licencia GPL-3.0. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿gpt-home sigue mantenido?
Actualizado en los últimos 6 meses. El último commit de gpt-home fue el 13 sept 2026.
¿Para qué puedo usar gpt-home?
Montar un asistente de voz doméstico en una Raspberry Pi como alternativa a los altavoces inteligentes comerciales que prioriza la privacidad. Añadir control conversacional de Spotify y las luces Philips Hue a un hogar inteligente de fabricación propia. Experimentar con flujos de trabajo de asistentes de voz que combinan LLM, entrada de voz e integraciones para hogares inteligentes.
¿Cómo se instala gpt-home?
Ejecuta el script oficial de configuración indicado en el README (envía un script remoto a bash, así que ejecútalo tú mismo). Configura LITELLM_API_KEY en el archivo .env (o desde la interfaz web en gpt-home.local/settings). Reinicia los servicios para aplicar la nueva clave.: docker compose down && docker compose up -d Consulta los registros para comprobar que el asistente está en ejecución.: docker compose logs -f
¿Dónde consigo gpt-home?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/judahpaul16/gpt-home

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados