LobsterAI: Asistente de IA de código abierto construido con Electron
LobsterAI: Un asistente personal de IA gratuito, todo en uno
LobsterAI (GitHub: netease-youdao/LobsterAI) es un proyecto de código abierto que convierte tu escritorio en un centro de inteligencia 24/7. Construido con Electron, React, TypeScript y el Claude Agent SDK de Anthropic, puede:
- Generar documentos – Word, PowerPoint, Excel, PDF y video.
- Buscar en la web y obtener datos en tiempo real.
- Automatizar navegadores con Playwright.
- Ejecutar tareas localmente o dentro de un sandbox seguro de Alpine Linux.
- Programar flujos de trabajo recurrentes mediante sintaxis cron.
- Disparar tareas remotamente desde tu teléfono a través de Telegram, Discord, DingTalk, Feishu o NetEase IM.
A continuación, una guía completa de la arquitectura de LobsterAI, cómo instalarlo, crear instaladores y ampliar sus capacidades.
1. Visión general
El corazón de LobsterAI es un sistema Cowork, un gestor de sesiones ligero que orquesta conversaciones impulsadas por Claude, invocaciones de herramientas y manipulación de archivos.
Componentes arquitectónicos clave:
| Capa | Tecnología | Notas |
|---|---|---|
| Frontend | React 18 + Redux Toolkit + Tailwind CSS | UI, ajustes de usuario, flujo de mensajes |
| Backend | Electron (Node ≥ 24) | IPC, persistencia SQLite, cargador de habilidades |
| Motor de IA | Claude Agent SDK | Gestiona peticiones de lenguaje natural |
| Ejecución | Node local o VM Alpine | Sandbox para seguridad |
| Puertas de IM | Telegram, Discord, DingTalk, Feishu, NetEase IM | Canal de comandos remoto |
¿Por qué Electron?
Electron nos ofrece un entorno de escritorio determinista. Combina la velocidad de Node.js para I/O pesado (correo, base de datos) con Chromium para una UI pulida. El aislamiento de contexto, los sandbox y el IPC tipado mantienen el sistema seguro.
2. Empezando
Requisitos previos
# Node 24 o cualquier LTS de 2025 va bien.
nvm install 24
# npm >= 10
npm --version
Clonar e instalar
git clone https://github.com/netease-youdao/LobsterAI.git
cd LobsterAI
npm install
Ejecutar en modo de desarrollo
npm run electron:dev
La aplicación se abrirá en http://localhost:5175 y lanzará una ventana de Chromium. Puedes editar componentes de React y ver recargas en caliente.
3. Construcción para producción
El repositorio utiliza electron‑builder. Los objetivos de compilación para macOS, Windows y Linux están definidos en electron-builder.json.
# TypeScript → bundle
npm run build
# Revisión de estilo
npm run lint
# Construir
npm run dist
Los instaladores se ubican en la carpeta release/:
| Plataforma | Archivo | Cómo instalar |
|---|---|---|
| macOS (Intel) | LobsterAI-0.1.21-darwin-x64.dmg |
Haz doble clic y arrastra a Aplicaciones |
| macOS (Apple‑Silicon) | ...-arm64.dmg |
Igual que arriba |
| Windows (.exe) | ...-win32-x64.exe |
Ejecuta y sigue el asistente |
| Linux (.AppImage) | ...-linux-x86_64.AppImage |
chmod +x y luego ejecuta |
4. Extender LobsterAI – Añadir una habilidad
Cada habilidad es un módulo ligero que expone un esquema skill.json y un manejador ejecutable.
- Crea una nueva carpeta bajo
SKILLs/(p.ej.,markdown/). - Añade
skill.jsoncon nombre, descripción y puntos de entrada. - Coloca un script de Node o binario compilado para la habilidad.
- Actívala en
skills.config.json. - Reinicia la aplicación.
El repositorio incluye 16 habilidades incorporadas: web-search, pptx, remotion, playwright, imap-smtp-email, etc. Siéntete libre de clonar una y ajustarla a tus necesidades.
5. Control remoto vía IM
LobsterAI escucha en cuatro plataformas de IM. Cada integración requiere un token/código secreto que configuras en Configuración → Puertas de IM.
Una vez que el token esté presente, la aplicación expone un bot que acepta un comando de lenguaje natural sencillo. Por ejemplo:
Hey Lobster, generate a weekly summary PPT from the last 10 emails.
El bot se autentica, autoriza y luego lanza una sesión Cowork, enviando el resultado de vuelta a tu teléfono.
6. Puntos destacados de seguridad
| Característica | Descripción |
|---|---|
| Aislamiento de contexto | No hay APIs de Node en el renderizador |
| Ejecución en sandbox | VM Alpine opcional para código inseguro |
| Control de permisos | El usuario debe aprobar acciones de archivos o web |
| SQLite sólo en disco | No hay base de datos externa |
7. Contribuir
- Fork → clonar.
- Crear una rama temática (
git checkout -b feat/new‑skill). - Commit con mensaje convencional (
feat: add markdown skill). - Push y abre un PR.
Apreciamos documentación, nuevos templates de habilidades y correcciones de errores. Asegúrate de ejecutar npm run lint antes de enviar.
8. Escenarios de uso
| Escenario | Cómo ayuda LobsterAI |
|---|---|
| Análisis de datos | Importar un archivo Excel → pedir a la IA que genere insights y un diagrama PPT |
| Clasificación de correo | Clasificar automáticamente la bandeja de entrada, resumir hilos importantes |
| Marketing en video | Pasar un guion → generar un video Remotion en segundos |
| Resúmenes de noticias diarias | Programar tarea recurrente que raspe sitios de tecnología y te envíe un resumen por correo |
| Trabajo remoto | Control desde el teléfono con un comando rápido en Telegram |
9. Conclusión
LobsterAI demuestra que se puede construir un asistente personal de IA completamente funcional con herramientas de código abierto. Desde la manipulación local de archivos hasta la programación remota, cubre el espectro de tareas cotidianas de productividad. Con una arquitectura robusta, ejecución sandbox y controles IM móviles‑amigables, está listo tanto para experimentación aficionada como para despliegue a escala empresarial.
¡Pruébalo, forkea el repositorio y comienza a crear tus propios flujos de IA hoy mismo!