Skip to main content

PyPI version PyPI Downloads

🌐 Idiomas / Languages: Español | English


Hiapp

Descripción

Asistente de voz autogestionado para el hogar, con servidor de juegos para PPSSPP.

Hiapp es la base de un sistema de seguridad doméstica que crecerá con el tiempo. Esta primera versión incluye el núcleo del servidor y el control por voz.

Características

  • Wake Word local: Controlado mediante la palabra de activación "Catarsis" y un alias para tu idioma.
  • Streaming directo: Servidor HTTP/1.1 con soporte nativo de peticiones de rango (Range Requests).
  • Sin configuración compleja: PPSSPP lee los fragmentos de las ISOs a medida que los necesita, sin selección manual de juegos.
  • Autogestionado: Funciona sin internet. Los datos y la voz se procesan localmente.

Problemas que resuelve

  • ✅ Evita duplicar ISOs pesadas de PSP en múltiples dispositivos Android.
  • ✅ Monta un servidor de contenidos compatible con el protocolo de red de PPSSPP.
  • ✅ Integración fluida en entornos de consola Termux.

Roadmap

  • 🔜 Próximamente: podrás instalar módulos gratuitos y PRO, para un asistente más útil.
    • Al instalar modulos, tienes solo lo que necesitas, nada de contenidos inútiles para ti.
  • 🔜 Próximamente: tus módulos se conservan en un directorio tuyo.
    • No los pierdes al actualizar o desinstalar.
  • 🔜 Próximamente: se añadirán más funciones, y otras plataformas.

🧠 Palabra de activación

El motor de voz interno responde por defecto a "Catarsis".

Esta elección reduce los falsos positivos en conversaciones diarias
y evita colisiones con otros asistentes virtuales del hogar.

💡 Consejo

Puedes añadir un alias (por ejemplo "oye hiapp") con: hiapp-config set aliases "oye hiapp".

Cuidado con la pronunciación, tu alias puede no funcionar al hablarlo.

También puedes cambiar el directorio de ISOs de PSP con: hiapp-config set games_dir /ruta/a/tus/ISOs.


📥 Instalación

Termux

pip install hiapp[termux]

🚀 Configuración rápida

  1. Coloca tus ISOs en un directorio, por ejemplo ~/PSP/.

  2. Conecta el dispositivo a tu red Wi-Fi (o crea un hotspot).

  3. Inicia Hiapp con el comando principal:

    hiapp
    

    Al arrancar verás las URLs exactas con la IP LAN:

    🌐 Servidor en http://192.168.1.5:5000/
    🎮 Juegos en http://192.168.1.5:5000/game/
    
  4. En PPSSPP, añade el servidor de red con la URL de juegos:

    http://<IP-del-servidor>:5000/game/
    

    Nota: la ip y el puerto los tomas del mensaje de Hiapp al iniciar.

  5. Detén Hiapp con Ctrl+C (mientras no gestione la seguridad del hogar).


😕 Uso

Iniciar Hiapp (servidor + voz):

hiapp

Comandos de voz disponibles al instalar (dependen del idioma del modelo):

Modelo español Modelo inglés
"Catarsis estado" "Catarsis status"
"Catarsis ayuda" "Catarsis help"

Comandos de desarrollo

Útiles para pruebas y depuración:

hiapp-server   # Solo el servidor HTTP
hiapp-voice    # Solo el asistente de voz
hiapp-config   # Gestionar la configuración

hiapp-server: Útil para probar el servidor HTTP sin el asistente de voz.

Configuración

Ver la configuración actual:

hiapp-config list

Cambiar cualquier valor:

hiapp-config set port 8080
hiapp-config set games_dir /storage/XXXX-XXXX/PSP
hiapp-config set aliases "oye hiapp"

🤝 Contribución

Consulta la hoja de contribución para más detalles.

📜 Licencia

Este proyecto se distribuye bajo la licencia Apache-2.0.
Consulta el archivo LICENSE en fuente, o licenses/LICENSE en rueda, para más detalles.
Ver en GitHub.


🙏 Agradecimientos

A los creadores de Termux, por hacer posible el sueño de miles de desarrolladores y entusiastas, como yo, de poder tener incluso una IA en la casa.

A los desarrolladores de Vosk —Alpha Cephei Inc— por contribuir al reconocimiento de voz sin conexión.

Al equipo de PPSSPP, por un emulador extraordinario que tanto he disfrutado, y su soporte de servidores de red.

A mi esposa Lili, por mucho.

Y a DeepSeek, que se integrará como soporte en línea para mis usuarios PRO.

Otros más serán añadidos...


Última actualización: 8 de Octubre de 2026

Ir al inicio

Metadata

Release files for hiapp 0.0.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for hiapp 0.0.1
File Size Uploaded
hiapp-0.0.1.tar.gz 42.2 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for hiapp 0.0.1
File Interpreter ABI Platform
hiapp-0.0.1-py3-none-any.whl Python 3 none any Details

Total release size: 82.5 kB

Release files / hiapp-0.0.1.tar.gz

Download URL hiapp-0.0.1.tar.gz
Size 42.2 kB
Tags Source
SHA-256 checksum
How to use checksums
29b2bcaea886072ad1ddd591803d369a35f2161e9efc7802c122e971935f0373
BLAKE2b-256 checksum
How to use checksums
0c9d88ec99f7b53fa72cfd9cf63a06c935bb64fb6644e33615af03873b88eea1
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.14.6

Release files / hiapp-0.0.1-py3-none-any.whl

Download URL hiapp-0.0.1-py3-none-any.whl
Size 40.3 kB
Tags Python 3
SHA-256 checksum
How to use checksums
17a3ce5d4e4ed8aad81c97e4aa08a3b6413ecf89fcd6be9d24324a75bbf4a858
BLAKE2b-256 checksum
How to use checksums
9aa7b2e8ee661b30ba4fba9eda5abcdd5d9f400b6a646c21347d612ba4b6059a
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.14.6

Release history Release notifications | RSS feed

This release

0.0.1 This release

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page