Aider

Aider は、オープンソースのターミナルベース AI ペアプログラミングツールです。大規模で活発なコミュニティを持ち、自然言語の指示に基づいてコードベースを直接編集し、git と完全に連携して動作します。

前提条件

SambaCloud アカウントと API キー
Python 3.9 以上 (pip でインストールする場合は 3.10 〜 3.12)
作業対象となる git リポジトリ (Aider はすべての編集で git を使用します)

セットアップ

Aider のインストール

Aider が公式ドキュメントで案内しているインストール方法です。

python -m pip install aider-install
aider-install

これにより、Aider は専用の分離された環境にインストールされ、aider コマンドが PATH に追加されます。プロジェクトが使用する Python 環境が何であっても影響を受けません。

ご自身の仮想環境への通常の pip install aider-chat でも動作しますが、その場合は Python 3.10 〜 3.12 が必要です。サポート外のバージョンでは、pip はエラーを報告せず、古い Aider リリースをそのままインストールします。aider-install は Aider 自身が推奨する方法であり、プロジェクトのパッケージとの依存関係の競合も回避できます。

プロジェクトディレクトリへの移動

cd /path/to/your/project

Aider はすべての編集で git を使用するため、このディレクトリは git リポジトリである必要があります (リポジトリでない場合は、先に git init を実行してください)。

SambaCloud API キーのエクスポート

Aider では、カスタムの OpenAI 互換エンドポイントを環境変数 OPENAI_API_BASE と OPENAI_API_KEY 経由で指定します。

export OPENAI_API_BASE="https://api.sambanova.ai/v1"
export OPENAI_API_KEY="your-sambanova-api-key"

これらのエクスポートは、同じシェルにすでに設定されている OpenAI の認証情報を上書きします。両者を分けて使いたい場合は、コマンドラインで --openai-api-base と --openai-api-key を渡すか、両方の変数をファイルに記述して --env-file で読み込んでください。

SambaNova モデルでの Aider の起動

モデル名に openai/ プレフィックスを付けます。

aider --model openai/MiniMax-M3

これで、現在の git リポジトリ内で Aider の対話型チャットが開きます。

利用方法

Aider に編集させたいファイルを、コマンドラインで指定します。これによりファイルが「チャットに追加」され、Aider がその内容を参照・変更できるようになります。

aider --model openai/MiniMax-M3 calculator.py

Aider v0.86.2
Model: openai/MiniMax-M3 with whole edit format
Git repo: .git with 1 files
Repo-map: using 1024 tokens, auto refresh
Added calculator.py to the chat.

calculator.py>

プロンプトで、加えたい変更を平易な言葉で記述します。

calculator.py> Add a function that computes a factorial

プロンプト例の日本語訳

階乗を計算する関数を追加してください

追加するのは、実際に編集が必要なファイルだけにしてください。Aider はリポジトリの残りの部分から関連するコンテキストを自動的に取り込むため、ファイルを追加しすぎるとトークンを浪費し、モデルを混乱させる可能性があります。ファイルを指定せずに Aider を起動し、依頼内容から編集対象を判断させることもできます。また、セッションの途中でチャット内コマンド /add を使ってファイルを追加することもできます。 Aider による変更はすべて自動的に git にコミットされるため、変更のレビューも取り消しも簡単です。意図した変更でなかった場合は、チャット内コマンド /undo で元に戻せます。

使用例: 非対話モードでの編集

--message を使うと、特定のファイルに対して非対話モードで実行できます。スクリプトからの利用に便利です。

aider --model openai/MiniMax-M3 --message "Add a subtract(a, b) function to calculator.py that returns a - b" calculator.py

プロンプト例の日本語訳

calculator.py に、a - b を返す subtract(a, b) 関数を追加してください

Output (abridged)

calculator.py

 def add(a, b):
     return a + b
+
+def subtract(a, b):
+    return a - b

Tokens: 746 sent, 30 received.
Applied edit to calculator.py

編集内容は即座にディスクに書き込まれ、git にコミットされます。

モデルの実際のコンテキストウィンドウの登録

追加の設定がない状態では、Aider は MiniMax-M3 を認識できず、次の警告を出力します。

Warning for openai/MiniMax-M3: Unknown context window size and costs, using sane defaults.

これを解消するには、リポジトリのルート (またはホームディレクトリ) に .aider.model.metadata.json を作成します。

.aider.model.metadata.json

{
  "openai/MiniMax-M3": {
    "max_tokens": 1048576,
    "max_input_tokens": 1048576,
    "max_output_tokens": 1048576
  }
}

このファイルを配置すると警告が消え、Aider のリポジトリマップ (repo map) がデフォルトの 1024 トークンから 4096 トークンに拡大します。MiniMax-M3 は 1048576 トークンの上限を入力と出力で共有しているため、各値が同じになっています。他のモデルのコンテキストウィンドウについては SambaCloud モデルをご参照ください。

トラブルシューティング

Warning: Unknown context window size and costs, using sane defaults

Aider は SambaNova モデルのメタデータを組み込みで持っていません。上記のとおり .aider.model.metadata.json ファイルを追加してください (モデルの実際のコンテキストウィンドウの登録をご参照ください)。

モデルは応答するが、編集が適用されない

対象ファイルを引数として渡したこと (または対話型チャット内で追加したこと) を確認してください。Aider が編集するのは、チャットのファイルリストに含まれるファイルだけです。

command not found: aider または ModuleNotFoundError が発生する

aider-install を使用した場合は、インストーラーが最後まで完了し、そのインストール先が PATH に含まれていることを確認してください。pip install aider-chat で直接インストールした場合は、誤って pip install aider を実行していないこと (これは無関係の別パッケージです) と、仮想環境が有効化されていることを確認してください。

認証エラーまたは 401 が発生する

Aider を実行しているのと同じシェルセッションで、OPENAI_API_BASE と OPENAI_API_KEY の両方がエクスポートされていることを確認してください: echo $OPENAI_API_BASE および echo $OPENAI_API_KEY。

概要

開発者ツール

フレームワーク

インターフェースとローコード

データとインフラ

マルチモーダル

評価とモニタリング

前提条件

セットアップ

利用方法

使用例: 非対話モードでの編集

モデルの実際のコンテキストウィンドウの登録

トラブルシューティング

参考情報

​前提条件

​セットアップ

​利用方法

​使用例: 非対話モードでの編集

​モデルの実際のコンテキストウィンドウの登録

​トラブルシューティング

​参考情報

前提条件

セットアップ

利用方法

使用例: 非対話モードでの編集

モデルの実際のコンテキストウィンドウの登録

トラブルシューティング

参考情報