Ctrl K
ComunidadGuías…
GITHUB · ANALIZADO

herwanto-os

herwanto-os es un stack auto-alojable de asistente personal IA para Telegram e interfaz PWA. Integra gestión de agenda, documentos y flujos de trabajo mediante la personalidad H.I.R.A., con soporte nativo para Google Workspace.

Ficha actualizada 24 sept 2026, 13:37 · upstream 24 sept 2026, 13:34 · release sin release detectada

Ver códigoProblemas y ayudaRepositorio ↗
00

Qué es herwanto-os

Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.

herwanto-os es una pila de software auto-alojable diseñada como asistente personal inteligente en Telegram, gestionando agenda, memoria y documentos mediante la personalidad H.I.R.A. Utiliza Next.js para el frontend PWA y FastAPI/Python para el backend, integrándose profundamente con Google Calendar, Sheets y Drive.

El sistema permite crear recordatorios proactivos, generar documentos DOCX o PPTX desde prompts naturales, analizar PDFs y gestionar correos electrónicos a través de Gmail. La arquitectura migra datos a PostgreSQL y usa Redis para caché, ofreciendo una solución robusta bajo licencia MIT.

Requiere configuración manual de variables de entorno para claves de API de OpenAI y cuentas de servicio de Google Cloud. Incluye scripts para migración de memoria y verificación de salud local antes del despliegue en producción.

CASOS DE USO
  • Gestión de agenda personal con recordatorios automáticos en Telegram
  • Generación y edición de documentos DOCX, PPTX y Google Docs desde prompts
  • Análisis de archivos PDF y extracción de datos para tareas académicas o laborales
  • Seguimiento de proyectos y seguimiento de tareas pendientes mediante comandos específicos
PUNTOS DESTACADOS
  • Integración nativa con APIs de Google Workspace (Calendar, Sheets, Drive)
  • Generación de documentos editables en formato DOCX y PPTX directamente en Telegram
  • Interfaz PWA privada auto-alojada para acceso web sin app móvil
  • Personalidad IA persistente (H.I.R.A.) que recuerda contexto y preferencias
PRECAUCIONES
  • Configuración inicial compleja requiriendo creación de cuenta de servicio en Google Cloud
  • No incluye Dockerfile nativo, necesitando despliegue manual o contenedores externos
  • Dependencia crítica de claves API externas (OpenAI, Google) almacenadas en variables de entorno
  • Requiere envío de /start al bot para habilitar notificaciones programadas
01

Perfil de infraestructura

Estimación inicial derivada del repositorio y de los servicios detectados.

CPU2 vCPUrecomendación inicial
MEMORIA2 GBRAM estimada
DISCO30 GBalmacenamiento base
COMPLEJIDADmediumnivel de operación
02

Despliegue detectado

Qué señales reales de instalación hemos encontrado.

Despliegue manual

Desplegar en Railway o similar. Configurar env vars: TELEGRAM_BOT_TOKEN, OPENAI_API_KEY, GOOGLE_SERVICE_ACCOUNT_JSON y DATABASE_URL. Ejecutar migración inicial a PostgreSQL si se usa la base de datos heredada. Añadir Postgres al proyecto Railway. Enviar /start al bot tras el despliegue para registrar el chat ID.

—Dockerfile
—Compose
—One-click
03

Stack y dependencias

Componentes inferidos a partir de manifests, configuración y documentación.

FRAMEWORKS
Next.jsReactFastAPIPython
SERVICIOS
PostgreSQLRedis
BASES DE DATOS
PostgreSQLRedis
PUERTOS
41738000
05

Puede sustituir a

Relaciones detectadas por el análisis del repositorio y su categoría.

06

Experiencia real de la comunidad

Ayuda a contrastar la estimación automática con instalaciones reales.

Todavía no hay datos comunitarios para este proyecto.