ホーム › 使い方ガイド › requirements.txt の書き方|Bot に必要なライブラリをサーバーに入れる方法
GUIDE

requirements.txt の書き方|Bot に必要なライブラリをサーバーに入れる方法

手元のパソコンでは動くのに、サーバーに上げたら ModuleNotFoundError で動かない――その原因のほとんどは、必要なライブラリがサーバーに入っていないことです。このページでは、Python の Bot で使うライブラリを一覧にする requirements.txt の書き方と作り方、よくある失敗を説明します。

requirements.txt とは

Bot が使うライブラリの名前を1行に1つずつ書いたテキストファイルです。サーバーはこのファイルを読んで、起動前に必要なライブラリを自動でインストールします。

discord.py
python-dotenv
aiohttp
aiosqlite

ファイル名は必ず requirements.txt(すべて小文字・最後の s を忘れない)にして、main.py と同じフォルダに置きます。

何を書けばいいかの調べ方

コードの先頭の import を見ます。ただし、import の名前とインストールする名前が違うものがあるので注意してください。

import の書き方requirements.txt に書く名前
import discorddiscord.py
from dotenv import load_dotenvpython-dotenv
from PIL import ImagePillow
import yamlPyYAML
from bs4 import BeautifulSoupbeautifulsoup4
import cv2opencv-python-headless

os・json・asyncio・random・datetime・sqlite3 などは Python に最初から入っているので、書く必要はありません。

手元の環境から自動で作る

pip freeze > requirements.txt

今の環境に入っているライブラリがすべて書き出されます。ただし、Bot に関係ないものまで大量に入ることがあるので、書き出したあとに不要な行を消すのがおすすめです。Bot 専用の仮想環境(venv)を作ってから実行すると、余計なものが入りません。

バージョンを指定する

discord.py>=2.3,<3
aiohttp==3.9.5
  • ==:そのバージョンに固定
  • >=:そのバージョン以上
  • <:そのバージョン未満(大きな仕様変更を避ける)

手元で動いているバージョンに合わせておくと、「サーバーだけ新しいバージョンが入って動かない」というトラブルを防げます。

よくある失敗

discord と書いてしまう

discord という名前でも入りますが、古い別物です。必ず discord.py と書きます。

discord.py と py-cord・nextcord を一緒に書いている

これらはどれも import discord で読み込まれるため、同時に入れると壊れます。使うライブラリを1つだけにしてください。

ファイル名が Requirements.txt や requirement.txt になっている

サーバーは大文字と小文字を区別するので、読み込まれません。

ERROR: Could not find a version that satisfies the requirement

名前のつづり間違いか、そのバージョンが存在しない・サーバーの Python に対応していないことが原因です。

音声機能を使う

ボイスチャンネルを使う場合は discord.py[voice] と書きます。

StellaHost での使い方

  1. パネルの「ファイル」で、main.py と同じ場所に requirements.txt をアップロード(または新規作成)します。
  2. サーバーを起動(再起動)すると、起動のたびに自動でライブラリがインストールされます。
  3. コンソールに Successfully installed ... と出ていれば成功です。
ライブラリを追加したら、requirements.txt に1行足して再起動するだけです。コマンドを打つ必要はありません。

まとめ

  • 使うライブラリを1行ずつ requirements.txt に書き、main.py と同じ場所に置く
  • import 名とインストール名が違うもの(discord → discord.py など)に注意
  • 手元と同じバージョンを指定しておくとトラブルが減る

Discord Bot を、月 ¥180 で24時間。

支払い後およそ2分で、日本のサーバーが自動で用意されます。 プランを見る →

ほかのガイド

discord.py の Cog でコマンドをファイルごとに分ける方法discord.py 2.x の Cog を使って、コマンドやイベントを機能ごとのファイルに分ける方法を解説。setup・load_extension・再読み込み・よくあるエラーまで紹介します。読む → discord.py で定期実行する方法|tasks.loop で毎日・毎時の自動投稿discord.py の tasks.loop で、一定間隔・毎日決まった時刻(日本時間)に処理を実行する方法と、開始・停止、エラー時の対処、よくある失敗を解説します。読む → Discord Bot でデータを保存する方法|SQLite でポイント・レベル機能を作る再起動しても消えないデータを、SQLite(aiosqlite)で Discord Bot に保存する方法を解説。ポイント機能・ランキングのサンプルコードと、サーバーでの注意点を紹介します。読む → discord.py でチケット(お問い合わせ)機能を作る方法ボタンを押すと本人とスタッフだけが見える専用チャンネルが作られる、チケット機能の作り方を discord.py のサンプルコード付きで解説します。読む → discord.py で NG ワード削除・スパム対策・タイムアウトを作る方法discord.py で NG ワードを含むメッセージの自動削除、連投スパムの検知、タイムアウトを作る方法と、Discord 標準の AutoMod との使い分けを解説します。読む → Discord Bot のステータス(プレイ中・視聴中)を表示・変更する方法discord.py で Bot の「○○をプレイ中」などのステータスを設定する方法、オンライン状態の変え方、導入サーバー数を表示して定期的に切り替える方法を解説します。読む →