コンテンツにスキップ

git-ollama 利用ガイド

このツールは、ローカルで動作する Ollama の LLM を使用して、Git のコミットメッセージを自動生成し、プッシュまでの流れをサポートする CLI ツールです。

概要

  • 目的: 変更内容 (git diff) に基づいた最適なコミットメッセージを AI で生成します。
  • 言語: 日本語でメッセージを生成します。
  • 形式: Conventional Commits 形式 (feat:, fix:, docs: など) に準拠します。

必要条件

  1. Ollama: ローカルで実行されている必要があります。
  2. モデル: qwen3-coder:30b (または同等のモデル) がプルされている必要があります。
    • 他のモデルを使用する場合は scripts/git_ollama.py 内の DEFAULT_MODEL を書き換えてください。
  3. Python: 実行環境にインストールされており、requests ライブラリが必要です。

セットアップ

依存ライブラリのインストール: 

pip install requests

使い方

  1. ファイルのステージング 変更したファイルを git add します。 

    git add .

  2. ツールの実行 リポジトリのルートディレクトリで以下のコマンドを実行します。 

    .\scripts\git-ollama.bat

  3. メッセージの確認と確定 AI が生成したメッセージが表示されます。

    • Do you want to commit with this message? (y/n) : y でコミットを実行。
    • Do you want to push to GitHub? (y/n) : y で GitHub にプッシュ。

カスタマイズ

scripts/git_ollama.py の定数を変更することで挙動を調整できます。

  • DEFAULT_MODEL: 使用するモデル名 (例: llama3.1:8b)
  • OLLAMA_API_URL: Ollama サーバーの URL (デフォルト: http://localhost:11434/api/generate)

作成日: 2026-02-16 作成者: AntiGravity