PinkCollab
PinkCollab es una aplicación Android para gestionar agentes Oh My Pi (OMP) en servidores locales, construida con Rust y Kotlin. Permite iniciar tareas remotas desde un teléfono, supervisando su ejecución y controlándolas mediante WebSocket.
Ficha actualizada 22 sept 2026, 15:06 · upstream 22 sept 2026, 14:34 · release sin release detectada
Qué es PinkCollab
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
PinkCollab es una herramienta de productividad que permite a usuarios gestionar agentes de IA (Oh My Pi) desde dispositivos Android sin exponer credenciales del modelo directamente al teléfono. El sistema consta de dos componentes principales: un Gateway escrito en Rust con Tokio y Axum, que se ejecuta en el servidor local, y una aplicación móvil desarrollada en Kotlin con Jetpack Compose. El Gateway actúa como proxy seguro, autenticando las solicitudes, validando los directorios de trabajo permitidos (sandbox) y gestionando la vida útil de las sesiones de OMP.
La arquitectura se basa en un patrón maestro-esclavo donde el Gateway lanza procesos OMP individuales para cada tarea, comunicándose mediante NDJSON a través de stdin/stdout. Esto asegura que una tarea fallida no afecte a otras. El flujo de trabajo implica que el usuario envía un prompt inicial desde la app, el Gateway lo procesa y mantiene una conexión WebSocket abierta para streaming de respuestas en tiempo real, permitiendo interrumpir o detener tareas dinámicamente.
La aplicación móvil utiliza Material 3 y soporta Android API 26+, ofreciendo una interfaz intuitiva para navegar por directorios de trabajo, crear nuevas instancias de agentes y monitorear su estado. El sistema está diseñado para funcionar con cualquier proveedor de modelos que soporte HTTPS, manteniendo la seguridad al no requerir que el teléfono se conecte directamente a los endpoints de las APIs de modelos.
- Gestión remota de agentes OMP desde un dispositivo móvil sin necesidad de estar físicamente en el ordenador.
- Supervisión en tiempo real del progreso de tareas de IA mediante streaming de respuestas y actividad de herramientas.
- Control granular sobre sesiones activas, permitiendo interrumpir procesos o detenerlos completamente mediante comandos específicos.
- Aislamiento seguro de proyectos mediante la definición de directorios de trabajo permitidos en el Gateway para evitar accesos no autorizados al sistema de archivos.
- Arquitectura modular con separación clara entre lógica del servidor (Rust) y cliente móvil (Kotlin).
- Implementación de sandboxing mediante validación estricta de directorios de trabajo permitidos en la configuración.
- Gestión eficiente de recursos con límites configurables de sesiones concurrentes y liberación automática al finalizar tareas.
- Protocolo WebSocket para comunicación bidireccional en tiempo real entre el cliente y el servidor.
- No incluye funcionalidades avanzadas como terminal embebido, cliente Git o editor de código integrado.
- Gestión de sesiones limitada: no permite adjuntar a procesos iniciados manualmente fuera del sistema ni restaurar procesos salidos tras un reinicio.
- Dependencia de instalación manual de Rust y JDK para construir el entorno local.
- Notificaciones de fondo en Android aún no implementadas, requiriendo que la app esté activa para recibir inputs pendientes.
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.
Requiere configuración inicial con `init` especificando directorios de trabajo permitidos. El Gateway debe ejecutarse en modo loopback (127.0.0.1) y exponerse mediante un proxy HTTPS o Tailscale Funnel para acceso remoto seguro. Se recomienda usar `status` antes de iniciar para validar la configuración. La aplicación Android debe compilarse con Gradle e instalarse vía ADB o APK directo.
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.