Wiro AI Open Source

Wiro AI open source / Creative and design tools

Wiro-Blender

Wiro AI add-on for Blender: text to 3D, image to 3D, textures and any of the 1,000+ Wiro AI models, with live model lists, a job queue and history.

View on GitHub Website

Wiro AI

Wiro AI 3D Generator for Blender

Text to 3D, image to 3D, textures and any of the 1,000+ Wiro AI models in the 3D Viewport sidebar, with the results brought into your scene.

Blender 4.2+ CI Release License: GPL-3.0-or-later

Website · Models · Docs · Dashboard

The add-on adds a Wiro AI tab to the sidebar of the 3D Viewport. Describe an object or pick pictures of it and get a textured 3D model at the 3D cursor. Put a texture on the selected objects from a prompt, or change the texture a model already has. Search the Wiro AI catalog and run any model with a form built from its settings. The models run on Wiro AI, so nothing runs on your GPU, and the add-on needs no extra Python packages.

Text to 3D: Nano Banana 2.1 drew a red rotary telephone, the background was removed, and Trellis-2 built the mesh

What it does

Install

From the Wiro AI extension repository, so Blender shows new versions as updates:

  1. In Blender 4.2 or later, open Edit > Preferences > Get Extensions.

  2. Open the Repositories menu at the top right, click + and choose Add Remote Repository. Enter this URL and click Create:

    https://wiroai.github.io/Wiro-Blender/index.json
    
  3. Search for Wiro AI in Get Extensions and click Install. New versions appear under Check for Updates in the same menu.

From a file: download wiro_ai-1.1.0.zip from the latest release and drag it into Blender, or choose Install from Disk in the menu at the top right of Get Extensions.

The models run online, so Allow Online Access has to be on (Edit > Preferences > System > Network). The panel tells you when it is off.

Set your API key

Create a project at wiro.ai/panel/project/new and copy its API key. Then open Edit > Preferences > Add-ons > Wiro AI 3D Generator and paste it into API key. If the project uses signature-based authentication, paste the API secret too. Check API Key asks Wiro AI whether the key works and reads your wallet balance, which is free.

The add-on preferences: API key, API secret, the folder for generated files and how many jobs run at once

The key stays in Blender's preferences, never in your .blend files, and it is only sent to api.wiro.ai. You can also set WIRO_API_KEY (and WIRO_API_SECRET) in the environment before you start Blender. The add-on uses them when the preferences are empty.

Save files to sets where generated files go. A path that starts with // is relative to the open .blend file. Left empty, files go to the add-on's own folder in your Blender user directory. Jobs at Once sets how many jobs run at the same time.

The panels

Press N in the 3D Viewport to open the sidebar and click the Wiro AI tab.

3D Model

Choose Text to 3D or Image to 3D. For Text to 3D, write a prompt, for example a red vintage rotary telephone, and pick the image model. Frame for 3D (on by default) adds a short instruction that asks for one whole object, centered on a plain background, which is what image-to-3D models work best with. Remove Background adds a background removal step before the 3D model. Then pick the 3D model and press Generate 3D Model. Each model shows its own settings, with the ones that matter most in Blender up front and the rest under More Options.

Image to 3D with HY-World 2.0: two pictures in, a colored point cloud out

Texture

New Texture makes a texture from a prompt, for example mossy cobblestone, and puts it on every selected object. Tileable asks for a seamless texture. Under Material you set the mapping (Auto uses the UV map when there is one and box projection otherwise), the tiling, the bump strength and the base roughness, and whether the new material replaces the old ones.

New Texture: a tileable mossy cobblestone texture on a cube

Edit Texture sends the base color texture of the active object to an image editing model with your prompt and puts the result in its place. The material is copied first if other objects share it, and Undo brings the old texture back.

Edit Texture: the telephone repainted emerald green, with the dial and the chrome parts kept

Run Any Model

Type a few words, pick a category if you like and press the arrow. Pick a model from the list and its settings appear as a form; required settings have a star. Long prompts and JSON can come from a text block in the Text Editor. File settings take local files, https URLs or images from the .blend file.

