Metadata-Version: 2.4
Name: hiapp
Version: 0.0.1
Summary: Aplicación de inteligencia para seguridad del hogar. Con asistente de voz.
Author-email: Dixan Pupo Morales <triplex3x.cyver@gmail.com>
Maintainer-email: Dixan Pupo Morales <triplex3x.cyver@gmail.com>
License-Expression: Apache-2.0
Project-URL: Homepage, https://github.com/Triplex3x-cyver/hiapp
Project-URL: Repository, https://github.com/Triplex3x-cyver/hiapp
Project-URL: Issues, https://github.com/Triplex3x-cyver/hiapp/issues
Project-URL: Changelog, https://github.com/Triplex3x-cyver/hiapp/blob/main/docs/CHANGELOG.md
Keywords: PPSSPP,vosk-termux,speech recognition,home automation,ai
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: End Users/Desktop
Classifier: Topic :: Home Automation
Classifier: Topic :: Games/Entertainment
Classifier: Topic :: Multimedia :: Sound/Audio :: Speech
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.14
Classifier: Operating System :: POSIX :: Linux
Classifier: Operating System :: Android
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
License-File: LICENSE_ES
Requires-Dist: flask>=3.1.3
Requires-Dist: requests>=2.31.0
Requires-Dist: sounddevice
Requires-Dist: tqdm
Provides-Extra: termux
Requires-Dist: vosk-termux>=0.0.2; extra == "termux"
Provides-Extra: desktop
Requires-Dist: vosk; extra == "desktop"
Dynamic: license-file

[![PyPI version](https://img.shields.io/pypi/v/hiapp.svg)](https://pypi.org/project/hiapp)
[![PyPI Downloads](https://static.pepy.tech/personalized-badge/hiapp?period=total&units=INTERNATIONAL_SYSTEM&left_color=BLACK&right_color=GREEN&left_text=Downloads)](https://pepy.tech/projects/hiapp)

**🌐 Idiomas / Languages:** Español | [English](https://github.com/Triplex3x-cyver/hiapp/blob/main/README_EN.md)

---

# 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
```bash
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:

   ```bash
   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):

```bash
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:

```bash
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:

```bash
hiapp-config list
```

Cambiar cualquier valor:

```bash
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](https://github.com/Triplex3x-cyver/hiapp/blob/main/docs/CONTRIBUTING.md) 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](https://github.com/Triplex3x-cyver/hiapp/blob/main/LICENSE).

---

## 🙏 Agradecimientos
A los creadores de [Termux](https://termux.dev/), 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](https://github.com/alphacep/vosk-api) —**Alpha Cephei Inc**— por contribuir al reconocimiento de voz sin conexión.


Al equipo de [PPSSPP](https://www.ppsspp.org/), por un emulador extraordinario que tanto he disfrutado, y su soporte de servidores de red.


A mi esposa Lili, por mucho.


Y a [DeepSeek](https://chat.deepseek.com/), 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](#hiapp)
