Tornado のインストール，公式ページのプログラム実行（Windows 上）

【概要】

Windows での，Tornado のインストール手順を説明する．Tornado は Python の Web フレームワークであり，非同期ネットワークライブラリでもある．ノンブロッキング I/O（入出力の完了を待たずに他の処理を進める方式）を用いることで，多数の接続を保ったまま動作できる．

ユースケース：Python で手軽に Web サーバを使いたい場合

公式ドキュメントによれば，Tornado は Unix 系のプラットフォームを想定して設計されている．Windows でも動作するが，公式のサポート対象ではなく，本番運用には推奨されていない．マルチプロセスモードなど一部の機能は Windows では利用できない．学習や動作確認の用途では問題なく使用できる．

先人に感謝．

【目次】

1. 前準備
2. Tornado のインストール手順（Windows 上）
3. 公式ページのプログラムを動かしてみる

【関連する外部ページ】

Tornado 公式ページ：https://www.tornadoweb.org/
Tornado のソースコード（GitHub）：https://github.com/tornadoweb/tornado
Tornado の PyPI ページ：https://pypi.org/project/tornado/

【サイト内の関連情報】

Python の使い方：別ページ »で説明
git の使い方：別ページ »で説明

1. 前準備

Python 3.12 のインストール

Pythonのインストールを行い、Pythonのプログラムを実行する環境を整える。扱う環境は、Windows搭載パソコンである。金子研究室では、Python 3.12.10を推奨する。

[Windows での Python 3.12 のインストール手順を見るには、ここをクリック]

Windows での Python 3.12 のインストール

以下のいずれかの方法でPython 3.12をインストールする。Pythonがインストール済みの場合、この手順は不要である。

方法 1：winget によるインストール

【インストールコマンドの実行方法】

管理者権限でコマンドプロンプトを起動する（手順：Windowsキーまたはスタートメニュー → cmd と入力 → 右クリック → 「管理者として実行」）。そして、コマンド全体をコマンドプロンプトにコピー＆ペーストする。

--scope machine を指定することで、システム全体（全ユーザー向け）にインストールされる。このオプションの実行には管理者権限が必要である。インストール完了後、コマンドプロンプトを再起動するとPATHが反映される。

REM Python 3.12 をシステム領域にインストール
winget install --id Python.Python.3.12 -e --scope machine --silent --accept-source-agreements --accept-package-agreements --override "/quiet InstallAllUsers=1 PrependPath=1 Include_test=0 Include_pip=1 Include_launcher=1 InstallLauncherAllUsers=1 TargetDir=\"C:\Program Files\Python312\""

REM Python と Scripts を PATH 先頭に追加
powershell -NoProfile -Command "$p='C:\Program Files\Python312'; $s=\"$p\Scripts\"; $c=[Environment]::GetEnvironmentVariable('Path','Machine'); if((Test-Path $p) -and (';'+$c+';' -notlike \"*;$p;*\") -and (';'+$c+';' -notlike \"*;$s;*\")){[Environment]::SetEnvironmentVariable('Path',\"$p;$s;$c\",'Machine')}"

方法 2：インストーラーによるインストール

Python公式サイト（https://www.python.org/downloads/）にアクセスし、「Download Python 3.x.x」ボタンからWindows用インストーラーをダウンロードする。
ダウンロードしたインストーラーを実行する。
初期画面の下部に表示される「Add python.exe to PATH」にチェックを入れてから「Customize installation」を選択する。このチェックを入れ忘れると、コマンドプロンプトから python コマンドを実行できない。
「Install Python 3.xx for all users」にチェックを入れ、「Install」をクリックする。

インストールの確認

コマンドプロンプトで以下を実行する。

python --version

バージョン番号（例：Python 3.12.x）が表示されればインストール成功である。「'python' は、内部コマンドまたは外部コマンドとして認識されていません。」と表示される場合は、インストールが正常に完了していない。

Tornado 6.5 の動作には Python 3.9 以上が必要である。このページでは Python 3.12 を用いる。

Git のインストール（Windows 上） [クリックして展開]

管理者権限でコマンドプロンプトを起動する（手順：Windowsキーまたはスタートメニュー → cmd と入力 → 右クリック → 「管理者として実行」）。

管理者権限は，winget の --scope machine オプションでシステム全体にインストールするために必要となる。次のコマンドを実行する。

REM Git をシステム領域にインストール
winget install --scope machine --id Git.Git -e --silent --disable-interactivity --force --accept-source-agreements --accept-package-agreements --override "/VERYSILENT /NORESTART /NOCANCEL /SP- /CLOSEAPPLICATIONS /RESTARTAPPLICATIONS /COMPONENTS=""icons,ext\reg\shellhere,assoc,assoc_sh"" /o:PathOption=Cmd /o:CRLFOption=CRLFCommitAsIs /o:BashTerminalOption=MinTTY /o:DefaultBranchOption=main /o:EditorOption=VIM /o:SSHOption=OpenSSH /o:UseCredentialManager=Enabled /o:PerformanceTweaksFSCache=Enabled /o:EnableSymlinks=Disabled /o:EnableFSMonitor=Disabled"

2. Tornado のインストール手順（Windows 上）

管理者権限でコマンドプロンプトを起動する（手順：Windowsキーまたはスタートメニュー → cmd と入力 → 右クリック → 「管理者として実行」）。

以下の手順は，このコマンドプロンプトで実行する．
使用する Python のバージョンの確認
```
python --version
```

pip と setuptools の更新

python -m pip install -U --no-user pip setuptools

パッケージのインストール

python -m pip install -U --no-user tornado

ソースコードからビルドしてインストールしたい場合の手順例

mkdir c:\pytools
cd c:\pytools
rmdir /s /q tornado
git clone https://github.com/tornadoweb/tornado
cd c:\pytools\tornado
python -m pip install -U --no-user .

Tornado のバージョンの確認
```
python -c "import tornado; print(tornado.version)"
```
バージョン番号が表示されれば OK．2026年7月時点の最新版は 6.5.7 である。本ページの図とは違うバージョンが表示されることがある．

3. 公式ページのプログラムを動かしてみる

Tornado がインストールできたかを確認したい．

Tornado 公式ページに掲載されている「Hello, world」の Python プログラムを実行する．このプログラムは，ポート 8888 で待ち受ける Web サーバを起動し，どのような要求に対しても「Hello, world」と応答する．

import asyncio
import tornado

class MainHandler(tornado.web.RequestHandler):
    def get(self):
        self.write("Hello, world")

def make_app():
    return tornado.web.Application([
        (r"/", MainHandler),
    ])

async def main():
    app = make_app()
    app.listen(8888)
    await asyncio.Event().wait()

if __name__ == "__main__":
    asyncio.run(main())

確認のため，Webブラウザで http://localhost:8888 を開く
「Hello, world」と表示されれば OK．
確認が済んだら，プログラムを実行しているコマンドプロンプトで Ctrl キーを押しながら C キーを押し，Web サーバを終了する