cli-anything-ollama は何をしますか？
Ollama REST APIを介したローカルLLM推論とモデル管理のためのCLIツール。GUIなしでモデル管理、テキスト生成、チャット、埋め込み作成を行う必要があるAIエージェントやパワーユーザー向けに設計されています。
インストール
このCLIはcli-anything-ollamaパッケージの一部としてインストールされます：
pip install cli-anything-ollama
前提条件：
- Python 3.10以上
- Ollamaがインストールされ、実行中であること（
ollama serve）
使い方
基本コマンド
# ヘルプを表示
cli-anything-ollama --help
# インタラクティブREPLモードを開始
cli-anything-ollama
# 利用可能なモデルを一覧表示
cli-anything-ollama model list
# JSON出力で実行（エージェント向け）
cli-anything-ollama --json model list
REPLモード
サブコマンドなしで呼び出すと、インタラクティブなREPLセッションが開始されます：
cli-anything-ollama
# タブ補完と履歴を使って対話的にコマンドを入力
コマンドグループ
モデル (Model)
モデル管理コマンド。
| コマンド | 説明 |
|---|---|
list | ローカルで利用可能なモデルを一覧表示 |
show | モデルの詳細を表示（パラメータ、テンプレート、ライセンス） |
pull | Ollamaライブラリからモデルをダウンロード |
rm | ローカルストレージからモデルを削除 |
copy | モデルを新しい名前でコピー |
ps | 現在メモリに読み込まれているモデルを一覧表示 |
生成 (Generate)
テキスト生成およびチャットコマンド。
| コマンド | 説明 |
|---|---|
text | プロンプトからテキストを生成 |
chat | チャット補完リクエストを送信 |
埋め込み (Embed)
埋め込み生成コマンド。
| コマンド | 説明 |
|---|---|
text | テキストの埋め込みを生成 |
サーバー (Server)
サーバーの状態と情報のコマンド。
| コマンド | 説明 |
|---|---|
status | Ollamaサーバーが実行中か確認 |
version | Ollamaサーバーのバージョンを表示 |
セッション (Session)
セッション状態のコマンド。
| コマンド | 説明 |
|---|---|
status | 現在のセッション状態を表示 |
history | 現在のセッションのチャット履歴を表示 |
例
モデルの一覧表示とダウンロード
# 利用可能なモデルを一覧表示
cli-anything-ollama model list
# モデルをダウンロード
cli-anything-ollama model pull llama3.2
# モデルの詳細を表示
cli-anything-ollama model show llama3.2
テキスト生成
# テキストをストリーム表示（デフォルト）
cli-anything-ollama generate text --model llama3.2 --prompt "量子コンピューティングを一文で説明してください"
# 非ストリーミングでJSON出力（エージェント向け）
cli-anything-ollama --json generate text --model llama3.2 --prompt "こんにちは" --no-stream
チャット
# シングルターンチャット
cli-anything-ollama generate chat --model llama3.2 --message "user:Pythonとは何ですか？"
# マルチターンチャット
cli-anything-ollama generate chat --model llama3.2 \
--message "user:Pythonとは何ですか？" \
--message "user:JavaScriptとどう比較されますか？"
# JSONファイルからのチャット
cli-anything-ollama generate chat --model llama3.2 --file messages.json
埋め込み
cli-anything-ollama embed text --model nomic-embed-text --input "こんにちは世界"
cli-anything-ollama embed text --model nomic-embed-text --input "こんにちは" --input "世界"
インタラクティブREPLセッション
探索的な使用のためにインタラクティブセッションを開始します。
cli-anything-ollama
# 対話的にコマンドを入力
# 利用可能なコマンドを表示するには 'help' を使用
リモートホストへの接続
cli-anything-ollama --host http://192.168.1.100:11434 model list
状態管理
CLIは軽量なセッション状態を維持します：
- 現在のホストURL：
--hostで設定可能 - チャット履歴：REPLでのマルチターン会話のために追跡
- 最後に使用したモデル：REPLプロンプトに表示
出力形式
すべてのコマンドは2つの出力モードをサポートしています：
- 人間可読（デフォルト）：テーブル、色付き、整形されたテキスト
- 機械可読（
--jsonフラグ）：エージェントが消費するための構造化JSON
# 人間向け出力
cli-anything-ollama model list
# エージェント向けJSON出力
cli-anything-ollama --json model list
AIエージェント向け
このCLIをプログラム的に使用する場合：
- 解析可能な出力のために常に
--jsonフラグを使用 - リターンコードを確認 - 0は成功、0以外はエラー
- エラー発生時はstderrを解析してエラーメッセージを取得
- generate/chatでは
--no-streamを使用して完全なレスポンスを取得 - 他のコマンドの前に
server statusでOllamaが実行中であることを確認
詳細情報
- 完全なドキュメント：パッケージ内のREADME.mdを参照
- テストカバレッジ：パッケージ内のTEST.mdを参照
- 方法論：cli-anything-plugin内のHARNESS.mdを参照
バージョン
1.0.1