paraphe
Caja de entrada para decisiones de agentes autónomos. Permite a los humanos aprobar o rechazar acciones antes de que el agente proceda, usando Telegram o consola. Autoalojado, SQLite, sin dependencias externas (Python stdlib), compatible con MCP.
Ficha actualizada 24 sept 2026, 19:41 · upstream 24 sept 2026, 19:35 · release v0.1.2
Qué es paraphe
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Paraphe es una herramienta diseñada específicamente como "caja de entrada para decisiones del propietario" para agentes autónomos. Su función principal es detener la ejecución de un agente cuando este requiere aprobación humana antes de actuar, almacenando la solicitud en una tarjeta de decisión hasta que el usuario responde.
La arquitectura se basa en Python 3.11 o superior y utiliza SQLite como base de datos local. No depende de librerías externas, lo que facilita su despliegue en entornos aislados. Soporta integración con Telegram para notificaciones móviles y protocolo MCP (Model Context Protocol) para la comunicación entre agentes y el servidor.
El sistema garantiza seguridad mediante credenciales separadas: el agente posee un token para crear y leer tarjetas, mientras que el usuario final utiliza un token distinto para responder. Esto evita que el agente pueda aprobar sus propias solicitudes sin intervención humana directa.
- Aprobación de acciones críticas en agentes de automatización (ej. borrar archivos, transferir fondos).
- Notificación móvil de decisiones pendientes vía Telegram BotFather.
- Gestión local de flujos de trabajo que requieren supervisión humana antes del siguiente paso.
- Integración con herramientas MCP para conectar agentes locales con humanos en la misma red.
- Auditoría de decisiones automatizadas mediante revisión de tarjetas en consola o teléfono.
- Cero dependencias externas, solo Python estándar y SQLite.
- Soporte nativo para protocolo MCP (Model Context Protocol).
- Integración directa con Telegram para notificaciones push a móviles.
- Licencia AGPL-3.0, garantizando código abierto y modificable.
- Arquitectura de credenciales separadas (agente vs propietario) para seguridad.
- Requiere Python 3.11 o superior instalado en el sistema.
- No incluye Docker Compose, solo Dockerfile manual.
- La base de datos SQLite es local y no soporta replicación nativa.
- Configuración manual del archivo paraphe.toml necesaria para cada despliegue.
- El puerto 8787 está restringido a loopback por defecto sin configuración adicional.
Capturas del proyecto
Imágenes reales detectadas en la documentación del repositorio.
Perfil de infraestructura
Estimación inicial derivada del repositorio y de los servicios detectados.
Despliegue detectado
Qué señales reales de instalación hemos encontrado.
Instalar vía pip o construir imagen Docker. Configurar `paraphe.toml` con tokens MCP y Telegram. Para producción, exponer puerto 8787 en 0.0.0.0 si se usa Telegram. Montar carpeta de datos para persistencia SQLite. Verificar credenciales antes de iniciar servidor.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Puede sustituir a
Relaciones detectadas por el análisis del repositorio y su categoría.
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.