Documentación de Lizard
¿Qué es Lizard?
Lizard (lizard.build) es una plataforma de sandboxes en la nube para agentes de IA. Lizard Sandboxes son microVM de Firecracker, cada una con su propio kernel: en ellas un agente ejecuta código y comandos de shell, usa un escritorio y un navegador, abre URL HTTPS privadas para sus puertos y guarda archivos en Persistent Volumes. Crea sandboxes desde tu código con Lizard SDK para TypeScript o Python, o desde una terminal con Lizard CLI. Cuando el agente haya construido algo, despliégalo en la misma plataforma: lizard up sube la carpeta actual, lizard add -r owner/repo despliega un repositorio de GitHub, y Lizard compila la imagen en sus servidores y da a cada servicio web una dirección HTTPS en onlizard.com. La misma CLI añade Managed Postgres, Managed Redis y Managed Object Storage compatible con S3, y los conecta a tus servicios mediante referencias como ${{postgres.DATABASE_URL}}. Lizard no es LizardFS, el sistema de archivos distribuido, ni lizard, la herramienta de Python que mide la complejidad del código.
Elige una tarea
| Quiero… | Empieza aquí |
|---|---|
| Ejecutar código generado en un entorno separado | Guía rápida de Sandboxes |
| Ejecutar Claude Code dentro de un sandbox | Claude Code en un sandbox |
| Conservar archivos después de que termine un sandbox | Persistent Volumes |
| Desplegar mi primera app | Guía rápida de apps |
| Desplegar Next.js, React, Vue o una app de Python | Guías de frameworks |
| Desplegar desde Claude Code u otro agente de programación | Guía de agentes de programación |
| Desplegar una app que tiene un Dockerfile | Desplegar con un Dockerfile |
| Alojar un servidor MCP remoto | Guía de MCP remoto |
| Mantener un bot de Telegram o Discord en ejecución | Guía de Telegram o guía de Discord |
| Conectar una base de datos | Managed Postgres |
| Editar una página visualmente con Claude Code o ChatGPT | Lizard Studio |
Ejecuta código en un sandbox
Crea una clave de API y un proyecto en el panel, define LIZARD_API_KEY e instala Lizard SDK. Este código crea un sandbox, ejecuta un comando y elimina el sandbox:
npm install @lizard-build/sdkimport { Lizard } from '@lizard-build/sdk'
const lizard = new Lizard({ project: 'my-project' })
const sandbox = await lizard.create('interpreter', { size: 'small' })
try {
const run = await sandbox.process.exec("python -c 'print(2 ** 10)'")
console.log(run.stdout) // 1024
} finally {
await sandbox.kill()
}El tamaño Small (2 vCPU, 4 GB RAM) cuesta $0.0162 por hora, con facturación por segundo. Para Python, plantillas y tiempos de vida, consulta la guía rápida de Sandboxes y la descripción general de Sandboxes.
Despliega una app
Instala Lizard CLI. El instalador inicia tu sesión y te ofrece la prueba de Pro de 7 días: añades una tarjeta en Stripe Checkout y no se cobra nada durante la prueba. Luego despliega un repositorio al que tengas acceso:
curl -fsSL https://lizard.build/install.sh | bash # then signs you in and offers the trial
lizard add -r your-org/your-appEn Windows o con npm, consulta otras formas de instalación.
Lizard compila la imagen en sus servidores, así que esta ruta no necesita Docker local. lizardpack detecta los proyectos compatibles; los proyectos con necesidades de compilación especiales pueden usar comandos explícitos o un Dockerfile. Revisa los logs de compilación y verifica la URL de la aplicación después del despliegue.
Entiende tus recursos
Un workspace agrupa miembros y proyectos. Un project agrupa servicios, bases de datos y Sandboxes; cada cuenta tiene un proyecto predeterminado (<username>'s Project en una cuenta nueva) que Lizard CLI usa en una carpeta sin enlazar. Un service ejecuta una aplicación o un worker. Managed Postgres, Managed Redis y Managed Object Storage proporcionan servicios de datos a los que las aplicaciones se conectan mediante referencias de entorno.
Las apps y Sandboxes tienen reglas distintas de ejecución y almacenamiento. Lee límites y almacenamiento y recuperación antes de depender del tamaño, la duración o la retención de datos de un recurso.
Encuentra el nivel de detalle adecuado
- Guías cubren una tarea desde la configuración hasta la comprobación del resultado.
- Guías de frameworks ofrecen comandos de compilación, adaptadores, puertos y comprobaciones para cada stack.
- Despliegue cubre fuentes de GitHub y locales, workers, escalado y regiones.
- Conceptos básicos explican proyectos, compilaciones y despliegues.
- Observabilidad cubre logs, métricas, costos e historial de despliegues.
- Referencia de Lizard CLI enumera comandos, flags y códigos de salida.
- Solución de problemas ayuda a diagnosticar un inicio fallido.
- Problemas conocidos registra límites y casos de recuperación que conviene revisar antes de una versión.
Actualizado