Pi Agent: Installation & Authentication
最終更新：2026-08-31
--- title: "インストールと認証" description: "Pi Agentのインストール、Python環境の設定、APIキーとモデルプロバイダーの構成、初回起動の完了方法を学びます。" order: 2 lang: ja
工欲善其事、必先利其器。このレッスンで5分でPi Agent開発環境を立ち上げよう。
1. 要件
| 項目 | 最低 | 推奨 |
|---|---|---|
| Python | 3.9+ | 3.11+ |
| pip | 最新版 | 最新版 |
| OS | Windows / macOS / Linux | 任意 |
| メモリ | 512MB空き | 2GB+ |
| ディスク | 200MB | 1GB+ |
Pythonバージョンの確認：
BASH
python --version
# Python 3.11.8
2. Pi Agentのインストール
(1) pipインストール（推奨）
BASH
pip install pi-agent
(2) ソースからインストール
BASH
git clone https://github.com/pi-agent/pi-agent.git
cd pi-agent
pip install -e .
(3) インストールの確認
BASH
pi-agent --version
# Pi Agent v0.8.0
(4) オプション依存パッケージ
BASH
pip install pi-agent[all] # 全オプション依存パッケージをインストール
pip install pi-agent[deepseek] # DeepSeekサポート
pip install pi-agent[local] # ローカルモデルサポート (llama.cpp)
pip install pi-agent[tools] # 拡張ツールセット
3. 認証とモデル設定
Pi Agentは複数のLLMプロバイダーをサポートしています。使用前にAPIキーを設定する必要があります。
(1) 環境変数（推奨）
BASH
# DeepSeek
export PI_DEEPSEEK_API_KEY="sk-xxxxxxxx"
# OpenAI
export PI_OPENAI_API_KEY="sk-xxxxxxxx"
# Anthropic
export PI_ANTHROPIC_API_KEY="sk-ant-xxxxxxxx"
Windows PowerShell：
POWERSHELL
$env:PI_DEEPSEEK_API_KEY = "sk-xxxxxxxx"
(2) 設定ファイル
~/.pi-agent/config.yamlを作成：
YAML
providers:
deepseek:
api_key: "sk-xxxxxxxx"
base_url: "https://api.deepseek.com"
model: "deepseek-chat"
openai:
api_key: "sk-xxxxxxxx"
model: "gpt-4o"
anthropic:
api_key: "sk-ant-xxxxxxxx"
model: "claude-sonnet-4-20250514"
default_provider: deepseek
(3) コード内設定
PYTHON
from pi_agent import Agent
agent = Agent(
name="my_agent",
provider="deepseek",
api_key="sk-xxxxxxxx",
model="deepseek-chat"
)
4. モデルプロバイダー一覧
| プロバイダー | モデル例 | 強み | 価格 |
|---|---|---|---|
| DeepSeek | deepseek-chat | コストパフォーマンスが高い、中国語に優れる | 低 |
| OpenAI | gpt-4o | 総合能力が強い | 中〜高 |
| Anthropic | claude-sonnet-4-20250514 | 長文対応、コードに強い | 中 |
| ローカルモデル | llama.cpp | プライバシー、オフライン | 無料 |
| Ollama | llama3, mistral | ローカルデプロイが簡単 | 無料 |
例1：マルチプロバイダー切り替え（難易度：⭐）
PYTHON
from pi_agent import Agent
deepseek_agent = Agent(provider="deepseek", model="deepseek-chat")
openai_agent = Agent(provider="openai", model="gpt-4o")
result_d = deepseek_agent.chat("Explain quantum computing in one sentence")
result_o = openai_agent.chat("Explain quantum computing in one sentence")
print(f"DeepSeek: {result_d}")
print(f"OpenAI: {result_o}")
5. 初回起動テスト
インストールと設定が完了したら、クイックテストを実行：
BASH
pi-agent chat "Hello, Pi Agent!"
期待される出力：
TEXT
📖 参照専用
Pi Agent v0.8.0
Provider: deepseek (deepseek-chat)
Hello! I'm Pi Agent, how can I help you?
Aliceは3分でセットアップを完了しました。Bobの感想：「Pi AgentのインストールはほとんどのPythonツールより簡単——インストールして、キーを設定すればOK。」
❓ よくある質問
Q pip installが失敗する？
A まずpipをアップグレードしてください（
pip install --upgrade pip）。ネットワークの問題なら、ミラーを使用：pip install pi-agent -i https://pypi.tuna.tsinghua.edu.cn/simple。Q APIキーを設定したのに動かない？
A 環境変数名を確認してください（
PI_プレフィックスが必要）。設定ファイルのパスも確認（~/.pi-agent/config.yaml）。コード内設定が最優先されます。Q APIキーなしでPi Agentを使える？
A はい。
pi-agent[local]をインストールし、llama.cppまたはOllamaでローカルモデルを実行すれば、APIキーなしで利用できます。レッスン18を参照。📖 まとめ
- Python 3.9+が必要；
pip install pi-agentで始められる - 3つの認証方法：環境変数（推奨）、設定ファイル、コード内設定
- 複数LLMプロバイダーをサポート；DeepSeekが最もコストパフォーマンスが高い；ローカルモデルは無料
- 初回起動：
pi-agent chatでセットアップを確認
📝 練習問題
- 基礎（難易度：⭐）: Pi Agentをインストールし、
pi-agent --versionで確認してください。 - 中級（難易度：⭐⭐）: 2つ以上のLLMプロバイダーを設定し、それぞれにAgentインスタンスを作成して接続を確認してください。
- 上級（難易度：⭐⭐⭐）: 利用可能なAPIキーを自動検出し、現在利用可能なプロバイダーを一覧表示するスクリプトを書いてください。
