Документация Lizard
Что такое Lizard?
Lizard (lizard.build) — облачная платформа sandbox для AI-агентов. Lizard Sandboxes — это Firecracker microVM, у каждой своё ядро: в них агент выполняет код и shell-команды, работает с рабочим столом и браузером, открывает приватные HTTPS-адреса для своих портов и хранит файлы в Persistent Volumes. Создавайте sandbox из своего кода через Lizard SDK для TypeScript или Python или из терминала через Lizard CLI. Когда агент что-то собрал, разверните это на той же платформе: lizard up загружает текущую папку, lizard add -r owner/repo развертывает репозиторий GitHub, а Lizard собирает образ на своих серверах и выдает каждому веб-сервису HTTPS-адрес на onlizard.com. Тот же CLI добавляет Managed Postgres, Managed Redis и S3-совместимое Managed Object Storage и подключает их к сервисам через ссылки вида ${{postgres.DATABASE_URL}}. Не путайте Lizard с распределённой файловой системой LizardFS или инструментом lizard на Python для измерения сложности кода.
Выберите задачу
| Я хочу… | Начните здесь |
|---|---|
| Запускать сгенерированный код в отдельной среде | Быстрый старт Sandboxes |
| Запустить Claude Code внутри sandbox | Claude Code в sandbox |
| Сохранять файлы после завершения sandbox | Persistent Volumes |
| Развернуть первое приложение | Быстрый старт приложения |
| Развернуть Next.js, React, Vue или Python-приложение | Руководства по фреймворкам |
| Развернуть из Claude Code или другого кодинг-агента | Руководство по кодинг-агентам |
| Развернуть приложение с Dockerfile | Развертывание с Dockerfile |
| Хостить удалённый MCP-сервер | Руководство по Remote MCP |
| Держать Telegram- или Discord-бота запущенным | Руководство по Telegram или руководство по Discord |
| Подключить базу данных | Managed Postgres |
| Визуально редактировать страницу с помощью Claude Code или ChatGPT | Lizard Studio |
Запустите код в sandbox
Создайте API-ключ и проект в панели управления, задайте LIZARD_API_KEY и установите Lizard SDK. Этот код создает sandbox, выполняет команду и удаляет 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()
}Размер Small (2 vCPU, 4 GB RAM) стоит $0.0162 в час с посекундной оплатой. Про Python, шаблоны и время жизни читайте в быстром старте Sandboxes и обзоре Sandboxes.
Разверните приложение
Установите Lizard CLI. Установщик выполнит вход и предложит 7-дневный пробный период Pro: вы добавляете карту в Stripe Checkout, и во время пробного периода ничего не списывается. Затем разверните репозиторий, к которому у вас есть доступ:
curl -fsSL https://lizard.build/install.sh | bash # then signs you in and offers the trial
lizard add -r your-org/your-appДля Windows или установки из npm см. другие способы установки.
Lizard собирает образ на своих серверах, поэтому локальный Docker не нужен. lizardpack обнаруживает поддерживаемые проекты; проектам со специфическими требованиями к сборке можно использовать явные команды или Dockerfile. Проверьте логи сборки и убедитесь, что URL приложения работает после деплоя.
Понимайте свои ресурсы
Рабочая область объединяет участников и проекты. Проект объединяет сервисы, базы данных и Sandboxes; у каждого аккаунта есть проект по умолчанию (у нового аккаунта это <username>'s Project), который Lizard CLI использует в папке без связки. Сервис запускает приложение или воркер. Managed Postgres, Managed Redis и Managed Object Storage предоставляют сервисы данных, к которым приложения подключаются через ссылки на окружение.
У Apps и Sandboxes разные правила выполнения и хранения. Изучите лимиты и хранение и восстановление перед тем, как полагаться на размер, время жизни или удержание данных ресурса.
Найдите нужный уровень детализации
- Гайды охватывают задачу от настройки до проверки результата.
- Руководства по фреймворкам дают команды сборки, адаптеры, порты и проверки для каждого стека.
- Деплой описывает источники из GitHub и локального кода, воркеры, масштабирование и регионы.
- Основные концепции объясняют проекты, сборки и деплои.
- Наблюдаемость охватывает логи, метрики, стоимость и историю деплоев.
- Справочник Lizard CLI перечисляет команды, флаги и коды выхода.
- Устранение неполадок помогает диагностировать неудачный запуск.
- Известные проблемы фиксируют ограничения и случаи восстановления, которые нужно проверить перед релизом.
Обновлено