1.1　開発環境の構築（Mac）

　ここでは、Mac上でPythonの開発環境を構築する方法を説明します。Windowsの場合は、次の節を参照してください。Pythonの開発環境を構築済みの方は、この節と次の節を飛ばしてください。

1.1.1　Homebrewのインストール

　これからMacにPythonをインストールしますが、その前にHomebrewをインストールする必要があります。Homebrewは、Macでソフトウェアをインストールするためのパッケージ管理システムです。Homebrewを使うことで、ソフトウェアのインストールやアンインストールが簡単に行えるようになります。

　まず、Homebrewのホームページ（次のURL）にアクセスしてください。

　https://brew.sh/index_ja

　「インストール」という文字の下にあるコマンドをコピーしてください。コマンドの右側のアイコンをクリックしてもコピーできます。おそらく、次のようなコマンドがコピーされるはずです。

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

　次に、ターミナルを起動し、先ほどコピーしたコマンドを貼り付けてください。

　Enterキーを押すと、Homebrewのインストールが始まります。途中でパスワードを求められるので、Macのパスワードを入力してください。

　Apple Siliconが搭載されたMacの場合、Homebrewのインストールが完了したら、次のコマンドを入力してください。Apple SiliconとはAppleが開発したCPUのことで、M1やM2といった名前が付けられています。

echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> /Users/ユーザー名/.zprofile
eval "$(/opt/homebrew/bin/brew shellenv)"

　その際、「ユーザー名」は、ご自身のユーザー名に置き換えてください。ご自身のユーザー名は、ターミナルでwhoamiと入力すると確認できます。Homebrewのインストールログの最後に、次のようなメッセージが表示されているので、そこからコピーしてもOKです。

==> Next steps:
- Run these two commands in your terminal to add Homebrew to your PATH:
    echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> /Users/ユーザー名/.zprofile
    eval "$(/opt/homebrew/bin/brew shellenv)"
- Run brew help to get started
- Further documentation:
    https://docs.brew.sh

　IntelのCPUが搭載されたモデルでは、このメッセージは表示されません。また、上記のコマンドを入力する必要もありません。

　Homebrewのインストールが完了したら、確認のため、次のコマンドを入力してください。

brew -v

　Homebrewのバージョンが表示されれば、インストールは成功です。

1.1.2　Pythonのインストール

　次は、Homebrewを使ってPythonをインストールします。ターミナルで次のコマンドを入力してください。

brew install python3

　Apple Siliconが搭載されたMacの場合は、パスが通っていない/opt/homebrew/binディレクトリーにPythonがインストールされるので、パスを通す必要があります。それには、次のコマンドを入力してください。

echo 'export PATH="/opt/homebrew/bin:/opt/homebrew/sbin:$PATH"' >> ~/.zprofile

　一方、IntelのCPUが搭載されているモデルでは、すでにパスが通っている/usr/local/binディレクトリーにPythonがインストールされるため、このコマンドを入力する必要はありません。

　Pythonのインストールが完了したら、ターミナルをいったん閉じて開き直してから、次のコマンドを入力してください。

which python3

　Apple Siliconが搭載されたMacの場合、/opt/homebrew/bin/python3と表示されればOKです。IntelのCPUが搭載されたMacの場合、/usr/local/bin/python3と表示されればOKです。

　念のため、バージョンも確認しておきましょう。

python3 -V

　筆者の環境では3.11.6がインストールされていました。これより新しいバージョンがインストールされていても、問題はありません。

1.1.3　VSCodeのインストール

　次は、VSCodeをインストールします。VSCodeは、Microsoftが開発したオープンソースのテキストエディターです。Pythonだけでなく、さまざまな開発の現場で使われている、人気のあるエディターです。ちなみに、本書の執筆もVSCodeで行っています。

　VSCodeのダウンロードページ（次のURL）にアクセスしてください。

　https://code.visualstudio.com/download

　Appleのロゴの下にある、Macと書かれたボタンをクリックすると、Zipファイルのダウンロードが始まります。ダウンロードが完了したら、Zipファイルをダブルクリックして解凍してください。Visual Studio Code.appというアプリケーションができるので、アプリケーションフォルダーに移動してください。

