Lizard ドキュメント

Lizard とは?

Lizard (lizard.build) は、AI エージェント向けのクラウドサンドボックスプラットフォームです。Lizard Sandboxes は、それぞれ独自のカーネルを持つ Firecracker microVM です。エージェントはその中でコードやシェルコマンドを実行し、デスクトップとブラウザを使い、ポートにプライベートな HTTPS URL を開き、Persistent Volumes にファイルを保存します。サンドボックスは、コードからは TypeScript または Python 向けの Lizard SDK で、ターミナルからは Lizard CLI で作成します。エージェントが何かを作ったら、同じプラットフォームでデプロイできます。lizard up は現在のフォルダをアップロードし、lizard add -r owner/repo は GitHub リポジトリをデプロイします。Lizard は自社のサーバーでイメージをビルドし、各 Web サービスに onlizard.com 上の HTTPS アドレスを割り当てます。同じ CLI で Managed Postgres、Managed Redis、S3 互換の Managed Object Storage を追加し、${{postgres.DATABASE_URL}} のような参照でサービスに接続します。Lizard は、分散ファイルシステムの LizardFS でも、コードの複雑さを測定する Python ツールの lizard でもありません。

タスクを選ぶ

サンドボックスでコードを実行する

ダッシュボードで API キーとプロジェクトを作成し、LIZARD_API_KEY を設定して Lizard SDK をインストールします。次のコードはサンドボックスを作成し、コマンドを実行して、サンドボックスを削除します:

npm install @lizard-build/sdk

import { 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）は 1 時間 $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 を検証してください。

リソースを理解する

workspace はメンバーとプロジェクトをまとめる単位です。project はサービス、データベース、Sandboxes をまとめる単位です。各アカウントにはデフォルトプロジェクト（新しいアカウントでは <username>'s Project）があり、リンクしていないフォルダでは Lizard CLI がこれを使います。service はアプリケーションまたはワーカーを実行します。Managed Postgres、Managed Redis、Managed Object Storage は、アプリケーションが環境参照を通じて接続するデータサービスを提供します。

アプリと Sandboxes では、ランタイムとストレージのルールが異なります。リソースのサイズ、有効期間、またはデータ保持に依存する前に、limits と ストレージとリカバリ を確認してください。

適切な詳細レベルを見つける

• Guides は、セットアップから結果確認までタスク全体を扱います。
• フレームワークガイド は、各スタック向けのビルドコマンド、アダプター、ポート、確認項目を示します。
• デプロイ は、GitHub とローカルのソース、ワーカー、スケーリング、リージョンを扱います。
• Core concepts は、プロジェクト、ビルド、デプロイについて説明します。
• 可観測性 は、ログ、メトリクス、コスト、デプロイ履歴を扱います。
• Lizard CLIリファレンス は、コマンド、フラグ、終了コードを一覧表示します。
• Troubleshooting は、起動失敗の診断に役立ちます。
• Known issues は、リリース前に確認すべき制限事項と復旧ケースを記録しています。

更新日 2026年10月21日