Last updated: Apr 9, 2024
Reading timeยท14 min
The Python "ModuleNotFoundError: No module named 'discord'" occurs when we
forget to install the discord.py
module before importing it or install it in
an incorrect environment.
To solve the error, install the module by running the pip install discord.py
command.
Open your terminal in your project's root directory and install the discord.py module.
# ๐๏ธ In a virtual environment or using Python 2 pip install discord.py # ๐๏ธ For Python 3 (could also be pip3.10 depending on your version) pip3 install discord.py # ๐๏ธ If you get a permissions error sudo pip3 install discord.py pip install discord.py --user # ๐๏ธ If you don't have pip in your PATH environment variable python -m pip install discord.py # ๐๏ธ For Python 3 (could also be pip3.10 depending on your version) python3 -m pip install discord.py # ๐๏ธ Using py alias (Windows) py -m pip install discord.py # ๐๏ธ For Anaconda conda install -c conda-forge discord.py # ๐๏ธ For Jupyter Notebook !pip install discord.py
If you need to get voice support, use discord.py[voice]
instead of
discord.py
.
pip install "discord.py[voice]" # ๐๏ธ For Python 3 (could also be pip3.10 depending on your version) pip3 install "discord.py[voice]" # ๐๏ธ If you get a permissions error sudo pip3 install "discord.py[voice]" # ๐๏ธ If you don't have pip in your PATH environment variable python -m pip install "discord.py[voice]" # ๐๏ธ For Python 3 (could also be pip3.10 depending on your version) python3 -m pip install "discord.py[voice]" # ๐๏ธ Using py alias (Windows) py -m pip install "discord.py[voice]"
If you are on Linux, you have to install the prerequisites before installing
discord.py[voice]
.
sudo apt install libffi-dev libnacl-dev python3-dev
The error occurs for multiple reasons:
pip install discord.py
.discord.py
which would shadow the official module.discord
which would shadow the imported
variable.If the error persists, get your Python version and make sure you are installing the package using the correct Python version.
python --version
For example, my Python version is 3.10.4
, so I would install the discord.py
package with pip3.10 install discord.py
.
pip3.10 install discord.py # ๐๏ธ If you get a permissions error use pip3 (NOT pip3.X) sudo pip3 install discord.py
Notice that the version number corresponds to the version of pip
I'm using.
If the PATH for pip
is not set up on your machine, replace pip
with
python3 -m pip
:
# ๐๏ธ Make sure to use your version of Python, e.g. 3.10 python3 -m pip install discord.py
If the error persists, try restarting your IDE and development server/script.
You can
check if you have the discord.py
package installed
by running the pip show discord.py
command.
# ๐๏ธ Check if you have discord.py installed pip show discord.py # ๐๏ธ If you don't have pip set up in PATH python -m pip show discord.py
The pip show discord.py
command will either state that the package is not
installed or show a bunch of information about the package, including the
location where the package is installed.
If the package is not installed, make sure your IDE is using the correct version of Python.
discord.py
package using the incorrect version or your IDE might be set up to use a different version.For example, In VSCode, you can press CTRL + Shift + P
or (โ
+ Shift
+ P
on Mac) to open the command palette.
Then type "Python select interpreter" in the field.
Then Select the correct Python version from the dropdown menu.
If you are using a virtual environment, make sure you are installing
discord.py
in your virtual environment and not globally.
You can try creating a virtual environment if you don't already have one.
# ๐๏ธ Use the correct version of Python when creating VENV python3 -m venv venv # ๐๏ธ Activate on Unix or MacOS source venv/bin/activate # ๐๏ธ Activate on Windows (cmd.exe) venv\Scripts\activate.bat # ๐๏ธ Activate on Windows (PowerShell) venv\Scripts\Activate.ps1 # ๐๏ธ Install discord.py in your virtual environment pip install discord.py
If the python3 -m venv venv
command doesn't work, try the following 2
commands:
python -m venv venv
py -m venv venv
Your virtual environment will use the version of Python that was used to create it.
discord.py
because that would shadow the original discord.py
module.You also shouldn't be declaring a variable named discord
as that would also
shadow the original module.
If the error is not resolved, try to uninstall the discord.py
package and then
reinstall it.
# ๐๏ธ Check if you have discord.py installed pip show discord.py # ๐๏ธ If you don't have pip set up in PATH python -m pip show discord.py # ๐๏ธ Uninstall discord.py pip uninstall discord.py # ๐๏ธ If you don't have pip set up in PATH python -m pip uninstall discord.py # ๐๏ธ Install discord.py pip install discord.py # ๐๏ธ If you don't have pip set up in PATH python -m pip install discord.py
Try restarting your IDE and development server/script.
You can also try to upgrade the version of the discord.py
package.
pip install discord.py --upgrade # ๐๏ธ If you don't have pip set up in PATH python -m pip install discord.py --upgrade
The error "Import "discord" could not be resolved from source Pylance" occurs
when the discord.py
module is not installed or you have selected the incorrect
Python interpreter in your IDE (e.g. Visual Studio Code).
To solve the error, install discord.py
and select the correct Python
interpreter in your IDE.
Import "discord" could not be resolved from source Pylance(reportMissingModuleSource) [Ln 1, Col 8]
If you have multiple Python versions installed on your machine, you might have
installed the discord.py
package using the incorrect version or your IDE might
be set up to use a different version.
For example, In Visual Studio Code you can:
CTRL + Shift + P
or (โ
+ Shift
+ P
on macOS) to open the
command palette.Then type "Python select interpreter" in the search field.
If the error persists, try restarting your IDE and development server/script. VSCode often glitches and a reboot resolves the issue.
If the error is not resolved, try to use the Visual Studio Code terminal to
install the discord.py
module.
You can press CTRL + ` (Backtick) on your keyboard to open the Visual Studio code terminal.
CTRL+Shift+P
and then type "View: Toggle Terminal".Once you open the terminal, Visual Studio Code will automatically activate your virtual environment (if you have one).
Run the pip install discord.py
command.
pip install discord.py
If the error persists, try to select the Python interpreter by specifying the path:
CTRL + Shift + P
or (โ
+ Shift
+ P
on Mac) to open the command
palette.venv
folder,
then double-click on the Scripts
folder, select the python.exe
file and
then Select interpreter.venv
folder, then double-click on the bin
folder, select the python
file and
then Select interpreter.python.exe
or python
executable, specify the path to
the file and select the executable.where python python -c "import sys; print(sys.executable)"
If the error persists, try restarting your IDE and development server/script.
If none of the suggestions helped, you can use a comment to disable the Pylance warning in your IDE.
import discord # type: ignore print(discord)
You simply have to add the # type: ignore
command on the same line as the
import statement to disable the check for the specific import.
To install the discord.py
module on Windows:
pip install discord.py
and press Enter.pip install discord.py # ๐๏ธ For Python 3 pip3 install discord.py # ๐๏ธ If you don't have pip in your PATH environment variable python -m pip install discord.py # ๐๏ธ For Python 3 python3 -m pip install discord.py # ๐๏ธ Using py alias py -m pip install discord.py # ๐๏ธ If you get a permissions error pip install discord.py --user # ๐๏ธ For Anaconda conda install -c conda-forge discord.py
If you need to get voice support, use discord.py[voice]
instead of
discord.py
.
pip install "discord.py[voice]" pip3 install "discord.py[voice]" python -m pip install "discord.py[voice]" python3 -m pip install "discord.py[voice]" py -m pip install "discord.py[voice]" pip install "discord.py[voice]" --user
If the installation command doesn't succeed, try running CMD as an administrator.
If you get the error
'pip' is not recognized as an internal or external command,
use the python -m
command when installing discord.py
.
python -m pip install discord.py python3 -m pip install discord.py py -m pip install discord.py
Alternatively, you can install the discord.py
module in a virtual environment:
Shift
and right-click in Explorer.# ๐๏ธ Might also be: "python3 -m venv venv" python -m venv venv # ๐๏ธ Activate on Windows (PowerShell) venv\Scripts\Activate.ps1 # ๐๏ธ Activate on Windows (cmd.exe) venv\Scripts\activate.bat # ๐๏ธ Install discord.py in your virtual environment pip install discord.py
If the python -m venv venv
command doesn't work, try the following 2 commands:
python3 -m venv venv
py -m venv venv
.If you see an error message that ps1 cannot be loaded because running scripts is disabled on this system, run the following command, type "yes" when prompted and rerun the activation command.
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
discord.py
module is installed by using the pip show discord.py
command.pip show discord.py pip3 show discord.py python -m pip show discord.py python3 -m pip show discord.py
The pip show discord.py
command will either state that the package is not
installed or show a bunch of information about the package, including the
location where the package is installed.
To install discord.py on macOS or Linux:
pip install discord.py
and press Enter.pip install discord.py # ๐๏ธ For Python 3 pip3 install discord.py # ๐๏ธ If you get a permissions error sudo pip3 install discord.py # ๐๏ธ If you don't have pip in your PATH environment variable python -m pip install discord.py # ๐๏ธ For Python 3 python3 -m pip install discord.py # ๐๏ธ Alternative if you get a permissions error pip install discord.py --user # ๐๏ธ For Anaconda conda install -c conda-forge discord.py
If you need to get voice support, use discord.py[voice]
instead of
discord.py
.
pip install "discord.py[voice]" pip3 install "discord.py[voice]" sudo pip3 install "discord.py[voice]" pip install "discord.py[voice]" --user python -m pip install "discord.py[voice]" python3 -m pip install "discord.py[voice]"
If you are on Linux, you have to install the prerequisites before installing
discord.py[voice]
.
sudo apt install libffi-dev libnacl-dev python3-dev
If you get an error that pip
isn't found, use the python -m
command.
python -m pip install discord.py python3 -m pip install discord.py
If you get a permissions error, prefix the command with sudo
.
sudo pip install discord.py sudo pip3 install discord.py
Alternatively, you can install the discord.py
package in a virtual
environment:
# ๐๏ธ Could also be "python -m venv venv" python3 -m venv venv # ๐๏ธ Activate virtual env on macOS or Linux source venv/bin/activate # ๐๏ธ Install discord.py in your virtual environment pip install discord.py
Your virtual environment will use the version of Python that was used to create it.
python3 -m venv venv
command doesn't work, use python -m venv venv
instead.You can use the pip show
command to verify
discord.py
has been installed
successfully.
pip show discord.py pip3 show discord.py python -m pip show discord.py python3 -m pip show discord.py
The pip show discord.py
command will either state that the package is not
installed or show a bunch of information about the package.
To install discord.py in Visual Studio Code:
pip install discord.py
command to install the discord.py
module.pip install discord.py # ๐๏ธ For Python 3 pip3 install discord.py # ๐๏ธ If you get a permissions error sudo pip3 install discord.py # ๐๏ธ If you don't have pip in your PATH environment variable python -m pip install discord.py # ๐๏ธ For Python 3 python3 -m pip install discord.py # ๐๏ธ Using py alias py -m pip install discord.py # ๐๏ธ Alternative if you get a permissions error pip install discord.py --user
CTRL+Shift+P
and then type "View: Toggle Terminal".If you need to get voice support, use discord.py[voice]
instead of
discord.py
.
pip install "discord.py[voice]" pip3 install "discord.py[voice]" sudo pip3 install "discord.py[voice]" pip install "discord.py[voice]" --user python -m pip install "discord.py[voice]" python3 -m pip install "discord.py[voice]" py -m pip install "discord.py[voice]"
If you are on Linux, you have to install the prerequisites before installing
discord.py[voice]
.
sudo apt install libffi-dev libnacl-dev python3-dev
When installing Python modules in Visual Studio code, make sure that your IDE is configured to use the correct Python version.
Press CTRL+Shift+P
or (โ
+ Shift
+ P
on Mac) to open the command
palette.
Then type "Python select interpreter" in the field.
Then Select the correct Python version from the dropdown menu.
You can use the python --version
command if you need to get your version of
Python.
python --version python3 --version
You can also try creating a virtual environment if you don't already have one.
# ๐๏ธ Could also be "python -m venv venv" or "py -m venv venv" python3 -m venv venv # ๐๏ธ Activate on Unix or MacOS source venv/bin/activate # ๐๏ธ Activate on Windows (cmd.exe) venv\Scripts\activate.bat # ๐๏ธ Activate on Windows (PowerShell) venv\Scripts\Activate.ps1 # ๐๏ธ Install discord.py in your virtual environment pip install discord.py
Your virtual environment will use the version of Python that was used to create it.
To install discord.py in PyCharm:
Alt+F12
on your keyboard to open the terminal.pip install discord.py
command to install the discord.py
module.pip install discord.py # ๐๏ธ For Python 3 pip3 install discord.py # ๐๏ธ If you get a permissions error sudo pip3 install discord.py # ๐๏ธ If you don't have pip in your PATH environment variable python -m pip install discord.py # ๐๏ธ For Python 3 python3 -m pip install discord.py # ๐๏ธ Using py alias py -m pip install discord.py # ๐๏ธ Alternative if you get a permissions error pip install discord.py --user
If you need to get voice support, use discord.py[voice]
instead of
discord.py
.
pip install "discord.py[voice]" pip3 install "discord.py[voice]" sudo pip3 install "discord.py[voice]" pip install "discord.py[voice]" --user python -m pip install "discord.py[voice]" python3 -m pip install "discord.py[voice]" py -m pip install "discord.py[voice]"
If you are on Linux, you have to install the prerequisites before installing
discord.py[voice]
.
sudo apt install libffi-dev libnacl-dev python3-dev
Alternatively, you can use the IDE itself to install the module.
+
icon and type discord.py
.Click on "File" > "Settings" > "Project" > "Python Interpreter".
Then Select the correct Python version from the dropdown menu.
You can use the python --version
command if you need to get your version of
Python.
python --version python3 --version
You can install the discord.py
package with a command.
If you are on Windows, search for "Anaconda Prompt" and open the application.
If you are on macOS or Linux, open your terminal.
Run the following command to install the discord.py
package.
# ๐๏ธ Using conda conda install -c conda-forge discord.py # ๐๏ธ Alternatively use `pip` pip install discord.py # ๐๏ธ For Python 3 pip3 install discord.py # ๐๏ธ If you get a permissions error sudo pip3 install discord.py # ๐๏ธ If you don't have pip in your PATH environment variable python -m pip install discord.py # ๐๏ธ For Python 3 python3 -m pip install discord.py # ๐๏ธ Using py alias py -m pip install discord.py # ๐๏ธ Alternative if you get a permissions error pip install discord.py --user
If you need to get voice support, use discord.py[voice]
instead of
discord.py
.
pip install "discord.py[voice]" pip3 install "discord.py[voice]" sudo pip3 install "discord.py[voice]" pip install "discord.py[voice]" --user python -m pip install "discord.py[voice]" python3 -m pip install "discord.py[voice]" py -m pip install "discord.py[voice]"
If you are on Linux, you have to install the prerequisites before installing
discord.py[voice]
.
sudo apt install libffi-dev libnacl-dev python3-dev
Click on the following article if you need to install a specific version of the package using Anaconda.
To install discord.py in Jupyter Notebook:
pip install discord.py
and press Enter.# ๐๏ธ Using pip pip install discord.py # ๐๏ธ For Python 3 pip3 install discord.py # ๐๏ธ If you get a permissions error sudo pip3 install discord.py # ๐๏ธ If you don't have pip in your PATH environment variable python -m pip install discord.py # ๐๏ธ For Python 3 python3 -m pip install discord.py # ๐๏ธ Using py alias py -m pip install discord.py # ๐๏ธ Using conda conda install -c conda-forge discord.py # ๐๏ธ Alternative if you get a permissions error pip install discord.py --user
If you need to get voice support, use discord.py[voice]
instead of
discord.py
.
pip install "discord.py[voice]" pip3 install "discord.py[voice]" sudo pip3 install "discord.py[voice]" pip install "discord.py[voice]" --user python -m pip install "discord.py[voice]" python3 -m pip install "discord.py[voice]" py -m pip install "discord.py[voice]"
If you are on Linux, you have to install the prerequisites before installing
discord.py[voice]
.
sudo apt install libffi-dev libnacl-dev python3-dev
Alternatively, you can use the Python ipykernel.
Click on "New" and then click on "Python 3 (ipykernel)".
Type !pip install discord.py
and click on "Run".
Note that the pip install
command must be prefixed with an exclamation mark if
you use this approach.
!pip install discord.py
Once you type the command, click "Run" to install the discord.py
module.
If you get a permissions error, e.g. "[WinError: 5] Access is denied", add the
--user
option to the installation command.
!pip install discord.py --user
If the error persists, try to restart the Jupyter Kernel and rerun the command.