Privacidad Absoluta, Sin Nube
El Secretario es un entorno inteligente de escritorio (PyQt) diseñado para capturar, estructurar e interactuar con tus grabaciones de voz de forma 100% local. Está pensado para investigadores, ingenieros, creadores y profesionales que gestionan reuniones de alta confidencialidad, clases o reflexiones personales. Al ejecutarse íntegramente local, tu voz y tus transcripciones nunca se envían a servidores de terceros, garantizando una privacidad impenetrable.
A diferencia de las alternativas tradicionales en la nube, procesa cada segundo de audio de forma nativa en tu propio hardware, eliminando cualquier transmisión de datos hacia el exterior y permitiéndote trabajar de forma autónoma y sin conexión a internet.
Absolute Privacy, No Cloud
El Secretario is an intelligent desktop environment (PyQt) designed to capture, structure, and interact with your voice recordings 100% locally. Built for researchers, engineers, creators, and professionals handling highly confidential meetings, lectures, or personal thoughts. By running entirely on-device, your voice and transcripts are never transmitted to third-party servers, guaranteeing absolute, uncompromised privacy.
Unlike traditional cloud alternatives, it processes every second of audio natively on your own hardware, eliminating any external data transmission and allowing you to work autonomously and fully offline.
Confidentialité Absolue, Sans Nuage
El Secretario est un environnement de bureau intelligent (PyQt) conçu pour capturer, structurer et interagir avec vos enregistrements vocaux de manière 100% locale. Développé pour les chercheurs, les ingénieurs, les créateurs et les professionnels qui gèrent des réunions confidentielles, des cours ou des réflexions personnelles. En s'exécutant intégralement sur votre machine, votre voix et vos transcriptions ne sont jamais envoyées à des serveurs tiers, garantissant une confidentialité absolue.
Contrairement aux alternatives traditionnelles basées sur le cloud, il traite chaque seconde d'audio de manière native sur votre propre matériel, éliminant toute transmission de données vers l'extérieur et vous permettant de travailler de manière autonome et complètement hors ligne.
Características Clave
Key Features
Caractéristiques Clés
- [ Transcripción Multilingüe de Alta Fidelidad ] Inferencia local ultrarrápida impulsada por modelos Whisper a través de backends optimizados como `faster-whisper`, `openai-whisper` y `sherpa-onnx`, totalmente compatibles con aceleración por hardware (CPU o GPU).
- [ Diarización de Hablantes Local ] Clasificación automática de participantes mediante redes neuronales `pyannote.audio` en local, permitiendo asignar nombres personalizados y agrupar las voces con total precisión a lo largo de toda la grabación.
- [ Asistente Conversacional Inteligente (RAG) ] Motor de búsqueda semántica basado en una base de datos vectorial ChromaDB integrada. Permite chatear de forma interactiva con grabaciones sueltas, libretas, fechas del calendario o colecciones completas utilizando modelos de lenguaje locales en Ollama (como Llama 3 o Mistral) o mediante la API de Google Gemini.
- [ Espacio de Trabajo Multitarea y Modular ] Ventanas de chat ultra-flexibles que puedes mantener como pestañas, mover a una barra de herramientas flotante o colapsar en fichas minimalistas de rápido acceso. Cuenta con una barra lateral de contexto inteligente que se sincroniza automáticamente con el chat activo.
- [ Edición de Audio No Destructiva ] Recorte preciso de segmentos de audio mediante marcas de tiempo. Crea automáticamente copias de seguridad con extensión `.orig` y vuelve a transcribir únicamente el fragmento editado de forma transparente sin alterar tu archivo fuente.
- [ Gestión Jerárquica y Vista de Calendario ] Organización avanzada mediante Libretas, etiquetas y Colecciones dinámicas, complementada con un selector de fecha interactivo para auditar y navegar por tus grabaciones temporalmente de forma fluida.
- [ Cola de Resúmenes y Tablero de Tareas ] Generación asíncrona de minutas, resúmenes diarios o semanales gestionados por una cola en segundo plano, junto con un extractor inteligente de compromisos que pobla automáticamente un Tablero Kanban interactivo integrado.
- [ High-Fidelity Multilingual Transcription ] Ultra-fast local inference powered by Whisper models using highly optimized backends like `faster-whisper`, `openai-whisper`, and `sherpa-onnx`, with full support for hardware acceleration (CPU or GPU).
- [ On-Device Speaker Diarization ] Automatic speaker identification and grouping powered by local neural networks from `pyannote.audio`, allowing precise participant labeling and custom names.
- [ Intelligent RAG Conversational Assistant ] Semantic search engine built on an embedded ChromaDB vector store. Chat interactively with individual recordings, notebooks, calendar dates, or dynamic collections using local LLMs through Ollama (such as Llama 3 or Mistral) or Google Gemini via API key.
- [ Multitasking and Modular Workspace ] Ultra-flexible chat windows that can live as normal tabs, detach into floating bars, or minimize into compact floating chips. Includes a smart context sidebar that synchronously mirrors active chat sessions.
- [ Non-Destructive Audio Editor ] Precise waveform trimming using time markers. It automatically preserves an `.orig` backup of your raw audio and transparently retranscribes only the edited segment.
- [ Hierarchical Management & Calendar View ] Advanced organization through Notebooks, custom tags, and dynamic Collections, paired with an interactive calendar selector for rapid temporal navigation.
- [ Summary Queue & Task Board ] Asynchronous generation of meeting minutes, daily summaries, and weekly recaps scheduled via background workers, combined with a smart commitment analyzer that automatically populates an interactive, built-in Kanban Task Board.
- [ Transcription Multilingue Haute Fidélité ] Inférence locale ultrarapide propulsée par les modèles Whisper via des moteurs optimisés comme `faster-whisper`, `openai-whisper` et `sherpa-onnx`, avec prise en charge complète de l'accélération matérielle (CPU ou GPU).
- [ Diarisation des Locuteurs Locale ] Identification et regroupement automatiques des intervenants grâce aux réseaux de neurones locaux de `pyannote.audio`, permettant un étiquetage précis et des noms personnalisés pour les participants.
- [ Assistant Conversationnel Intelligent (RAG) ] Moteur de recherche sémantique basé sur une base de données vectorielle intégrée ChromaDB. Discutez de manière interactive avec des enregistrements individuels, des carnets, des dates du calendrier ou des collections entières à l'aide de LLM locaux via Ollama (comme Llama 3 ou Mistral) ou l'API Google Gemini.
- [ Espace de Travail Multitâche et Modulaire ] Fenêtres de discussion ultra-flexibles qui peuvent rester sous forme d'onglets, se détacher en barres flottantes ou se réduire en puces flottantes compactes. Comprend une barre latérale intelligente qui se synchronise automatiquement avec le contexte actif.
- [ Édition Audio Non Destructive ] Découpe précise des clips audio à l'aide de marqueurs temporels. L'application conserve automatiquement une sauvegarde `.orig` de votre fichier brut et retranscrit uniquement le fragment édité de manière transparente.
- [ Gestion Hiérarchique et Vue Calendrier ] Organisation avancée via des Carnets de notes, des étiquettes et des Collections dynamiques, complétée par un calendrier interactif pour une navigation temporelle rapide et fluide.
- [ File d'Attente de Résumés et Tableau de Tâches ] Génération asynchrone de comptes-rendus de réunion, résumés quotidiens ou hebdomadaires gérés par une file d'attente en arrière-plan, couplée à un extracteur intelligent d'engagements qui alimente automatiquement un tableau Kanban interactif intégré.
Arquitectura y Robustez Técnica
Architecture & Technical Rigor
Architecture et Rigueur Technique
La aplicación está estructurada bajo una arquitectura desacoplada y robusta en PyQt. Aísla de forma segura los procesos de inferencia pesados (STT y Diarización) en subprocesos aislados del sistema operativo, garantizando que la interfaz gráfica permanezca fluida y libre de bloqueos en todo momento. Toda la persistencia es estrictamente local e independiente mediante múltiples bases de datos SQLite (notebooks.db, transcriptions.db) gestionadas mediante un sistema de migraciones automatizadas. Su desarrollo está guiado al 100% por especificaciones técnicas (SPEC-driven development), asegurando una correlación directa entre las historias de usuario, los contratos de comportamiento de cada módulo y su suite de tests automatizados.
The application is built upon a highly decoupled, service-oriented PyQt architecture. It securely isolates heavy machine learning workloads (STT inference and Speaker Diarization) into separate OS subprocesses, keeping the main GUI completely thread-safe, responsive, and lag-free. Local persistence is managed across modular SQLite database instances (notebooks.db, transcriptions.db) with an automated migration framework. El Secretario's development is 100% design-driven (SPEC-driven development), maintaining a strict mapping between user-facing capabilities, behavioral contracts, and their comprehensive automated test suites.
L'application s'appuie sur une architecture PyQt hautement découplée et robuste. Elle isole de manière sécurisée les charges de travail d'apprentissage automatique lourdes (inférence STT et Diarisation des locuteurs) dans des sous-processus système distincts, garantissant une interface graphique fluide, réactive et totalement exempte de blocages. La persistance locale est structurée autour de plusieurs bases de données SQLite indépendantes (notebooks.db, transcriptions.db) gérées par un système de migrations automatisées. Son développement est entièrement guidé par les spécifications techniques (SPEC-driven development), garantissant un alignement parfait entre les cas d'usage, les contrats de comportement des modules et leur suite de tests automatisés.
Instalación
Installation
Installation
# Clonar e iniciar git clone https://github.com/Hectronic/El-Secretario.git cd El-Secretario # Crear entorno e instalar dependencias python3 -m venv venv source venv/bin/activate pip install -r requirements.txt # Ejecutar la aplicación ./run.sh
# Clone and launch git clone https://github.com/Hectronic/El-Secretario.git cd El-Secretario # Create environment and install dependencies python3 -m venv venv source venv/bin/activate pip install -r requirements.txt # Run the application ./run.sh
# Cloner et lancer git clone https://github.com/Hectronic/El-Secretario.git cd El-Secretario # Créer un environnement et installer les dépendances python3 -m venv venv source venv/bin/activate pip install -r requirements.txt # Exécuter l'application ./run.sh