🏫

Colabのフォームがちゃんと動くWindows上のJupyterノートブック

に公開

Google Colabに接続できないので、今日の授業は休講です——なんてアナウンス、絶対に出したくない!
というわけで「備えあれば憂いなし」なローカル実行環境を数分で仕込むレシピを書き残します。

1. 事前チェック ― Python & pip は準備してますよね

ターミナル(PowerShell でも cmd.exe でも OK)で:

python --version          # → Python 3.10.11 など
python -m pip --version   # → pip 23.x from ...
  • エラーになる場合は、だいたい Microsoft Store 版 Python が犯人。
  • https://www.python.org/downloads/windows/ から公式 3.10 x64 を入れ直し、“Add Python to PATH” をチェックして再挑戦。

2. 作業ディレクトリも必要です

今回はユーザーフォルダ直下に colab_local を作る想定。

mkdir %USERPROFILE%\colab_local
cd    %USERPROFILE%\colab_local

%USERPROFILE%C:\Users\あなたの名前 に展開されます。

3. venv で仮想環境を作ります

cmd.exe の場合

python -m venv .venv          # venv 作成
.\.venv\Scripts\activate.bat

PowerShell の場合 (実行ポリシーで弾かれたら後述 FAQ)

python -m venv .venv          # venv 作成
.\.venv\Scripts\Activate.ps1

プロンプトが (.venv) C:\Users\...> になっていれば完了。
抜けるときは deactivate。ディレクトリ(cobal_local)ごと消せば完全初期化。

4. 必要なライブラリは3つだけ

pip install --upgrade pip
pip install notebook ipywidgets ipyform
# JupyterLab が好きなら:
# pip install jupyterlab

5. ローカルPC上で jupyter notebook サーバーを起動!

jupyter notebook
  • 既定ブラウザが開かなければ、ターミナルに出た
    http://127.0.0.1:8888/?token=xxxxx をコピペ。

  • ファイアウォール警告が出たら「アクセスを許可」で OK。

  • 終了はターミナルで Ctrl + C。次回起動は(cmd.exeの場合)

    cd %USERPROFILE%\colab_local
    .\.venv\Scripts\activate.bat
    jupyter notebook
    

6. Colab ノートを開いて ipyform を 2 行差し込む

  1. .ipynbファイルをアップロード、または、新規作成。

  2. 先頭セル (または新セル) にコレを追加:

    %load_ext ipyform
    %form_config --auto-detect 1
    
  3. 以降 # @param {type:"number"} など Colab のお作法セルが ipywidgets に早変わり。
    フォームをいじる → Enter で再実行。

(スクリーンショット)

7. FAQ ── つまずきやすい点

症状 処方箋
PowerShell が “実行ポリシーでブロック” 管理者不要で
Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned
ポート 8888 が埋まってる jupyter notebook --port 8890

🎉 まとめ

  • Colab 依存の # @param フォームipyform が丸ごと肩代わり。
  • 必要ライブラリは 3 個 なので、所要時間は数分。
  • これで「Colab につながらないから休講!」は回避できます。

Discussion