Create a Blender project

The Blender project generator creates a Python project with Blender-specific metadata, dependencies, and source files.

Create the project

1. Open PyCharm’s New Project wizard and select Blender project.
2. Choose an Add-on or Extension project.
3. Enter the author, version, Blender target, license, and description.
4. Select the Python environment. UV is recommended because planned integration work is focused on UV.
5. For an extension, review the add-on ID, compatibility range, tags, website, and permission reasons under Advanced Settings.
6. Choose whether to install Blender API linting stubs, initialize Git, and include example code.
7. Create the project.

The add-on ID must be a valid Python module name. The plugin generates an ID from the project name and warns when an entered ID is invalid. Website fields require an https:// URL, and the maximum Blender version cannot be lower than the minimum.

Generated files

Every project receives a src source root, src/__init__.py, pyproject.toml, and GPL LICENSE. When Git is initialized, the generator also creates .gitignore and README.md.

Extension projects additionally receive blender_manifest.toml containing the metadata and permissions entered in the wizard.

Blender API stubs

The optional stub installer adds the version-matched fake-bpy-module package to the selected interpreter and records it in the dev dependency group in pyproject.toml.

Blender target	Stub requirement
4.2	fake-bpy-module-4.2
4.5	fake-bpy-module-4.5
5.2	fake-bpy-module-latest

Unknown Blender releases do not replace working stubs with an inferred rolling package.

After creating the project, configure and launch Blender.