Python開発環境

Last updated on July 14, 2026

注釈：本資料はAI技術を用いて翻訳されています。

Overview

このガイドでは、新しいPythonプロジェクトを開始するためのシンプルで一貫した方法を説明します。ここでは、Pythonのインストール、パッケージマネージャーの選択、ローカルまたはDockerでのコードの実行について取り上げます。

Setup

1. Pythonをインストールする

Linux

sudo apt update
sudo apt install python3

macOS

brew install python

Windows (WSL2)

sudo apt update
sudo apt install python3

2. パッケージマネージャーを選択する

uvは、Pythonパッケージと仮想環境の両方を1つのツールで管理する、pip + venvに代わるモダンで高速な選択肢です。pip + venvは、ほとんどのPythonインストールに含まれている、長年標準とされてきたPythonツールチェーンです。どちらも完全にサポートされているため、好みに応じて選択してください。

uv

uvは、1つの高速なコマンドでPythonパッケージと仮想環境を管理します。

uvをインストールする。

Linux / Windows (WSL2)

curl -LsSf https://astral.sh/uv/install.sh | sh

macOS

curl -LsSf https://astral.sh/uv/install.sh | sh

Windows (native)

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

プロジェクトディレクトリを作成する

mkdir my_project && cd my_project

pyproject.tomlファイルを追加する

プロジェクトと依存関係を宣言するpyproject.tomlを作成します。

[project]
name = "my-project"
version = "0.1.0"
requires-python = ">=3.10"
dependencies = [
    "accelbyte-py-sdk",
    "bitarray",
    "httpx[http2]",
    "mmh3",
    "PyJWT[crypto]",
    "PyYAML",
    "requests",
    "websockets",
]

依存関係をインストールします（uvが.venvを自動的に作成・管理します）。

uv sync

コードを書いて実行する

mkdir src

cat <<EOF > src/app.py
import accelbyte_py_sdk

print(accelbyte_py_sdk.get_version(latest=True, full=True))
EOF

uv run python src/app.py

Dockerで実行する（任意）

FROM python:3.10-slim

WORKDIR /app

COPY pyproject.toml uv.lock ./
RUN --mount=from=ghcr.io/astral-sh/uv:latest,source=/uv,target=/uv \
    UV_PROJECT_ENVIRONMENT=/usr/local /uv sync --frozen --no-dev --no-install-project
COPY src/ .

CMD ["python", "app.py"]

docker build -t my-app . && docker run --rm my-app

pip + venv

pipとvenvは、ほとんどのPythonインストールに含まれている従来型のPythonパッケージングツールです。

Linux / WSL2では、未インストールの場合は次のコマンドでインストールします。

sudo apt install python3-pip python3-venv

プロジェクトディレクトリと仮想環境を作成する

mkdir my_project && cd my_project
python3 -m venv .venv
source .venv/bin/activate

requirements.txtファイルを追加する

依存関係を記載したrequirements.txtを作成します。

cat <<EOF > requirements.txt
accelbyte-py-sdk
bitarray
httpx[http2]
mmh3
PyJWT[crypto]
PyYAML
requests
websockets
EOF

依存関係をインストールします。

pip install -r requirements.txt

mkdir src

cat <<EOF > src/app.py
import accelbyte_py_sdk

print(accelbyte_py_sdk.get_version(latest=True, full=True))
EOF

python src/app.py

Dockerで実行する（任意、pip + venv）

FROM python:3.10-slim

WORKDIR /app

COPY requirements.txt .
RUN pip install -r requirements.txt
COPY src/ .

CMD ["python", "src/app.py"]

docker build -t my-app . && docker run --rm my-app