PICOTTY
PICOTTY es una consola serial gestionada por red para máquinas headless. Utiliza Raspberry Pi Pico como nodos que leen la salida serial y emulan teclado USB, coordinados por un hub central (Pi Zero 2 W) con dashboard web.
Ficha actualizada 18 sept 2026, 21:36 · upstream 6 sept 2026, 11:40 · release v1.2.0
Qué es PICOTTY
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
PICOTTY actúa como consola serial en estrella para una flota de máquinas sin monitor. Cada nodo, basado en Raspberry Pi Pico, se conecta al puerto USB del objetivo, leyendo la consola serial y actuando como teclado HID para inyectar comandos en BIOS, GRUB o el sistema operativo.
El hub central (Pi Zero 2 W) coordina el swarm mediante un dashboard web único que muestra el estado de cada nodo, permite escribir en las consolas, gestionar macros y ejecutar runbooks YAML. El historial se almacena en SQLite para auditoría y recuperación.
Soporta actualizaciones OTA seguras con watchdog-revert, alertas vía Telegram y failover dual-hub. La arquitectura es ligera, sin Docker ni Compose, usando scripts bash y CircuitPython para los nodos.
- Recuperación de sistemas headless congelados o en kernel panic
- Acceso a BIOS/GRUB mediante inyección de teclado remota
- Automatización de tareas repetitivas con macros o runbooks YAML
- Despliegue y actualización de firmware OTA en flotas de nodos
- Monitoreo de consolas serial remotas para diagnóstico de arranque
- Dashboard web unificado para gestión de flota de nodos
- Inyección HID funcional en BIOS, GRUB e initramfs
- Historial persistente de eventos y comandos en SQLite
- Mecanismo de failover dual-hub para alta disponibilidad
- Motor expect integrado para wait-for-output automatizado
- Actualizaciones OTA chunked con verificación de checksums
- Requiere puerto serial habilitado en el objetivo (no es KVM real)
- Dependencia de hardware específico (Raspberry Pi Pico/Pico 2)
- Latencia de red afecta la experiencia interactiva de consola
- Configuración manual del firmware y scripts en los nodos
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 hub con `uv tool install picotty` en Pi Zero 2 W. Compilar firmware para Pico usando scripts bash (`firmware/scripts/build.sh`). Conectar nodo USB al objetivo y configurar serial UART. Ejecutar scripts de instalación del objetivo (ej. proxmox-serial.sh). Verificar token y conexión WebSocket en dashboard.
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.