　VSCodeをはじめて起動する際には、「"Visual Studio Code.app"はインターネットからダウンロードされたアプリケーションです。開いてもよろしいですか？」というメッセージが表示されます。このまま「開く」をクリックしてください。

日本語環境の設定

　次は、日本語環境を設定しましょう。左側に並んだアイコンの中からExtensionsをクリックしてください。検索窓にjapaneseと入力すると、Japanese Language Pack for Visual Studio Codeという拡張機能が表示されるので、それをクリックしてください。右側に表示されるInstallボタンをクリックすると、拡張機能がインストールされます。インストールが完了したら、Reloadボタンをクリックしてください。VSCodeが再起動し、メニューが日本語になれば設定完了です。

Python拡張機能のインストール

　次は、Python拡張機能をインストールします。左側に並んだアイコンの中から拡張機能をクリックしてください。先ほどまではExtensionsでしたが、日本語環境を設定したので、拡張機能という表示に変わっているはずです。検索窓にpythonと入力すると、Pythonという拡張機能が表示されるので、それをクリックしてください。右側に表示されるInstallボタンをクリックすると、拡張機能がインストールされます。

ターミナルからVSCodeを起動できるようにする

　メニューから「表示」を選択し、「コマンドパレット」をクリックしてください。コマンドパレットが表示されたら、shellと入力します。Shell Command: Install 'code' command in PATHという項目が表示されるので、それをクリックしてください。

　これで、VSCodeをターミナルからも起動できるようになりました。いったんVSCodeとターミナルを閉じてから、ターミナルで次のコマンドを入力してください。

code .

　VSCodeが起動すれば成功です。

1.1.4　開発用のディレクトリーを作成する

　次は、開発用のディレクトリーを作成します。ターミナルで次のコマンドを入力してください。

cd
mkdir devel

　まず、cdコマンドを実行し、ホームディレクトリーに移動します。次に、develという名前の開発用ディレクトリーを作成します。ディレクトリー名はお好きなものに変更していただいて構いません。それでは、ディレクトリーができたか確認してみましょう。次のコマンドを入力してください。

ls

　develというディレクトリーが表示されればOKです。

1.1.5　サンプルコードのダウンロード

　まず、本書のサポートページ（次のURL）にアクセスしてください。

　https://github.com/sikkimtemi/voice-interactive-chatbot

　右側のCodeという緑色のボタンをクリックして、HTTPSのURLをコピーしてください。

　次に、ターミナルで先ほど作成したdevelディレクトリーに移動しましょう。次のコマンドを入力してください。

cd devel

　次に、サンプルコードをダウンロードするため、git cloneコマンドを入力します。次のコマンドを入力してください。

git clone https://github.com/sikkimtemi/voice-interactive-chatbot.git

　git cloneの後ろには、先ほどコピーしたURLをペーストします。ダウンロードが完了したら、次のコマンドを入力してください。

ls

　voice-interactive-chatbotというディレクトリーが表示されればOKです。次は、VSCodeでダウンロードしたサンプルコードを開きましょう。先ほど設定したので、VSCodeはターミナルから起動できます。次のコマンドを入力してください。

cd voice-interactive-chatbot
code .

　これで、VSCodeが起動し、サンプルコードが表示されます。

1.1.6　venvの設定

　本書では、venvという仮想環境を使って開発を進めます。venvを使うと、プロジェクトごとに環境を分けることができるので、他のプロジェクトに影響を与えることなく開発を進めることができます。voice-interactive-chatbotディレクトリーで、次のコマンドを入力してください。

python3 -m venv venv

　すると、venvというディレクトリーが作成されます。つづいて、次のコマンドを入力してください。

source ./venv/bin/activate

　すると、ターミナルの先頭に(venv)という文字が表示されます。これは、現在venvが有効になっていることを示しています。この状態で、次のコマンドを入力してください。

which python

　/Users/ユーザー名/devel/voice-interactive-chatbot/venv/bin/pythonと表示されればOKです。このように、venvを有効にすると、Pythonの実行ファイルがvenvのディレクトリーに変わります。

