https://github.com/gd3kr/blendergpt

Use commands in English to control Blender with OpenAI's GPT-4
https://github.com/gd3kr/blendergpt

Last synced: 1 day ago
JSON representation

Use commands in English to control Blender with OpenAI's GPT-4

• Host: GitHub
• URL: https://github.com/gd3kr/blendergpt
• Owner: gd3kr
• License: mit
• Created: 2023-03-21T13:46:50.000Z (almost 2 years ago)
• Default Branch: main
• Last Pushed: 2024-06-05T08:14:18.000Z (9 months ago)
• Last Synced: 2025-02-19T06:01:57.354Z (1 day ago)
• Language: Python
• Size: 1.87 MB
• Stars: 4,690
• Watchers: 76
• Forks: 361
• Open Issues: 65
• Metadata Files:
  • Readme: README.md
  • License: LICENSE.md

Awesome Lists containing this project

• awesome-ChatGPT-repositories - BlenderGPT - Use commands in English to control Blender with OpenAI's GPT-4 (Openai)

README

        
# BlenderGPT

![Header](https://user-images.githubusercontent.com/63528145/227160213-6862cd5e-b31f-43ea-a5e5-6cc340a95617.png)

Blender can be controlled using program scripts written in Python. Recent Large Language Models like OpenAI's GPT-4 can generate these Python scripts from simple English and execute them. This plugin provides an easy to use interface that integrates OpenAI's GPT-4/GPT-3.5 right in the UI, allowing you to use natural language commands to control Blender.

# Note

Access to GPT-4 in this addon can ONLY be obtained through the OpenAI waitlist (https://openai.com/waitlist/gpt-4-api), which in turn grants your account access to this model via the API.

**GPT-4 access via the API is different from GPT-4 access via ChatGPT-Plus ($20/month subscription). This addon will only work with GPT-4 if you have been accepted into the waitlist (https://openai.com/waitlist/gpt-4-api) and have access to the API via your OpenAI API key**

## Installation

1. Clone this repository by clicking `Code > Download ZIP` on GitHub

2. Open Blender, go to `Edit > Preferences > Add-ons > Install`

3. Select the downloaded ZIP file and click `Install Add-on`

4. Enable the add-on by checking the checkbox next to `GPT-4 Blender Assistant`

5. Paste your OpenAI API key in the Addon preferences menu.

5. To view the code generations in realtime, go to `Window > Toggle System Console`

## Usage

1. In the 3D View, open the sidebar (press `N` if not visible) and locate the `GPT-4 Assistant` tab

2. Type a natural language command in the input field, e.g., "create a cube at the origin"

3. Click the `Execute` button to generate and execute the Blender Python code

## Requirements

- Blender 3.1 or later

- OpenAI API key (Accessible at https://platform.openai.com/account/api-keys)

## Demonstration

https://user-images.githubusercontent.com/63528145/227158577-d92c6e8d-df21-4461-a69b-9e7cde8c8dcf.mov