AnyFrame – AIエージェント用サンドボックス

AnyFrameはTinyHQが提供する公式Python SDKで、AIエージェントのサンドボックス環境を一元管理します。開発者はGitHubリポジトリをエージェントに指定し、Claude Codeを実行する隔離サンドボックスを自動構築・起動できます。コントロールプレーンはPythonインターフェースで提供され、同期・非同期の両方に対応しています。

クイックスタート

インストールはuv add anyframe、APIキーはダッシュボードでafm_プレフィックスのものを生成します。認証は環境変数ANYFRAME_API_KEYで行い、ANYFRAME_BASE_URLもオプションで設定可能です。Web UIで既に起動しているセッションには、SDKが別のクライアントとしてアタッチし、メッセージ送信やSSEイベント購読が行えます。

コア機能

エージェント管理

エージェントはサンドボックス内で実行される基本単位で、リポジトリURL、システムプロンプト、ランタイム（デフォルトはClaude、Codexも可）、環境変数を含みます。作成後はビルドが必要で、依存関係をキャッシュイメージにパッケージ化します。ビルドログはURLまたはリアルタイムストリームで取得可能です。

スキルとMCP

スキルはエージェント起動時に読み込まれる命令セットで、デプロイやPRレビューなどのタスクを実行します。MCPサーバーはエージェントレベルのインライン設定、またはユーザーレベルのコネクタで統合管理できます。カタログにはLinear、Sentry、Googleなどの一般的なサービスが含まれ、OAuthとBearer Tokenの認証方式をサポートします。コネクタはエージェントごとに有効/無効を切り替えられます。

セッションとチャット

セッションはリアルタイムサンドボックスで、起動、実行、スナップショット、終了のライフサイクルを持ちます。「セットアップセッション」を使って手動でファイルシステムを初期化し、結果をエージェントのウォームアップイメージに昇格させることも可能です。セッション内では完全なチャットインターフェースが提供され、メッセージと応答はサンドボックスのチャットサーバーに直接プロキシされ、イベントはSSEでリアルタイム配信、履歴は随時取得できます。

プレビューサービス

サンドボックス内で複数の開発サーバーを起動し、トンネルでポートを公開できます。プレビューは名前またはポートでアドレス指定可能で、バッチ起動、状態確認、ログ表示、停止機能を備えています。このインターフェースは従来のserve_*メソッドを置き換えます。

高度な機能

アテンションレールは、未処理の権限要求、アイドルセッション、一時停止セッションなど、オペレーターが注意すべき項目を最新順に一覧表示します。認証情報管理では、Claude OAuth、OpenAI Codexトークン、GitHub PATを設定可能で、すべてのトークンは下4桁のみ表示されます。APIキーはSDK自身で管理でき、作成時に一度だけ生の値が返され、失効もサポートします。

エラーハンドリング

すべての例外はanyframe.AnyFrameErrorを継承し、APIエラー、認証エラー、404、409競合、422バリデーション、429レート制限、5xxサーバーエラーをカバーします。レート制限エラーはリトライまでの待機時間を明示的に提供します。

AnyFrameはMITライセンスで提供され、ドキュメントはdocs.anyfrm.com、バグや質問はDiscordで報告できます。