　ここで、いったんVSCodeを終了してください。次に、venvが有効になったターミナルからVSCodeを再度起動しましょう。ターミナルから次のコマンドを入力してください。

code .

　VSCodeが起動したら、右下に表示されているPythonの隣りにあるバージョン番号をクリックしてください。「インタープリターの選択」が表示されるので、Python 3.xx.x('venv':venv)を選択してください。最終的に次の図のようになればOKです。なお、Pythonのバージョンは筆者の環境とは異なる可能性があります。

　最後に、必要なライブラリーをインストールしましょう。ターミナルで次のコマンドを入力してください。

cd Chapter1
pip install -r requirements.txt

　これで、開発環境の準備は完了です。

cd Documents

1.2　開発環境の構築（Windows）

　ここでは、Windows 11上でPythonの開発環境を構築する方法を説明します。Macの場合は、前節を参照してください。Pythonの開発環境を構築済みの方は、この節を飛ばしてください。

1.2.1　Pythonのインストール

　Microsoft StoreでPythonを検索してください。画面キャプチャのバージョンは3.10ですが、最新版を選択してインストールしてください。

1.2.2　VSCodeのインストール

　Microsoft StoreでVSCodeを検索し、インストールしてください。

日本語環境の設定

　VSCodeを起動し、左側に並んだアイコンの中から拡張機能（Extensions）をクリックしてください。検索窓に「japanese」と入力し、日本語の拡張機能をインストールしてください。インストールが完了すると、右下に「Change Language and Restart」というボタンが表示されるので、クリックしてください。VSCodeが再起動し、メニューが日本語表示になります。

Python拡張機能のインストール

　拡張機能で「python」と入力し、Python拡張機能をインストールしてください。

1.2.3　Git for Windowsのインストール

　Git for Windowsのサイト（https://gitforwindows.org/）からインストーラーをダウンロードし、インストールしてください。

　インストーラーの設定はすべてデフォルトのままで構いません。

1.2.4　開発用のディレクトリーを作成する

　スタートボタンを右クリックして、「Windowsターミナル」を選択してください。

　次のコマンドを入力して、開発用のディレクトリーを作成してください。ここでは、ディレクトリー名を「devel」としていますが、任意の名前で構いません。

mkdir devel

1.2.5　サンプルコードのダウンロード

　次のコマンドを入力して、サンプルコードをダウンロードしてください。

cd devel
git clone https://github.com/sikkimtemi/voice-interactive-chatbot.git

1.2.6　venvの設定

　ターミナルのタブの右側にあるアイコンをクリックして、コマンドプロンプトを起動してください。デフォルトのPowerShellでは、venvのアクティベートスクリプトを実行するのに手間がかかるため、コマンドプロンプトを使用します。

　コマンドプロンプトで次のコマンドを入力して、venvを設定してください。

cd devel
cd voice-interactive-chatbot
python -m venv venv
cd venv/Scripts
activate.bat

　続いて、次のコマンドを入力して、必要なライブラリーをインストールしてください。

cd ../../Chapter1
pip install -r requirements.txt

1.2.7　VSCodeのインタープリターの設定

　VSCodeが起動していたら、いったん終了し、コマンドプロンプトで次のコマンドを入力してください。

code .

　VSCodeが起動したら、右下のPythonのバージョンを確認してください。3.xx.x('venv':venv)のように表示されていれば、変更の必要はありません。venvの表記がない場合は、Pythonのバージョンをクリックして、「インタープリターの選択」でvenvを選択してください。これで、環境構築は完了です。

1.3　APIキーの準備

　本書のサンプルプログラムを動かすには、OpenAIのAPIキーが必要です。APIキーの取得方法は「はじめに」を参照してください。APIキーを取得したら、次のコマンドを入力して、環境変数に設定してください。

export OPENAI_API_KEY=your-api-key

　your-api-keyは実際のAPIキーで置き換えてください。Windows環境の場合は、コマンドプロンプトでset OPENAI_API_KEY=your-api-keyと入力してください。