Asistente de productividad con frontend web y backend Flask para gestionar rutina diaria, pendientes, proyectos, voz y respuestas con IA.

Stack

• Python + Flask
• Frontend HTML/CSS/JavaScript
• Google Cloud Speech-to-Text V2 (chirp_3)
• Gemini y/u Ollama como proveedores de IA
• pydub + ffmpeg para normalización de audio

Funcionalidades

• Gestión de rutina diaria con avisos de transición
• Tablero de pendientes por categorías
• Gestión de proyectos con archivos e imagen
• Grabación por voz y transcripción a texto
• Respuestas del asistente con validación de comandos
• Timeout de inactividad configurable

Estructura

.
├── index.html
├── server.py
├── static/
│   ├── app.js
│   └── favicon/
├── .env.example
├── requirements.txt
└── README.md

Configuración

Toda la configuración sensible y operativa se carga desde .env.

1. Crear entorno virtual.
2. Instalar dependencias.
3. Copiar .env.example a .env.
4. Completar claves y rutas locales.

python -m venv .venv
.venv\Scripts\activate
pip install -r requirements.txt
copy .env.example .env

Variables principales

APP_NAME=Andromadus
APP_HOST=0.0.0.0
APP_PORT=5000
USE_GEMINI=true
GEMINI_API_KEY=...
GOOGLE_CLOUD_PROJECT=...
GOOGLE_SPEECH_API_KEY=...
DEFAULT_USER_LOCALE=es-MX
DEFAULT_PENDING_CATEGORIES=personal,casa,trabajo
FRONTEND_INACTIVITY_HOME_TIMEOUT_MS=120000
FFMPEG_PATH=C:\ffmpeg\bin\ffmpeg.exe
FFPROBE_PATH=C:\ffmpeg\bin\ffprobe.exe

Ejecutar

python server.py

Abrir en el navegador:

http://localhost:5000

Requisitos del sistema

• Python 3.10+
• ffmpeg instalado y accesible por ruta
• Credenciales válidas para Gemini y/o Google Cloud Speech
• Si usas Ollama, una instancia local activa en la URL configurada

Endpoints principales

• GET /
• GET /api/config
• GET /api/config.js
• POST /api/assistant
• POST /api/speech-to-text
• GET|POST /api/pendientes
• GET|POST /api/proyectos
• GET|POST /api/rutina

Publicación en GitHub

• .env está ignorado en .gitignore
• .env.example sirve como plantilla pública
• uploads/ y db.json también se ignoran para no subir datos locales

Notas

• El frontend consume configuración pública desde GET /api/config.js.
• El backend carga automáticamente .env con python-dotenv.
• El proyecto está preparado para publicarse sin dejar claves embebidas en el código.