runpod-logは、RunPod GPU Podのログをターミナルから直接確認できるCLIツールです。

なぜ作ったのか

公式のRunPod CLIにはログ表示機能がありません。Webコンソールでしか見られないのですが、複数のPodを動かしたり自動化スクリプトを書くときに不便です。そこで、非公式APIを活用してターミナルからログを見られるようにしました。

主な機能

  • ログ取得: コンテナログとシステムログを一度に取得
  • リアルタイム監視: tailコマンドでログをファイルにリアルタイムストリーミング
  • 自動認証: Playwrightベースのブラウザ認証、トークン自動更新

使い方

# インストール
pip install runpod-log

# ログイン（ブラウザが開く）
runpod-log login

# ログを一度取得
runpod-log logs <pod-id>

# リアルタイム監視
runpod-log tail <pod-id> ./logs.txt

# ログアウト
runpod-log logout

仕組み

  1. 認証: ブラウザを開いてRunPodにログインし、hapi.runpod.netへのリクエストからJWTトークンをキャプチャ
  2. トークン更新: トークンが期限切れになると（約60秒）、ヘッドレスブラウザで自動更新
  3. ログ取得: https://hapi.runpod.net/v1/pod/{pod_id}/logs APIを呼び出し

セッション情報はローカルに保存されるため、毎回ログインする必要はありません。

興味があれば

AIエージェントとの連携や、複数のPodを監視する自動化スクリプトに便利です。

👉 github.com/ho4040/runpod-log