I cannot install bpy using pip

Question

I'm trying to install bpy using pip install bpy. According to their website: https://pypi.org/project/bpy/, version 4.3.0 is the latest (and was released in November 2024). Is there any way of using bpy without reverting to python 3.7?

PS C:\Users\usr> pip install bpy
ERROR: Ignored the following versions that require a different python version: 2.82.1 Requires-Python >=3.7, <3.8
ERROR: Could not find a version that satisfies the requirement bpy (from versions: none)
ERROR: No matching distribution found for bpy

Edit Feb 15 2025: I am using python 3.12.6

Answer 1

Blender is already using Python, so you don't need to install the bpy module separately. You can, but you have to build your own, and it is very complicated and locked to Blender's internal python version.

This is how you run your own Python scripts using Blenders interpreter.

Here we assume your Blender Python script is called: my_script.py. And that your last saved Blender settings is called: myscript.blend

Then open a Powershell in Windows Terminal, and type:

# IF you don't have a settings *.blend file, just use:
& "C:\Program Files\Blender Foundation\Blender 4.5\blender.exe" -P "C:\path\to\my_script.py" -E BLENDER_EEVEE_NEXT -y -d

# IF you already have a *.blend settings file, you can load that too. 
& "C:\Program Files\Blender Foundation\Blender 4.5\blender.exe" myscript.blend -P "C:\path\to\my_script.py" -E BLENDER_EEVEE_NEXT -y -d

Here the blender.exe CLI options are:

• -P for path to your script.
• -E for selecting a rendering engine. (See blender.exe -E help)
• -y to enable automatic Python script execution.
• -d to enable basic debug info.

References:

• https://pypi.org/project/bpy/4.5.0/
• https://developer.blender.org/docs/handbook/building_blender/options/
• https://developer.blender.org/docs/handbook/tooling/
• https://developer.blender.org/docs/handbook/building_blender/python_module/
• https://docs.blender.org/api/3.4/info_advanced_blender_as_bpy.html
• https://docs.blender.org/api/current/info_tips_and_tricks.html
• https://docs.blender.org/api/current/index.html

Answer 2

The Requirements of bpy as seen on PyPI states:

Each Blender release supports one Python version, and the package is only compatible with that version.

bpy 4.3.0 only has Python 3.11 wheels for all major platforms but your error message somehow suggests that you're either trying to use an incompatible Python version for the stable release or you tried to get bpy 2.82.1 which is only compatible with Python 3.7 on Windows.

Answer 3

What is your current version of Python? Because bpy suggests requiring version 3.11.

To use bpy without reverting to Python 3.7, you should install Python 3.11:

1. Download and install Python 3.11.
2. python3.11 -m pip install --upgrade pip
3. python3.11 -m pip install bpy