【Gradio】UIが起動しない・ポートエラーの解決法

GradioのUI起動・ポートエラー

Gradioの使用中にUI起動・ポートエラーに遭遇する場合があります。本記事ではこの問題の原因と解決方法を詳しく解説します。

エラーの症状

Gradioアプリを起動した際に「OSError: Port 7860 is already in use」「Connection refused」またはブラウザでアクセスできない問題が発生します。

原因

1. ポートの競合
別のプロセスが同じポートを使用している場合です。

2. リモート環境からのアクセス設定
デフォルトではlocalhostのみでリッスンし、外部アクセスができません。

3. セキュリティソフトのブロック
ファイアウォールがポートをブロックしている場合です。

解決方法

手順1: ポートの変更

import gradio as gr

demo = gr.Interface(fn=my_function, inputs="text", outputs="text")
demo.launch(server_port=7861)  # 別ポートを指定

手順2: 外部アクセスの有効化

# ローカルネットワークからアクセス可能にする
demo.launch(server_name="0.0.0.0")

# Gradioの共有リンクを使用（一時的な公開URL）
demo.launch(share=True)

手順3: ポートを使用しているプロセスの確認

# Linux/macOS
lsof -i :7860
kill -9 [PID]

# Windows
netstat -ano | findstr 7860
taskkill /F /PID [PID]

まとめ

本記事で紹介した手順を試すことで、多くの場合問題を解決できます。環境固有の問題が残る場合は、公式ドキュメントやコミュニティフォーラムを参照してください。