dotenv+venvで始めるGPT開発｜Python×OpenAI API接続の最小構成ログ

作成日：2025-05-15

更新日：2025-05-15

dotenvで
OpenAIを

dotenv？

APIキーを
安全に隠せるの

Step 0. プロジェクトフォルダ作成

VSCodeを開いて
フォルダを作る

remind_bot/

Step 1｜仮想環境（venv）を作成＆有効化

仮想環境を作成する

python3 -m venv .venv

意味と目的

要素	意味
`python3`	Python本体の呼び出し（macOSでは`python`ではなく`python3`が多い）
`-m`	Pythonが標準で持ってるモジュール（`venv`）を直接実行してね！というお願い
`venv`	Pythonに標準搭載されてる「仮想環境（Virtual Environment）」作成モジュール
`.venv`	作りたい仮想環境の名前（=作成されるフォルダ名）

仮想環境とは

「このプロジェクトだけで使う専用のPython（とpip）」をつくる仕組み
activateで仮想環境に入る
仮想環境に入るほうが、わかりやすくなる

-m とは？

「Pythonが標準で持ってるモジュール」を直接実行する
-m で、Python内蔵のWebサーバーが起動する

`.venv` という名前にする理由

.venv/ は慣例的に「このフォルダは仮想環境だよ〜」という意味
VSCode や他のツールが自動で認識してくれるから、拡張機能との連携もスムーズになる
myenv や env_py3 でもいい。ただ、.venv が一番スマート＆見慣れてる

仮想環境を有効化（activate）する

source .venv/bin/activate

意味

仮想環境のPythonを使えるようにする
ターミナルが (.venv) 表記になればOK！

Step 2｜必要なパッケージ（python-dotenv）のインストール

pipでインストールする

pip install openai

意味

パッケージ	用途
`openai`	GPTと通信するための公式ライブラリ
`python-dotenv`	`.env` ファイルからAPIキーなどを読み込むためのライブラリ

Step 3｜`.env` ファイル（秘密の引き出し）の作成

`.env` をプロジェクトルート直下に作成する

APIキーは大切なものだから
.env に書いて隠す

OPENAI_API_KEY=sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

.env とは？

「APIキーを安全にコード外に保管する」ための専用ファイル
これを dotenv で読み込んで、os.getenv("OPENAI_API_KEY") で取り出す

Step 4｜GPT疎通用のPythonファイルを作成

`gpt_helper.py` を作ってコードを書く

import os
from openai import OpenAI
from dotenv import load_dotenv

load_dotenv()  # .envファイルを読み込む
client = OpenAI(api_key=os.getenv("OPENAI_API_KEY"))  # キーをセット

def test_gpt_connection():
    response = client.chat.completions.create(
        model="gpt-3.5-turbo",
        messages=[{"role": "user", "content": "Hello, GPT!"}]
    )
    print(response.choices[0].message.content)

if __name__ == "__main__":
    test_gpt_connection()

`dotenv`（ドットエヌブイ）とは？

.env に書かれた設定値（環境変数）を、Pythonプログラムから安全に読み取る
秘密の引き出し

使う理由	説明
秘密を隠せる	APIキーやパスワードなどをソースコードに直書きせずに済む
共有しやすい	`.env` はGitに含めず、他の人とコードを安全に共有できる
設定の切り替えが楽	環境ごとに`.env.dev`, `.env.prod` と分けて管理できる

`if name == "main":` とは

「このファイルを直接実行したときだけ、この下の処理を動かしてね！」

Pythonには「2つの実行モード」がある

状態	`__name__` の中身	例
直接実行	`"__main__"`	`python gpt_helper.py`
他ファイルからimport	`"gpt_helper"`	`import gpt_helper`

if name == “main“: を書くと…

他のファイルからインポートされたときは動かない（←ここ重要）

Step 5｜実行してAPI疎通確認

python を叩く

python gpt_helper.py

こんな返事がくる

Hello! How can I assist you today?

意味

gpt_helper.py の中で GPT に「Hello, GPT!」を送ってみる
応答が返ってきたら、API接続成功

ここまでのフォルダ構成

remind_bot/
├── .venv/              # 仮想環境
├── .env                # APIキー（安全な設定ファイル）
├── gpt_helper.py       # GPT接続テストスクリプト

dotenvを使わずに
簡単に書くこともできる
でもAPIキーを隠すならdotenvがいい

CLICK

生成AI｜Pythonでリクエストしてみよう［OpenAI APIとLangChain］

author
月うさぎ

2025-05-15

編集後記：
この記事の内容がベストではないかもしれません。