Skip to main content
term-llm は、Go で書かれたオープンソースのターミナルファーストな AI ランタイムです。自然言語を実行可能なシェルコマンドに変換し、ツールや MCP サーバーを備えた永続的なチャットを実行し、モデルの支援を受けてファイルを編集できるほか、エージェント、スキル、セッション、ジョブ、ローカルの自動化にも対応しています。以下の手順に従って、term-llm を SambaCloud でホストされているモデルに接続してください。

前提条件

作業を始める前に、以下の環境を準備してください。
  • SambaCloud アカウントと API キー
  • macOS、Linux、または WSL 上の POSIX シェル
  • Go 1.22 以降 (ソースからビルドする場合のみ)

セットアップ

1

term-llm のインストール

公式インストールスクリプトを使用して term-llm をインストールします。
または Go でインストールします。
term-llm --version が command not found を返す場合 (macOS でよく発生します) は、インストールディレクトリを PATH に追加します。
この変更を永続化するには、同じ行を ~/.zshrc (macOS のデフォルト) または ~/.bashrc に追記し、ターミナルを再起動するか source ~/.zshrc を実行します。
2

SambaNova API キーの設定

SambaCloud の API キーをエクスポートします。
あるいは、~/.config/term-llm/config.yaml の providers.sambanova.api_key に API キーを直接設定することもできます。
3

SambaNova をデフォルトプロバイダーに設定

SambaNova をデフォルトプロバイダーとして設定し、使用するモデルを設定します。
これらのコマンドは、~/.config/term-llm/config.yaml が存在しない場合は作成し、その場で編集します。term-llm config set providers.sambanova.model <TAB> でモデル ID をタブ補完できます。または、~/.config/term-llm/config.yaml を直接編集します。
4

SambaNova モデルの利用開始

設定したプロバイダーを使用してプロンプトを実行します。質問をします。
自然言語をシェルコマンドに変換します。
対話型セッションを開始します。
1 回のリクエストに限り、設定済みのモデルを上書きするには、次のように実行します。

利用可能なモデル

チャットに対応したすべての SambaNova モデルを、コンテキストウィンドウと料金情報とともに一覧表示します。
term-llm には、SambaNova の公開料金情報と同期された料金表が同梱されています。

ビデオチュートリアル

以下のビデオでは、term-llm のインストール、SambaNova の設定、SambaCloud モデルの利用開始までを紹介しています。

トラブルシューティング

インストール後に term-llm が見つからない場合 (macOS でよく発生します) は、インストールディレクトリを PATH に追加します。
この変更を永続化するには、同じ行を ~/.zshrc (macOS のデフォルト) または ~/.bashrc に追記し、ターミナルを再起動するか source ~/.zshrc を実行します。 SAMBANOVA_API_KEY が認識されない場合は、キーが設定されており、リテラルの山括弧が含まれていないことを確認します。
出力が空または不正な場合は、API キーを再度エクスポートするか、SambaCloud ポータルで新しいキーを生成してください。 設定したモデルが利用できずリクエストが失敗する場合は、現在の SambaNova モデルを一覧表示します。
その後、~/.config/term-llm/config.yaml の model: フィールドを、一覧に表示されたモデル ID のいずれかに更新します。 ~/.config/term-llm/config.yaml が存在しない場合は、先に設定ディレクトリを作成します。

参考情報