astralbeam
AstralBeam es un widget de chat agéntico tipo Cursor para integrar en aplicaciones web. Proporciona una interfaz sidebar que permite a los usuarios interactuar con IA, ejecutar herramientas del negocio y renderizar componentes personalizados dentro de las respuestas.
Ficha actualizada 24 sept 2026, 17:39 · upstream 24 sept 2026, 17:30 · release v0.12.2
Qué es astralbeam
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
AstralBeam es una plataforma de agentes de chat diseñada para integrarse en aplicaciones existentes mediante un SDK frontend ligero. El widget se comporta como una barra lateral estilo Cursor que permite a los usuarios realizar tareas complejas directamente desde la interfaz de tu producto.
La arquitectura consta de cinco proyectos independientes: webapp (aplicación principal con TanStack Start), www (sitio web público prerenderizado), sdk (SDK frontend publicado en npm), cli (CLI para administración organizacional) y examples (demostraciones del SDK). El backend utiliza PostgreSQL como base de datos, Valkey para caché y Mailpit para pruebas de correo.
El sistema soporta integración con proveedores de LLM existentes, permite definir herramientas personalizadas que ejecutan lógica en tu propio estado, renderiza widgets interactivos dentro de las respuestas del agente, y ofrece aislamiento por tenant con límites de tasa granulares. La plataforma funciona tanto en auto-alojamiento como en su servicio cloud.
- Integrar un asistente agéntico tipo Cursor en aplicaciones web existentes sin reescribir el backend
- Permitir a usuarios finales ejecutar acciones del negocio (ej: reembolsos, consultas de pedidos) directamente desde el chat
- Renderizar componentes React personalizados dentro de las respuestas del agente para mostrar datos dinámicos
- Exponer herramientas MCP para que usuarios accedan a tu app desde Claude o ChatGPT en el futuro
- SDK frontend ligero publicado en npm con licencia MIT, independiente del backend
- Soporte nativo para widgets personalizados que renderizan componentes React dentro de las respuestas
- Aislamiento multi-tenant con límites de tasa por cliente y seguimiento de uso granular
- Integración con proveedores de LLM existentes sin necesidad de migrar a su infraestructura
- Ejecución de herramientas contra el estado propio del negocio, no en sandbox aislado
- El streaming resumible está marcado como 'in progress' y no está disponible actualmente
- La exposición de herramientas MCP para LLM externos (Claude/ChatGPT) está en roadmap
- Requiere configuración manual de claves API de OpenAI en el entorno local (.env.local)
- El despliegue necesita PostgreSQL, Valkey y Mailpit gestionados vía Docker Compose o Podman
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.
Desplegar con docker compose up --detach --wait para iniciar PostgreSQL, PgBouncer, Valkey y Mailpit. Configurar OPENAI_API_KEY en webapp/.env.local antes de ejecutar deno task dev. La aplicación principal corre en localhost:4500, el sitio web en 4600 y los ejemplos en 4700/3000. El SDK se reconstruye automáticamente al cambiar fuentes. Para producción, gestionar claves API desde el dashboard organizacional.
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.