Pip Installs Packages の略で、Pythonの公式パッケージ管理ツールです。世界中の開発者が公開したライブラリを一行のコマンドでインストールできます。

---

パッケージはどこから来るのか

あなたのPi
└── pip install unicornhat
        ↓
    PyPI (Python Package Index)
    https://pypi.org
    └── 50万以上のパッケージが公開されている
            ↓
        ~/unicorn-env/lib/ にダウンロード・展開

pip install は PyPI からパッケージを探してダウンロードし、Pythonが読み込める場所に配置するまでを自動でやってくれます。

---

よく使うコマンド

# インストール
pip install unicornhat

# バージョンを指定してインストール
pip install unicornhat==0.0.2

# アンインストール
pip uninstall unicornhat

# アップデート
pip install --upgrade unicornhat

# 今入っているパッケージを一覧表示
pip list

# 特定パッケージの詳細情報
pip show unicornhat

# パッケージを検索（名前がうろ覚えのとき）
pip search キーワード

---

pip list の見方

Package    Version
---------- -------
pip        24.0
RPi.GPIO   0.7.1       ← GPIOピン制御
spidev     3.6         ← SPI通信
unicornhat 2.2.3       ← Unicorn HAT本体

---

requirements.txt で環境を再現する

チームで共有したり、Piを買い替えたときに同じ環境をすぐ作れます。

# 現在の環境をファイルに書き出す
pip freeze > requirements.txt

# requirements.txt の中身
# unicornhat==2.2.3
# RPi.GPIO==0.7.1
# spidev==3.6

# 別の環境で一括インストール
pip install -r requirements.txt

---

pip と apt の違い

Raspberry Pi では apt と pip の両方でパッケージを入れられますが、役割が違います。

	apt	pip
管理元	Debian/Raspbian	PyPI
対象	OS全体のソフト	Pythonライブラリ
例	apt install git	pip install requests
Pythonパッケージ数	少ない	50万以上
OSとの統合	深い	独立している

Pythonライブラリは基本的に pip で入れるのが現代の主流です。

---

pip 自体のアップデート

# pip 自体が古いと警告が出ることがある
pip install --upgrade pip

---

トラブルシューティング

# pip が見つからないとき
python3 -m pip install unicornhat

# 仮想環境外で誤って実行しそうなとき、現在どのpipか確認
which pip
# → /home/pi/unicorn-env/bin/pip なら仮想環境内
# → /usr/bin/pip なら仮想環境外（Bookworm では弾かれる）

---

Unicorn HATプロジェクトで使う範囲では、基本的に pip install と pip list の2つを覚えておけば十分です。