Open Ghosty Docker

El agente minimalista para WhatsApp. Corre Gemma 4 localmente con Docker y responde en tus grupos de WhatsApp. Sin APIs de pago. Sin servidores. Todo local.

Este repo es material del taller de Fixtergeek. Aprende a construir agentes AI con WhatsApp usando herramientas 100% gratuitas.

Stack

WhatsApp grupo
  ↕ Baileys (WebSocket)
bridge.ts
  ↕ HTTP SSE
docker agent serve api
  ↕ Docker Model Runner
Gemma 4 (local)

Requisitos

• Docker Desktop 4.63+ con Model Runner habilitado
• Docker Agent CLI (brew install docker-agent o incluido en Docker Desktop)
• Node.js 20+
• Mac con Apple Silicon (8GB+ RAM) o PC con NVIDIA GPU

Setup

# 1. Bajar Gemma 4
docker model pull ai/gemma4

# 2. Instalar dependencias
npm install

# 3. Configurar
cp .env.example .env
# Edita .env con tu número de WhatsApp

# 4. Correr
npm start

La primera vez aparece un pairing code en consola. Ingrésalo en WhatsApp > Dispositivos vinculados > Vincular con número de teléfono.

Uso

Admin (self-chat)

Escríbete a ti mismo en WhatsApp. El agente responde a todo sin trigger. Desde ahí puedes gestionar grupos en lenguaje natural:

• "enlista los grupos"
• "activa el grupo Amigos con trigger @bot"
• "desactiva el grupo Trabajo"

Grupos

Los grupos se descubren automáticamente al conectar. Solo responde en grupos activados cuando alguien usa el trigger configurado.

Gestión de grupos (CLI)

node group-admin.js list
node group-admin.js activate "Amigos" "gemma"
node group-admin.js deactivate "Amigos"
node group-admin.js trigger "Amigos" "@bot"

Estructura

├── agent.yaml          # Configuración del agente (instrucciones, tools, modelo)
├── bridge.ts           # Bridge WhatsApp ↔ Docker Agent API
├── group-admin.js      # CLI para gestionar grupos
├── SYSTEM.md           # Personalidad base del agente
├── groups.json         # Grupos descubiertos/activados (auto-generado)
├── sessions.json       # Sessions activas (auto-generado)
└── groups/             # Folder por grupo
    └── <nombre>/
        └── SYSTEM.md   # Personalidad custom del grupo

Personalización

Edita SYSTEM.md para cambiar la personalidad global. Crea groups/<nombre>/SYSTEM.md para personalizar un grupo específico.

Roadmap

• Respuestas 1-to-1 (contactos autorizados, con delay anti-ban)
• Sandboxes por grupo con MCPs distintos
• Media (imágenes, audio, video)
• Multi-modelo (asignar modelo por grupo)
• Migración a Meta Cloud API (WhatsApp Business oficial) para producción

Parte del ecosistema Ghosty

Open Ghosty Docker es la versión open-source y local de Ghosty, la plataforma de agentes WhatsApp. Mientras Ghosty corre en la nube con Claude, Open Ghosty corre en tu máquina con modelos open-source gratuitos.

Construido por Fixtergeek y potenciado por Formmy.

Licencia

MIT