Skip to content

Home

Jump to bottom
Claude edited this page Nov 10, 2026 · 3 revisions

Welcome to the OxyBrush Wiki

OxyBrush is a fast, lightweight, and modern open-source 3D digital sculpting application written in pure Rust with wgpu. Designed for artists, character sculptors, 3D printing enthusiasts, and technical directors, OxyBrush provides a focused sculpting experience with multiresolution subdivision surfaces, voxel remeshing, dynamic topology, brush stabilizers, an extensible Python plugin ecosystem, and local AI agent integration via the Model Context Protocol (MCP).

Quick Navigation

Section Description
Getting Started Installation guide (Windows, macOS, Linux), welcome screen tour, and your first sculpt.
Navigation & Keymaps Viewport navigation controls, Blender/Maya MMB orbit mode, pen tablet setup, and customizable keymaps.
Camera & Viewport Settings Perspective vs orthographic projection, matcaps, ambient occlusion, cavity shading, and wireframe views.
Sculpting & Brushes Complete guide to all 16 sculpting brushes, brush falloffs, alphas, stroke stabilizers, and symmetry.
Subdivision Levels Multiresolution sculpting workflow, stepping up and down levels, and fine detail propagation.
Topology & Remeshing OpenVDB-style voxel remeshing, boolean unions, quadric error decimation, and multi-piece management.
Masking & Face Groups Brush masking, box/lasso masking, cavity masks, face group generation, and group isolation.
Posing & Transform Gizmo The 3D transform gizmo, auto-orienting pivots, and soft mask deformation for posing characters and props.
Vertex Color & Materials Direct vertex painting, cavity/peak tinting, PBR shading, and custom matcap loading.
In-App Plugins (WebAssembly) Sandboxed plugins that run inside OxyBrush: using them, writing one in Rust or WebAssembly text, and sharing it as an .oxyaddon.
Plugin API Reference Every host function an in-app plugin can call, with layouts, error codes and limits; plus the manifest reference.
Python Plugin Development Create custom scripts, generators, and workflows using the pure Python oxybrush SDK.
Local AI Agent (MCP) Connect Claude Desktop, Antigravity, or local LLMs directly to OxyBrush for tandem interactive sculpting.
Import, Export & 3D Printing Exporting glTF, OBJ, STL, and PLY formats, generating LODs, and preparing watertight meshes for 3D printing.

Key Highlights

  • Pure Rust Architecture: High memory safety and performance with zero unsafe in core sculpting engines.
  • Modern GPU Rendering (wgpu): Runs natively on Vulkan, Metal, and DirectX 12 without legacy OpenGL bloat.
  • Multiresolution Subdivision Surfaces: Step smoothly between low-resolution blockouts and multi-million-triangle micro-detail.
  • Zero-Latency Stroke Pipeline: Parallel BVH spatial lookups and Rayon-accelerated vertex deformation maintain responsive 60+ FPS interaction even during heavy brush passes.
  • Python Scripting & Plugin System: Write standalone scripts or interactive plugins that run via an in-app menu with one-click reload.
  • AI-Assisted Sculpting: Built-in Model Context Protocol (MCP) server allows AI assistants to inspect meshes, execute strokes, generate primitives, and assist in creative workflows.
  • Production Pipeline Ready: Robust glTF/GLB, OBJ, STL, and PLY import/export, plus an automated headless CLI (oxybrush-cli) for batch decimation and LOD generation.

Community & Contributing

OxyBrush is an open-source multiresolution digital sculpting tool written in pure Rust with wgpu. Visit the GitHub repository or download the latest version from Releases.

OxyBrush Wiki

Getting Started

Sculpting & Workflow

Scripting & Extensibility

Pipeline & Production

Clone this wiki locally