メインコンテンツまでスキップ

Google Colab を GitHub 連携するための手順

このサイトがお役に立ったら🌟で応援お願いします🙏
Star on GitHub

2026/01/19 更新: 最新の環境に合わせて記事内容をリライトしました。

Google Colabで作成したPythonコードを、GitHubを介してローカル環境（VSCodeやCursor、PyCharmなど）と連携し、本格的な開発フローに移行するための実践的な手順を解説します。

これまでColab上でのみ開発を行っていた方が、GitHubでのバージョン管理と、使い慣れたローカルエディタでの快適な編集環境を構築し、より効率的な開発体制を整えるための具体的なステップを紹介します。

  • リポジトリの準備: GitHub上での受け入れ環境の構築
  • 初回連携: ColabからGitHubへの安全なコード移行
  • ローカル環境: モダンなエディタ（VSCode/Cursor等）でのセットアップ
  • 運用ワークフロー: 日常的な開発サイクルの確立

現在の状況と目標​

出発点とゴール
  • 現在の状況
    • コードはGoogle Colab上にのみ存在（.ipynbファイル）
    • GitHubアカウントは所持しているが、連携用のリポジトリは未作成
    • ローカル環境にはまだコードが存在しない
    • Gitによるバージョン管理ができていない
  • 目標
    • GitHubでコードの変更履歴を確実に管理する
    • VSCodeやCursorなどのローカルエディタで快適に編集する
    • Google Colabでスムーズに動作確認・GPU実行を行う

1. GitHubリポジトリの準備​

まず、Colabからの保存を受け入れるための「箱（リポジトリ）」をGitHub上に用意します。

GitHubリポジトリの作成

  1. GitHubにログインし、画面右上の「+」アイコンから New repository を選択します。
  2. Repository name に任意の名前を入力します（例: colab-data-analysis）。
  3. Public（公開）か Private（非公開）を選択します。個人的なプロジェクトであればPrivate推奨です。
  4. Initialize this repository with: の項目で Add a README file にチェックを入れます。
    • ※ ここでREADMEを作成することで main ブランチが自動生成され、後のColab連携がスムーズになります。
  5. Create repository ボタンをクリックして作成を完了します。

2. ColabからGitHubへの初回保存​

作成したリポジトリに対して、現在開いているColabノートブックを保存します。

  1. Colabで対象のノートブックを開きます。
  2. メニューから ファイル > GitHubにコピーを保存 を選択します。

メニューからGitHubにコピーを保存を選択

GitHub認証について

初回利用時や認証が切れている場合、Google ColabによるGitHubへのアクセス許可を求めるポップアップが表示されます。「Authorize googlecolab」などのボタンをクリックし、連携を許可してください。

GitHub認証プロセス

  1. 保存先を設定します。
    • リポジトリ: 先ほど作成した your-username/your-repository-name を選択
    • ブランチ: main を選択
    • コミットメッセージ: Initial commit of notebook from Colab など分かりやすいメッセージを入力

保存先設定ダイアログ

  1. OK ボタンをクリックして保存を実行します。

3. ローカル開発環境のセットアップ​

GitHub上のコードをローカルマシンにダウンロードし、使い慣れたエディタで編集できる環境を整えます。

リポジトリのクローン​

  1. GitHubリポジトリのページで、緑色の Code▼ ボタンをクリックします。

GitHub Codeボタン

  1. HTTPS タブを選択し、表示されたURLをコピーします。
  2. ターミナルを開き、プロジェクトを保存したいディレクトリへ移動してから、クローン（複製）コマンドを実行します。
# 作業フォルダへ移動（任意の場所でOKです）
cd ~/Documents

# リポジトリをクローン
git clone [コピーしたリポジトリURL]

# 作成されたリポジトリフォルダの中へ移動
cd [リポジトリ名]

エディタの設定（VSCode / Cursor 共通）​

ここでは、現在最も人気のある VSCode や、そのフォークでありAI補完に強い Cursor を例に説明します。

  1. クローンしたフォルダをエディタで開きます（ターミナルで code . や cursor . と打つと便利です）。
  2. Jupyter Notebook（.ipynb）を快適に扱うための拡張機能をインストールします。
    • Python: 言語サポート
    • Jupyter: ノートブックのレンダリング・実行に必要
  3. .ipynb ファイルをGitで管理しやすくするコツ
    • Gitの差分（diff）をテキストベースで厳密に確認したい場合は、エクスプローラー上で .ipynb ファイルを右クリック > 別のエディターで開く... > テキストエディター を選択します。

VSCodeテキストエディター選択

VSCode右クリックメニュー

これにより、ファイルが生のJSON形式で表示され、どの行が変更されたかを確認しやすくなります。通常通りノートブックとして編集・実行したい場合は、ダブルクリックで通常のJupyter形式として開けます。

4. 日常の開発ワークフロー​

編集からGitHub保存まで​

  1. ローカルエディタでコード編集

    • 使い慣れたエディタ（VSCode/Cursor等）で自由にコードを編集・補完します。

  2. 変更をGitHubに保存（Push）

    • 編集が完了したら、ターミナルで以下のコマンドを実行して変更内容をGitHubに送信します。
    git add .

    # メッセージ例: feat(機能追加), fix(修正), docs(ドキュメント) など
    git commit -m "feat: データ前処理ロジックを追加"

    git push origin main

  3. Colabで動作確認（Pull）

    • Colabを開き、ファイル > ノートブックを開く を選択し、GitHub タブに切り替えます。

Colab ノートブックを開く GitHubタブ

  • 対象のリポジトリを選択（またはURLで検索）し、最新版に更新されたノートブックを開いて実行します。

Colab リポジトリ検索

重要な運用ルール​

スムーズな連携を維持し、コンフリクト（編集の競合）を避けるために、以下のルールを徹底しましょう。

1. 作業開始前の「同期」確認（最重要）​

どの環境で編集を始める場合でも、作業前に必ず最新の状態を取得してください。

  • ローカルで作業を開始する場合:
    • まず git pull origin main を実行し、リモートの最新版を取り込みます。
  • Colabで作業を開始する場合:
    • ブラウザで開いたままのタブは古い状態の可能性があります。ファイル > ノートブックを開く > GitHub タブから、常に最新のコミットを開き直すことを推奨します。

2. 編集完了時の「保存」​

編集が完了したら、必ずその内容をGitHubにプッシュしてください。

  • ローカルで編集した場合: git push を忘れない。
  • Colabで編集した場合: ファイル > GitHubにコピーを保存 を実行。これを忘れてブラウザを閉じると、Colabでの変更は消えてしまいます。

3. コンフリクト発生時の対処​

万が一、競合（コンフリクト）が発生してしまった場合は、ローカル環境（VSCode等）で解消するのが最も簡単です。VSCodeやCursorには強力なコンフリクト解消ツールが内蔵されているため、差分を比較してどちらの変更を残すか選択しましょう。

まとめ​

この手順により、Google ColabとGitHub、そして使い慣れたローカルエディタが連携した強力な開発環境が構築できます。

  • GitHub: 確実なバージョン管理とバックアップ
  • ローカルエディタ (VSCode/Cursor等): AI補完や強力な拡張機能を活用した高速なコーディング
  • Google Colab: クラウド上のGPU/TPUリソースによる実行環境

それぞれのツールの強みを活かし、適切な運用ルールを守ることで、コンフリクトのリスクを抑えながら柔軟で安全な開発ワークフローを実現しましょう。

このサイトがお役に立ったら🌟で応援お願いします🙏
Star on GitHub

参考文献​