Gemini AI Assistant for Blender

An open-source Blender add-on that integrates Google's Gemini AI directly into the 3D Viewport. This tool allows you to control Blender using natural language, generate complex Python scripts on the fly, and maintain a conversation history for iterative modeling.

Features

• Natural Language to Code: Generate objects, materials, and animations just by describing them.
• Chat History: The AI remembers previous commands, enabling follow-up instructions (e.g., "Create a cube" -> "Now move it up").
• Integrated UI: Access everything from the Blender Sidebar (N-panel).
• Secure API Management: Your API key is stored locally in your Blender preferences, not in the script.

Installation

1. Download the script: Save the blender_gemini_ai.py file from this repository.
2. Open Blender: Go to Edit > Preferences > Add-ons.
3. Install: Click the Install... button and select the downloaded .py file.
4. Enable: Find "Gemini AI Assistant" in the list and check the box to enable it.
5. Set API Key:
   • Expand the add-on details in the Preferences window.
   • Paste your Gemini API Key into the designated field.

How to get an API Key

1. Go to Google AI Studio.
2. Click on "Get API key".
3. Create a new API key in a new project.
4. Copy the key and paste it into the Blender Add-on preferences.

How to Use

1. Open the 3D Viewport.
2. Press N to open the Sidebar and look for the Gemini AI tab.
3. Type a command in the input box (e.g., "Create a procedural landscape with 50 random rocks").
4. Click Run Command.
5. Use Clear History if you want to start a fresh session without previous context.

Important Note

This add-on executes Python code generated by an AI. Always review the generated code in the console if you are working on sensitive projects.

License

This project is licensed under the MIT License - feel free to use, modify, and distribute it.

---

Created by Boris Evtimov