{"id":45189795,"url":"https://github.com/dankopetro/fina-ergen","last_synced_at":"2026-03-12T05:03:32.580Z","repository":{"id":339533638,"uuid":"1162302561","full_name":"dankopetro/Fina-Ergen","owner":"dankopetro","description":"El Asistente de Voz Modular y Domótico para Linux","archived":false,"fork":false,"pushed_at":"2026-03-07T00:22:14.000Z","size":319075,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2026-03-07T04:11:04.480Z","etag":null,"topics":["fina-ergen","iot-automation","linux-assistant","open-source","plugins-markt","python"],"latest_commit_sha":null,"homepage":"https://fina-ergen.vercel.app/","language":"Vue","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/dankopetro.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":"docs/ROADMAP.md","authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null},"funding":{"buy_me_a_coffee":"dankopetro","custom":["https://paypal.me/dankopetro"]}},"created_at":"2026-02-20T05:05:12.000Z","updated_at":"2026-03-07T00:22:17.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/dankopetro/Fina-Ergen","commit_stats":null,"previous_names":["dankopetro/fina-ergen"],"tags_count":36,"template":false,"template_full_name":null,"purl":"pkg:github/dankopetro/Fina-Ergen","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dankopetro%2FFina-Ergen","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dankopetro%2FFina-Ergen/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dankopetro%2FFina-Ergen/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dankopetro%2FFina-Ergen/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/dankopetro","download_url":"https://codeload.github.com/dankopetro/Fina-Ergen/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dankopetro%2FFina-Ergen/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30284636,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-09T02:57:19.223Z","status":"ssl_error","status_checked_at":"2026-03-09T02:56:26.373Z","response_time":61,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["fina-ergen","iot-automation","linux-assistant","open-source","plugins-markt","python"],"created_at":"2026-02-20T12:00:21.769Z","updated_at":"2026-03-09T06:03:52.379Z","avatar_url":"https://github.com/dankopetro.png","language":"Vue","funding_links":["https://buymeacoffee.com/dankopetro","https://paypal.me/dankopetro","https://www.buymeacoffee.com/dankopetro"],"categories":[],"sub_categories":[],"readme":"\u003ch1 align=\"center\"\u003e\n  \u003cimg src=\"static/assets/avatar.png\" width=\"120\" alt=\"Fina AI\"\u003e\n  \u003cbr\u003eFina Ergen v3.5\n\u003c/h1\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cstrong\u003eEl Asistente de Voz Modular y Domótico para Linux\u003c/strong\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"#-características\"\u003eCaracterísticas\u003c/a\u003e •\n  \u003ca href=\"#️-arquitectura-modular\"\u003eArquitectura Modular\u003c/a\u003e •\n  \u003ca href=\"#-instalación-rápida\"\u003eInstalación Rápida\u003c/a\u003e •\n  \u003ca href=\"./docs/MANUAL_DE_USUARIO_COMPLETO.md\"\u003e📚 Manual Completo\u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"manual_images/ui_check.png\" width=\"800\" alt=\"Fina Ergen Interface\"\u003e\n\u003c/p\u003e\n\n---\n\n**Fina Ergen** no es solo un script; es un cerebro avanzado que corre localmente en tu sistema Linux con una hermosa interfaz nativa de escritorio (Tauri/Vue). Diseñada para procesar lenguaje natural en español con extrema rapidez offline, Fina es capaz de todo: desde hablarte con voces hiperrealistas y autenticarte por biometría dual, hasta controlar toda la domótica de tu casa (Cámaras, Android TV, Aire Acondicionado) mediante su increíble arquitectura de plugins.\n\n## ✨ Características Principales\n\n- ⚡ **Súper Procesamiento de Voz:** Usa Vosk para velocidad offline relámpago y Whisper como alternativa.\n- 🗣️ **Voces Naturales Infinitas (TTS):** Integración local mediante Piper (sin red) o conexión premium a ElevenLabs.\n- 🔐 **Biometría Dual:** Primer sistema en Linux en cruzar huellas digitales de hardware con el reconocimiento irrefutable de la firma de tu voz (_Voice ID_ vía Resemblyzer).\n- 🧠 **Cerebro Dinámico (LLM):** Soporte nativo para GPT/Mistral u otros modelos. Si la consulta supera sus acciones locales, su IA piensa la respuesta.\n- 📺 **Domótica Extrema (IoT):** Fina controla tu Smart TV, decodificadores, aires acondicionados y sistemas de videovigilancia Tuya/SmartLife sin pestañear.\n- 🔌 **Arquitectura 100% Modular:** Instala solo el motor base. Luego elige qué dependencias de IoT quieres integrar: tu computadora no colapsará instalando librerías que no usa.\n\n## ⚙️ Arquitectura Modular (Fina Plugins)\n\nFina está dividida en un núcleo de IA liviano y una potente de capa externa comunitaria.\n\n| Categoría   | Plugins Incorporados                      | Funciones Destacadas                                   |\n| :---------- | :---------------------------------------- | :----------------------------------------------------- |\n| **TV**      | `Android TV Remote`, `Chromecast`, `TCL`  | Mute, cambiar canales de decodificadores, HDMI y YouTube. |\n| **Clima**   | `Midea`, `Surrey`                         | Ajuste por voz de los grados, modo ventilación y calor.|\n| **Timbre**  | `Tuya Doorbell Sniper`                    | Integración con Waydroid para atender a las visitas por Fina. |\n| **Sistema** | `App Management`, `Brightnes`, `Xdotool`  | Minimizar, cerrar y suspender herramientas de escritorio linux. |\n| **Terceros**| `plugins/custom/`                         | Descarga automatizaciones de la comunidad sin editar el repo. |\n\n## 🚀 Instalación (Universal)\n\nA partir de la versión v3.5.4, Fina Ergen es 100% modular y autodependiente. Ya no necesitas clonar el código fuente. Dirígete a la pestaña de **Releases** en GitHub y descarga el instalador que mejor se adapte a tu distribución Linux:\n\n### 1. Instaladores Nativos (Ubuntu / Debian / Fedora)\nSon la vía más integrada. Descarga el paquete e instálalo con tu gestor habitual:\n- **Para Ubuntu/Debian/Mint:** Descarga el archivo `.deb` e instálalo con `sudo dpkg -i fina-ergen_..._amd64.deb`\n- **Para Fedora/RHEL:** Descarga el archivo `.rpm` e instálalo con `sudo rpm -i fina-ergen_..._x86_64.rpm`\n\n### 2. Formato Portable (AppImage)\nSi prefieres no instalar nada a nivel sistema, descarga una de nuestras versiones AppImage. Solo dale permisos de ejecución (`chmod +x archivo.AppImage`) y lánzalo.\n* **fina-ergen_..._amd64.AppImage (Recomendado):** Comprimida en formato XZ (pesa solo unos ~25MB). Contiene parches para mostrar correctamente los íconos del sistema en Ubuntu 24.04 y superior.\n* **fina-ergen_..._x86_64.AppImage:** Versión AppImage genérica cruda producida por el compilador para compatibilidad heredada.\n\n---\n\n## 🧩 Plugins y Extensiones (Market)\n\nFina viene \"pelada\" de fábrica para ser rapidísima. Todo el control de aparatos IoT, TV y automatizaciones de terceros se descarga por separado mediante un Market. Tienes dos maneras de hacerlo:\n\n### Vía Interfaz (Recomendada)\n1. Abre Fina Ergen y dirígete al botón **Market de Plugins** (actualmente visible en la sección *Agenda*).\n2. Explora el repertorio, haz clic en **Instalar** al plugin que desees y Fina se encargará de descargarlo, inyectarlo en tu perfil de usuario y encenderlo automáticamente.\n\n### Vía Manual\n1. Visita nuestro Repositorio Oficial de Extensiones en la web: **[Fina Plugins Market](https://github.com/dankopetro/Fina-Plugins-Market)**\n2. Descarga la carpeta de la extensión que te interese (ej: `AirConditioning/Midea-Surrey`).\n3. Cópiala en la carpeta de configuraciones de tu usuario de Linux:\n   `~/.config/Fina/plugins/` *(Ej: `~/.config/Fina/plugins/AirConditioning/Midea-Surrey/`)*\n4. Reinicia Fina Ergen para cargarla.\n## 📚 Documentación\n\nHemos reestructurado toda la información técnica para ti:\n\n- 📖 [Manual del Usuario Completo](./docs/MANUAL_DE_USUARIO_COMPLETO.md) (Guía Definitiva)\n- 🧩 [Guía de Creación de Plugins](./docs/PLUGINS_GUIDE.md)\n- 🚀 [Roadmap de Desarrollo](./docs/ROADMAP.md)\n\n## 💖 Apoya el Proyecto\n\nSi Fina Ergen te ha sido útil y quieres apoyar su continuo desarrollo, puedes invitarme un café o realizar una donación. ¡Toda ayuda es bienvenida para seguir mejorando el \"hierro inteligente\"!\n\n| Plataforma | Link |\n| :--- | :--- |\n| **☕ Buy Me a Coffee** | [![Buy Me A Coffee](https://img.shields.io/badge/Buy_Me_A_Coffee-FFDD00?style=for-the-badge\u0026logo=buy-me-a-coffee\u0026logoColor=black)](https://www.buymeacoffee.com/dankopetro) |\n| **🅿️ PayPal** | [![PayPal](https://img.shields.io/badge/PayPal-00457C?style=for-the-badge\u0026logo=paypal\u0026logoColor=white)](https://paypal.me/dankopetro) |\n| **₿ Bitcoin** | `bc1qa75vqz7q7kac0mdf8tzsd4gxpnljh5cukvt2ll` |\n\n---\n\n## 🏆 Agradecimientos\nEl desarrollo de Fina comenzó como un _fork_ espiritual fuertemente inspirado en el código fuente del proyecto open-source [**Jarvis Voice Assistant**](https://github.com/KhagendraN/Jarvis-Voice-Assistant) creado por [@KhagendraN](https://github.com/KhagendraN) bajo licencia MIT. A partir de esos divertidos scripts iniciales de automatización, Fina evolucionó con los años hacia esta inmensa arquitectura modular. Fina no existiría hoy con esta arquitectura de no ser por esos primeros cimientos.\n\n---\n\u003cp align=\"center\"\u003e\n  \u003cb\u003eHecho con ❤️ en Argentina. Licencia MIT.\u003c/b\u003e \u003cbr\u003e\n  \u003ci\u003e\"El hierro inteligente.\"\u003c/i\u003e\n\u003c/p\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdankopetro%2Ffina-ergen","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdankopetro%2Ffina-ergen","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdankopetro%2Ffina-ergen/lists"}