Run Any Model: the search list, the form of an LLM, and its answer in a text block

Queue and History

The Queue panel lists running and waiting jobs with their progress, the step the model reports and a preview of the latest picture, so you can, for example, send one picture to several 3D models and compare what comes back. The History panel keeps every finished run, newest first, with what it made, how long it took and what it cost.

The Queue panel: Trellis-2 and Pixal3D build a mesh from the same picture at the same time

Models

The pickers list the Wiro AI catalog by category, so this table is the starting point rather than the full list.

Panel Category Starts with Also listed today
3D Model 3D generation Trellis-2 (Microsoft) Pixal3D, Hunyuan3D-2.1, HY-World 2.0 for several pictures
Reference picture, New Texture Text to image Nano Banana 2.1 (Google) GPT Image 2.6 Flare and more than 30 others
Edit Texture Image editing Nano Banana 2.1 (Google) GPT Image 2.6 Flare and more than 30 others
Remove Background Background removal Remove Background (Wiro) RMBG 2.0, BiRefNet, Ideogram Remove Background
Run Any Model Every category 1,000+ models for images, video, audio, 3D and LLMs

For the 3D models the panel starts with settings that suit Blender: a 200,000 face limit and 2048 pixel textures for Trellis-2 and Pixal3D, and a 200,000 face limit for Hunyuan3D-2.1. Reset Settings under More Options puts a model's settings back.

Scripting

The panel settings live on the scene as bpy.context.scene.wiro_ai, so a script can set them and call the operators. Models are picked by their slug:

import bpy

settings = bpy.context.scene.wiro_ai
settings.mode = "TEXT"  # or "IMAGE", with settings.images
settings.prompt = "a ceramic teapot with a blue floral pattern"
settings.reference_model = "google/nano-banana-2-1"
settings.mesh_model = "microsoft/trellis-2"
settings.use_cutout = True
bpy.ops.wiro_ai.generate()

settings.texture_prompt = "polished walnut wood"
bpy.ops.wiro_ai.generate_texture()  # on the selected objects
bpy.ops.wm.save_as_mainfile(filepath="teapot.blend")

In background mode each operator returns once its result is in the scene. --online-mode allows network access for that run:

WIRO_API_KEY=your-api-key blender --background --online-mode --python teapot.py

How it works

The extension asks Blender for two permissions: network, to send prompts and files to Wiro AI and download the results, and files, to read input files and save the results.

wiro_ai/            the extension, packaged with "blender --command extension build"
  api.py            Wiro AI REST client, standard library only
  schema.py         a model's settings from Tool/Detail, and the Run fields
  pricing.py        the price of a run for given settings
  catalog.py        model lists by category, cached, with the shipped copy in data/
  pipeline.py       jobs: one or more model runs in a row, on a worker thread
  runtime.py        queue, timer, history and catalog refreshes on the main thread
  forms.py          settings forms built from schemas, and the model pickers
  importer.py       3D files, point clouds, pictures, sound, video and text
  materials.py      textures as materials, and texture edits
  operators.py      the operators behind the buttons
  ui.py             the sidebar panels
tests/              unit tests and the scripts that run inside Blender
scripts/            update_catalog.py refreshes the shipped catalog copy

Development

Unit tests and lint run without Blender:

pip install ruff pytest
ruff check . && ruff format --check .
python -m pytest

Validate and build the package with Blender 4.2 or later:

blender --command extension validate wiro_ai
mkdir -p dist
blender --command extension build --source-dir wiro_ai --output-dir dist

The smoke test installs the package and runs every panel through its real operator against a fake Wiro AI API, without network access:

blender --command extension install-file -r user_default dist/wiro_ai-1.1.0.zip
blender --background --factory-startup --python-exit-code 1 --python tests/blender/smoke_test.py -- tests/fixtures/cube.glb

tests/blender/live_test.py makes real runs and is billed to the key's wallet, so it stays out of CI. CI runs lint and the unit tests on Python 3.11 and 3.13, and the manifest check, build and smoke test on Blender 4.2.23 and 5.3.0. python scripts/update_catalog.py refreshes wiro_ai/data/catalog.json from the public catalog.

Pushing a tag such as v1.1.0 runs the Release workflow: it builds the package with Blender, attaches it to the GitHub release and publishes the extension repository (index.json and an index.html page) on GitHub Pages.

Pricing

Each run is billed to the Wiro AI wallet of the API key's project at the model's price. Every panel shows the price for its current settings above its button, and the History panel shows what each finished run cost. Some examples:

Model Price per run
Trellis-2 $0.25 at 512, $0.30 at 1024, $0.35 at 1536
Pixal3D $0.30 at 1024, $0.42 at 1536
Hunyuan3D-2.1 $0.90 with textures, $0.30 without
HY-World 2.0 by run time, a few cents for a few pictures
Nano Banana 2.1 (reference picture, texture, texture edit) $0.0336 at 1K
Remove Background by run time, about a tenth of a cent

A Text to 3D run costs the picture plus the 3D model, for example $0.3342 for Nano Banana 2.1, Remove Background and Trellis-2 at 1024. The model pages on wiro.ai list the current prices.

More from Wiro AI

Repository What it is
Wiro-MCP Official MCP server for Wiro AI, @wiro-ai/wiro-mcp on npm
Wiro-Plugin Wiro AI plugin for Cursor, Claude Code, Gemini CLI, Devin, Antigravity and Kiro
Wiro-Skills Agent skills for images, image edits, video, music, speech, transcripts, 3D and model search
Wiro-LLM Vercel AI SDK provider for chat, images, speech, transcription and video, @wiro-ai/wiro-llm on npm
Wiro-ComfyUI Wiro AI nodes for ComfyUI
Wiro-Dify-Plugin Wiro AI model provider and media tools for Dify
Wiro-Zed Wiro AI MCP server for the Zed editor
Wiro-Raycast Wiro AI extension for Raycast
Wiro-Action GitHub Action for Wiro AI
Wiro-Hermes Wiro AI plugins for Hermes Agent: image, video, audio and 3D tools, plus the LLM gateway as a model provider
Wiro-Next-Starter Next.js starter for Wiro AI
Wiro-WordPress Wiro AI plugin for WordPress: featured images, image edits, alt text, narration and SEO suggestions
Wiro-Obsidian Wiro AI plugin for Obsidian: images, video, speech, music, transcription and text tools
Wiro-Figma Wiro AI plugin for Figma: images, vectors, image edits and text
n8n-nodes-wiro One Wiro AI node for n8n with a searchable model picker, @wiro-ai/n8n-nodes-wiro on npm
Wiro-Chromium-Extension Wiro AI extension for Chrome, Edge, Opera, Whale and Brave
Wiro-Firefox-Extension Wiro AI add-on for Firefox
Wiro-Safari-Extension Wiro AI extension for Safari on the Mac
Swift-QuickStart WiroKit, the Wiro AI SDK for iOS
Kotlin-QuickStart WiroKit, the Wiro AI SDK for Android
Dart-QuickStart Wiro AI SDK for Dart and Flutter, wiro on pub.dev
ReactNative-QuickStart Wiro AI SDK for React Native and Expo, @wiro-ai/wiro-react-native on npm
Swift-Realtime Realtime voice AI example for iOS
Kotlin-Realtime Realtime voice AI example for Android
Dart-Realtime Realtime voice AI example for Flutter
ReactNative-Realtime Realtime voice AI example for React Native
Wiro-Docs Source of the Wiro AI API docs
wiroai.github.io Every open-source project from Wiro AI on one page, with a page for each repository

Website · Models · Docs · X

License

GPL-3.0-or-later, see LICENSE. Blender is a trademark of the Blender Foundation; this add-on is made by Wiro AI and is not affiliated with or endorsed by the Blender Foundation.