Skip to content

Free, open-source 3D sculpting for Linux, macOS and Windows: dense meshes, remeshing, painting, built-in AI (image/text to 3D), Send to Unreal, game-ready LODs, Gaussian splats and OpenUSD.

31.8 KB
Raw Blame
<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <meta name="viewport" content="width=device-width, initial-scale=1">
  <title>Brush Lab and sharing brushes - SculptForge User Guide</title>
  <meta name="description" content="Brush Lab designs sculpting brushes from a description: type &quot;dry cracked mud&quot; and an AI model builds the brush, then you refine it in words or with sliders. This chapter covers Brush Lab, the AI providers it can use, the recipe settings, your brush library, and the ways to share brushes: .sfbrush f">
  <meta name="theme-color" content="#111114">
  <meta name="color-scheme" content="dark">
  <link rel="icon" type="image/png" sizes="32x32" href="../img/favicon-32.png?v=7">
  <link rel="icon" type="image/png" sizes="64x64" href="../img/favicon-64.png?v=7">
  <link rel="apple-touch-icon" href="../img/apple-touch-icon.png?v=7">
  <link rel="canonical" href="https://sculptforge.app/guide/brush-lab.html">
  <meta property="og:type" content="article">
  <meta property="og:title" content="Brush Lab and sharing brushes - SculptForge User Guide">
  <meta property="og:description" content="Brush Lab designs sculpting brushes from a description: type &quot;dry cracked mud&quot; and an AI model builds the brush, then you refine it in words or with sliders. This chapter covers Brush Lab, the AI providers it can use, the recipe settings, your brush library, and the ways to share brushes: .sfbrush f">
  <meta property="og:image" content="https://sculptforge.app/img/social-preview.png?v=5">
  <meta property="og:url" content="https://sculptforge.app/guide/brush-lab.html">
  <link rel="stylesheet" href="../style.css?v=19">
  <script src="../motion.js?v=12" defer></script>
  <script data-goatcounter="https://sculptforge.goatcounter.com/count" async src="https://gc.zgo.at/count.js"></script>
  <script src="search-index.js?v=52" defer></script>
</head>
<body class="guide-page" data-prev="sculpting.html" data-next="brush-packs.html">
  <div class="scroll-progress" aria-hidden="true"></div>
  <header class="nav">
    <div class="wrap nav-inner">
      <a class="brand" href="../index.html"><img class="brand-mark" src="../img/bust-mark-44.png" srcset="../img/bust-mark-88.png 2x, ../img/bust-mark-132.png 3x" width="44" height="44" alt=""><span>SculptForge</span></a>
      <nav aria-label="Main">
        <a href="../index.html#features">Features</a>
        <a href="../index.html#demos">Demos</a>
        <a href="../brushes.html">Brushes</a>
        <a href="index.html" aria-current="page">Guide</a>
        <a class="nav-dl" href="../index.html#download">Download</a>
        <a class="gh" href="https://discord.gg/gWrYkEmQhH">Discord</a>
        <a class="gh" href="https://github.com/islandmed/SculptForge">GitHub</a>
      </nav>
    </div>
  </header>
  <div class="wrap guide-layout">
    <div class="guide-side">
      <button class="toc-toggle" type="button" aria-expanded="false" aria-controls="guide-toc">
        <span>Contents</span><span class="toc-current">Brush Lab and sharing brushes</span></button>
      <div id="guide-toc" class="toc-panel">
        <div class="guide-search" role="search">
          <input type="search" id="guide-q" placeholder="Search the guide" aria-label="Search the guide" autocomplete="off">
          <div class="search-results" id="guide-results" hidden></div>
        </div>
        <nav class="toc" aria-label="User guide"><a class="toc-home" href="index.html">Contents</a><p class="toc-group">Getting started</p><ul><li><a href="welcome.html">Welcome to SculptForge</a></li><li><a href="first-sculpt.html">Your first sculpt in 10 minutes</a></li><li><a href="whats-new.html">What&#x27;s new</a></li><li><a href="quick-tour.html">Quick tour for experienced sculptors</a></li><li><a href="installing.html">Install SculptForge on Windows, macOS and Linux</a></li><li><a href="interface.html">The interface</a></li><li><a href="navigation.html">Navigating the view</a></li></ul><p class="toc-group">Sculpting</p><ul><li><a href="sculpting.html">Sculpting and brushes</a></li><li><a href="brush-lab.html" class="current" aria-current="page">Brush Lab and sharing brushes</a><ul class="toc-sections"><li><a href="#what-a-custom-brush-is">What a custom brush is</a></li><li><a href="#open-brush-lab">Open Brush Lab</a></li><li><a href="#design-a-brush">Design a brush</a></li><li><a href="#choose-an-ai-provider">Choose an AI provider</a></li><li><a href="#your-brush-library">Your brush library</a></li><li><a href="#share-brushes">Share brushes</a></li><li><a href="#the-community-gallery">The community gallery</a></li><li><a href="#brushes-from-scripts">Brushes from scripts</a></li><li><a href="#see-also">See also</a></li></ul></li><li><a href="brush-packs.html">Brush packs</a></li><li><a href="masking.html">Masking</a></li><li><a href="face-groups.html">Face Groups and visibility</a></li><li><a href="selection-sets.html">Selection sets and morph targets</a></li><li><a href="parts.html">Parts</a></li><li><a href="linked-duplicates.html">Linked Duplicates</a></li><li><a href="forge-spheres.html">Forge Spheres</a></li><li><a href="tube.html">Tube: draw in 3D space</a></li><li><a href="vertex-paint.html">Vertex Paint and materials</a></li><li><a href="texture-painting.html">Texture painting</a></li><li><a href="uv-editor.html">UV Editor</a></li><li><a href="pbr-painting.html">Material painting (PBR)</a></li><li><a href="fill-layers.html">Fill layers, Mesh Maps and Material Recipes</a></li><li><a href="layers.html">Sculpt layers and blend shapes</a></li><li><a href="facial-shapes.html">Facial shapes and live face</a></li><li><a href="subdivision-levels.html">Subdivision levels</a></li><li><a href="micro-levels.html">Micro levels: hundreds of millions of polygons</a></li><li><a href="dynamic-topology.html">Dynamic topology</a></li><li><a href="timeline.html">Sculpt Timeline and timelapse</a></li><li><a href="gizmo.html">Moving, rotating and posing (Gizmo)</a></li><li><a href="geometry.html">Subdivide, remesh, decimate and LODs</a></li><li><a href="cut.html">Cut: line, lasso, rectangle and polyline</a></li><li><a href="retopology.html">Quad retopology and detail projection</a></li></ul><p class="toc-group">AI and capture</p><ul><li><a href="generate-3d.html">Image and text to 3D</a></li><li><a href="splats.html">Gaussian splats</a></li><li><a href="scan-to-splat.html">Scan an object into a splat</a></li><li><a href="scan-to-sculptable.html">From scan to sculptable mesh</a></li><li><a href="phone-capture.html">Phone capture and AR</a></li></ul><p class="toc-group">Files and pipelines</p><ul><li><a href="baking.html">Baking normal and displacement maps</a></li><li><a href="exporting.html">Exporting, Unreal and Bridge</a></li><li><a href="export-presets.html">Export presets</a></li><li><a href="blender.html">Working with Blender</a></li><li><a href="maya.html">Working with Maya</a></li><li><a href="projects.html">Projects, autosave and snapshots</a></li><li><a href="scripting.html">Scripting and automation</a></li><li><a href="packs-and-macros.html">Packs and macros</a></li><li><a href="studios.html">SculptForge for studios</a></li><li><a href="security.html">Security overview for IT reviews</a></li></ul><p class="toc-group">Reference</p><ul><li><a href="shortcuts.html">Keyboard and mouse</a></li><li><a href="performance.html">Performance and big meshes</a></li><li><a href="troubleshooting.html">Troubleshooting: tablets, display, crashes and FAQ</a></li><li><a href="glossary.html">Glossary</a></li><li><a href="discord.html">Show SculptForge on Discord</a></li></ul></nav>
      </div>
    </div>
    <main class="guide-main" id="top">
      <article class="guide-article">
<h1 id="brush-lab-and-sharing-brushes">Brush Lab and sharing brushes</h1>
<p>Brush Lab designs sculpting brushes from a description: type &quot;dry cracked mud&quot; and an AI model builds the brush, then you refine it in words or with sliders. This chapter covers Brush Lab, the AI providers it can use, the recipe settings, your brush library, and the ways to share brushes: <code>.sfbrush</code> files, one-line brush codes, studio folders and the community gallery.</p>
<figure class="shot"><a href="images/brush-lab.jpg" class="zoom"><img src="images/brush-lab.jpg" alt="Brush Lab with a brush designed from a description" width="457" height="230" loading="lazy" decoding="async"></a><figcaption>Brush Lab with a brush designed from a description</figcaption></figure>
<h2 id="what-a-custom-brush-is">What a custom brush is<a class="anchor" href="#what-a-custom-brush-is" aria-label="Link to this section">#</a></h2>
<p>A custom brush is a <em>recipe</em>: about twenty named values that describe how the brush moves the surface, the shape of its tip, a surface pattern, stroke spacing and masking. A recipe is data, never code, so brushes are safe to download and share. The AI only fills in these values; you can see and change every one of them.</p>
<p>Custom brushes work everywhere built-in brushes do: on the bottom shelf, in the brush picker (<kbd>B</kbd>), with <kbd>Alt</kbd>, <kbd>Shift</kbd>, masks, symmetry, strokes and alphas.</p>
<h2 id="open-brush-lab">Open Brush Lab<a class="anchor" href="#open-brush-lab" aria-label="Link to this section">#</a></h2>
<p>Click <strong>AI Brush</strong> on the top shelf, or <strong>AI Brush</strong> at the top of <strong>Sculpt &gt; Brush</strong>. Brush Lab is a floating window; it opens at the top-left corner of the canvas the first time, and you can drag it anywhere. Click the button again, or the window&#x27;s close box, to hide it. Not there? AI features are off: turn them on in <strong>Edit &gt; Preferences &gt; AI</strong> (see <a href="interface.html#turning-ai-off">Turning AI off</a>).</p>
<h2 id="design-a-brush">Design a brush<a class="anchor" href="#design-a-brush" aria-label="Link to this section">#</a></h2>
<ol>
<li>
Open Brush Lab.
</li>
<li>
Type a description in the field at the bottom, the way you&#x27;d describe the brush to another sculptor, for example <code>bark of an old oak tree</code> or <code>soft folds in heavy cloth</code>. Or click one of the starter ideas, such as <strong>Overlapping dragon scales</strong> or <strong>Dry cracked mud</strong>.
</li>
<li>
Press <kbd>Enter</kbd> or click <strong>Create</strong>. While the model works, the conversation shows &quot;Designing brush&quot;.
</li>
<li>
When the brush is ready, it becomes the active brush and the status bar says so. Try it on the model.
</li>
</ol>
<p>The model replies with the brush name in brackets and a sentence on what the brush does and what to try next. Errors (no connection, rate limits, a model that didn&#x27;t return a recipe) appear in red in the same conversation.</p>
<h3 id="refine-a-brush-in-words">Refine a brush in words<a class="anchor" href="#refine-a-brush-in-words" aria-label="Link to this section">#</a></h3>
<p>With <strong>Refine the selected brush</strong> ticked, your next message changes the active custom brush instead of creating a new one: &quot;sharper&quot;, &quot;less buildup&quot;, &quot;make the scales smaller&quot;. The model sees the current recipe and your conversation so far. <strong>Clear chat</strong> starts a new conversation.</p>
<h3 id="tune-a-brush-with-sliders">Tune a brush with sliders<a class="anchor" href="#tune-a-brush-with-sliders" aria-label="Link to this section">#</a></h3>
<p>Open the <strong>Recipe</strong> section of Brush Lab to see every value of the active custom brush. The same editor appears in <strong>Sculpt &gt; Brush</strong> as <strong>Edit recipe: NAME</strong> when a custom brush is active. Hover a slider for a description.</p>
<div class="table-wrap"><table><thead><tr><th>Setting</th><th>Range</th><th>What it does</th></tr></thead><tbody><tr><td><strong>Direction</strong></td><td>normal, inflate, view, stroke</td><td>Which way the surface moves: out of the surface, outward in every direction, toward the camera, or along the stroke.</td></tr><tr><td><strong>Depth</strong></td><td>-1 to 1</td><td>Adds material (positive) or carves it away (negative).</td></tr><tr><td><strong>Plane</strong></td><td>none, clay, flatten, fill, scrape</td><td>Planar behaviour: flat-topped clay layers, levelling, raising only low spots, or cutting only high spots.</td></tr><tr><td><strong>Plane amount</strong></td><td>0 to 1</td><td>Strength of the plane behaviour.</td></tr><tr><td><strong>Pinch</strong></td><td>-1 to 1</td><td>Pulls the surface toward the stroke for crisp creases (negative spreads it apart).</td></tr><tr><td><strong>Drag</strong></td><td>0 to 1</td><td>Smears the surface along the stroke, like a palette knife.</td></tr><tr><td><strong>Auto smooth</strong></td><td>0 to 1</td><td>Relaxes the surface after each dab for softer, cleaner results.</td></tr><tr><td><strong>Hardness</strong></td><td>0 to 1</td><td>Soft airbrush edge (0) to hard-edged stamp (1).</td></tr><tr><td><strong>Tip sharpness</strong></td><td>0 to 1</td><td>Round, broad tip (0) to a narrow needle point (1).</td></tr><tr><td><strong>Pattern</strong></td><td>none, noise, scales, ridges, pores, cracks</td><td>A surface texture stamped by the brush.</td></tr><tr><td><strong>Pattern size</strong></td><td>0.03 to 2</td><td>Size of the pattern relative to the brush size.</td></tr><tr><td><strong>Pattern amount</strong></td><td>0 to 1</td><td>How strongly the pattern shows.</td></tr><tr><td><strong>Spacing</strong></td><td>0.02 to 2</td><td>Distance between dabs, relative to the brush size.</td></tr><tr><td><strong>Jitter</strong></td><td>0 to 1</td><td>Random scatter of dabs around the stroke.</td></tr><tr><td><strong>Pressure curve</strong></td><td>0.3 to 3</td><td>Tablet response: above 1 needs a firmer press, below 1 responds to a light touch.</td></tr><tr><td><strong>Front faces only</strong></td><td>on / off</td><td>Only affects surfaces facing the camera, protecting thin parts.</td></tr><tr><td><strong>Cavity mask</strong></td><td>-1 to 1</td><td>Positive: only cavities. Negative: only ridges and peaks (as Edge Wear does).</td></tr></tbody></table></div>
<p>The name field at the top of the editor renames the brush when you press <kbd>Enter</kbd>.</p>
<p>Under the recipe sliders are the brush&#x27;s pressure curve and <strong>Pen pressure: Size</strong> and <strong>Strength</strong>, each <strong>Use global</strong>, <strong>On</strong> or <strong>Off</strong>. <strong>Use global</strong> (the default) follows <strong>Pressure &gt; Size</strong> and <strong>Pressure &gt; Strength</strong> on the top shelf and in <strong>Edit &gt; Preferences &gt; Tablet</strong>; <strong>On</strong> and <strong>Off</strong> override them for this brush only. The choice is saved in the brush&#x27;s <code>.sfbrush</code> file, so a shared brush keeps it (see <a href="sculpting.html#pen-pressure-and-tablets">Pen pressure and tablets</a>).</p>
<aside class="callout callout-tip"><p><strong>Tip:</strong> to adapt a built-in recipe such as Dragon Scales, select it and move the sliders. Your version is saved to your library and replaces the built-in one; delete it to get the original back.</p></aside>
<h2 id="choose-an-ai-provider">Choose an AI provider<a class="anchor" href="#choose-an-ai-provider" aria-label="Link to this section">#</a></h2>
<p>Brush Lab works out of the box with no account or key. Open the <strong>AI provider</strong> section of Brush Lab (also in <strong>Mesh &gt; Generate 3D &gt; AI brush provider</strong> and <strong>Edit &gt; Preferences &gt; AI &gt; Provider</strong>) to choose another service. Each choice fills in the address and a model:</p>
<div class="table-wrap"><table><thead><tr><th>Provider</th><th>What you need</th><th>Notes</th></tr></thead><tbody><tr><td><strong>Free - no account or key</strong> (default)</td><td>Nothing</td><td>An open model (GPT-OSS 20B) hosted by Pollinations.ai. Only your description and settings are sent. Rate limited to about one request every few seconds. If it can&#x27;t be reached, a running local Ollama is used instead.</td></tr><tr><td><strong>Anthropic (Claude)</strong></td><td>An Anthropic API key</td><td>Uses <code>claude-opus-5-5</code> by default. <strong>Effort</strong> (low, medium, high) trades speed for more considered brushes.</td></tr><tr><td><strong>OpenAI</strong></td><td>An OpenAI API key</td><td>Click <strong>Find models</strong> to pick one.</td></tr><tr><td><strong>Ollama (this computer)</strong>, <strong>LM Studio (this computer)</strong></td><td>The app running on your computer</td><td>Private and offline, no key. See below.</td></tr><tr><td><strong>vLLM server</strong>, <strong>llama.cpp server</strong></td><td>A server on your computer or at your studio</td><td>Change the address to your server&#x27;s.</td></tr><tr><td><strong>LiteLLM proxy (studio gateway)</strong></td><td>Your studio&#x27;s gateway address</td><td>One address for every model your studio allows; a key from your studio, or your studio sign-in. See <a href="studios.html#ai-providers">IT deployment</a>.</td></tr><tr><td><strong>OpenRouter</strong></td><td>An OpenRouter key</td><td>Many models through one key.</td></tr><tr><td><strong>Other OpenAI-compatible server</strong></td><td>An endpoint, a model name and, for hosted services, a key</td><td>Any server that speaks the OpenAI chat completions API.</td></tr></tbody></table></div>
<p>You can edit the <strong>Endpoint</strong>, <strong>Model</strong> and <strong>API key</strong> fields. Leave the key empty to use the <code>ANTHROPIC_API_KEY</code>, <code>OPENAI_API_KEY</code> or <code>OPENROUTER_API_KEY</code> environment variable. Click <strong>Save settings</strong> to keep your choice. Keys are kept in your system&#x27;s keychain (macOS Keychain, Windows Credential Manager, or the Secret Service on Linux), never in a settings file. Requests go only to the endpoint you set. If your studio manages SculptForge, some providers may be greyed out with <strong>Managed by your studio</strong>.</p>
<h3 id="run-a-model-on-your-own-computer">Run a model on your own computer<a class="anchor" href="#run-a-model-on-your-own-computer" aria-label="Link to this section">#</a></h3>
<p>For private, offline use with no rate limits, run a local model with Ollama or LM Studio:</p>
<ol>
<li>
Install <a href="https://ollama.com/download" rel="noopener">Ollama</a> and download the recommended model: <code>ollama pull qwen3:4b-instruct</code> (2.5 GB, works without a graphics card).
</li>
<li>
In <strong>AI provider</strong>, choose <strong>Ollama (this computer)</strong> (or <strong>LM Studio (this computer)</strong>).
</li>
<li>
Click <strong>Find models</strong>. SculptForge checks the connection, shows &quot;Connected&quot; with the number of installed models, and lets you pick one from the <strong>Model</strong> list.
</li>
<li>
Click <strong>Save settings</strong>.
</li>
</ol>
<p>The <strong>Run a model on this computer</strong> section in the panel shows the install steps for your operating system. The model needs about 4 GB of free memory; expect 10-20 seconds per brush on a laptop CPU and a few seconds with a GPU. The full walkthrough for Windows, macOS, Linux and LM Studio is in <a href="https://github.com/islandmed/SculptForge/blob/main/docs/local-ai.md" rel="noopener">docs/local-ai.md</a>.</p>
<h2 id="your-brush-library">Your brush library<a class="anchor" href="#your-brush-library" aria-label="Link to this section">#</a></h2>
<p>Every brush you create or refine in Brush Lab is saved to your brush library automatically, a moment after your last change (slider edits save when you release the slider). The library loads at every start, in the app, in <code>sculptforge-cli</code> and in the Python module, so your brushes are always there.</p>
<p>The library is a folder of <code>.sfbrush</code> files in the SculptForge settings folder:</p>
<div class="table-wrap"><table><thead><tr><th>System</th><th>Brush library</th></tr></thead><tbody><tr><td>Linux</td><td><code>~/.local/share/SculptForge/SculptForge/brushes</code></td></tr><tr><td>macOS</td><td><code>~/Library/Application Support/SculptForge/SculptForge/brushes</code></td></tr><tr><td>Windows</td><td><code>%APPDATA%\SculptForge\SculptForge\brushes</code></td></tr></tbody></table></div>
<figure class="shot"><a href="images/brush-library.jpg" class="zoom"><img src="images/brush-library.jpg" alt="The Custom brushes list in Sculpt &gt; Brush, with its right-click menu" width="360" height="360" loading="lazy" decoding="async"></a><figcaption>The Custom brushes list in Sculpt &gt; Brush, with its right-click menu</figcaption></figure>
<h3 id="the-custom-brushes-list">The Custom brushes list<a class="anchor" href="#the-custom-brushes-list" aria-label="Link to this section">#</a></h3>
<p><strong>Sculpt &gt; Brush</strong> lists every custom brush under <strong>Custom brushes</strong>. A small tag after a name says where the brush comes from when it isn&#x27;t simply yours or built in:</p>
<div class="table-wrap"><table><thead><tr><th>Tag</th><th>Meaning</th></tr></thead><tbody><tr><td>(none)</td><td>A built-in brush, or a brush in your library</td></tr><tr><td><code>yours</code></td><td>Your version, which replaces a built-in or studio brush of the same name</td></tr><tr><td><code>studio</code></td><td>From a shared studio folder (read-only)</td></tr><tr><td><code>gallery</code></td><td>Installed from the community gallery (kept in your library)</td></tr><tr><td><code>project</code></td><td>Came with the open project and isn&#x27;t in your library</td></tr><tr><td><code>unsaved</code></td><td>Made this session (for example picked from the picker&#x27;s <strong>Library</strong> section, or loaded by a script) and not in your library</td></tr></tbody></table></div>
<p>Hover a brush for its description, origin and file. Right-click it for:</p>
<ul>
<li>
<strong>Copy brush code</strong>: one line of text to share (see below).
</li>
<li>
<strong>Save .sfbrush...</strong>: write the brush to a file.
</li>
<li>
<strong>Rename...</strong>: rename it. Renaming a built-in or studio brush saves a renamed copy and keeps the original.
</li>
<li>
<strong>Delete...</strong>: remove it from your library, after a confirmation. Only brushes in your own library can be deleted. If your brush replaced a built-in or studio brush, that one is used again.
</li>
<li>
<strong>Reveal in folder</strong>: open the folder that holds its file.
</li>
</ul>
<p>The same menu is available when you right-click a custom brush in the brush picker.</p>
<p>When brushes share a name, your library wins over studio folders, and studio folders win over built-in brushes.</p>
<h2 id="share-brushes">Share brushes<a class="anchor" href="#share-brushes" aria-label="Link to this section">#</a></h2>
<h3 id="brush-codes">Brush codes<a class="anchor" href="#brush-codes" aria-label="Link to this section">#</a></h3>
<p>A brush code is the whole recipe in one line of text, starting with <code>sfbrush1:</code>. Paste it into a chat, an email, an issue or a forum post.</p>
<ul>
<li>
<strong>Copy</strong>: right-click a custom brush (in <strong>Sculpt &gt; Brush &gt; Custom brushes</strong> or the brush picker) and choose <strong>Copy brush code</strong>.
</li>
<li>
<strong>Paste</strong>: copy a code, then press <kbd>Ctrl</kbd>+<kbd>V</kbd> over the viewport, click <strong>Paste brush</strong> in Brush Lab, or choose <strong>Edit &gt; Paste brush</strong>. The brush is installed in your library and becomes active.
</li>
</ul>
<p>Pasting also accepts the text of a <code>.sfbrush</code> file. Codes are validated like files: values outside their range are clamped, and anything that isn&#x27;t a recipe is refused.</p>
<h3 id="brush-files-sfbrush">Brush files (.sfbrush)<a class="anchor" href="#brush-files-sfbrush" aria-label="Link to this section">#</a></h3>
<p>A <code>.sfbrush</code> file is a small JSON file holding one recipe.</p>
<ul>
<li>
<strong>Save</strong>: right-click the brush and choose <strong>Save .sfbrush...</strong>, or click <strong>Save .sfbrush...</strong> under the recipe sliders.
</li>
<li>
<strong>Install</strong>: click <strong>Install .sfbrush...</strong> under the recipe sliders, or drop the file onto the SculptForge window. The brush goes into your library.
</li>
<li>
<strong>Library folder</strong>: <code>.sfbrush</code> files in the <code>Brushes</code> folder of your Library library (Documents/SculptForge by default) appear in the <strong>Library</strong> section of the brush picker and in Library&#x27;s Brush tab. Picking one loads it for the session.
</li>
</ul>
<p>The file format and every key are documented in <a href="https://github.com/islandmed/SculptForge/blob/main/docs/brushes.md" rel="noopener">docs/brushes.md</a>.</p>
<h3 id="studio-brush-folders">Studio brush folders<a class="anchor" href="#studio-brush-folders" aria-label="Link to this section">#</a></h3>
<p>A studio can share brushes read-only from network folders. Set the environment variable <code>SCULPTFORGE_BRUSH_PATH</code> to one or more folders (separated by <code>:</code> on Linux and macOS, <code>;</code> on Windows). Every <code>.sfbrush</code> file in them loads at start-up, tagged <code>studio</code>. Artists can&#x27;t change or delete studio brushes; if they edit one, their own version is saved in their library under the same name. The Rez package adds the folder in <code>SCULPTFORGE_STUDIO_BRUSHES</code> to this path. See <a href="studios.html">For studios</a>.</p>
<p>Projects (<code>.sfproj</code>) also store the brushes they use, so a scene opens with its brushes on any machine.</p>
<h2 id="the-community-gallery">The community gallery<a class="anchor" href="#the-community-gallery" aria-label="Link to this section">#</a></h2>
<p>The community gallery is a public collection of free (CC0) brushes shared by other sculptors.</p>
<ol>
<li>
Click <strong>Community brushes</strong> at the top of <strong>Sculpt &gt; Brush</strong>.
</li>
<li>
Search by name or description (scales, skin, stone...), or pick a tag from the <strong>All tags</strong> list.
</li>
<li>
Click <strong>Install</strong> under a brush. It is downloaded, checked against its SHA-256 checksum, installed in your library and made active. Installed brushes show <strong>Installed</strong>.
</li>
</ol>
<figure class="shot"><a href="images/community-brushes.jpg" class="zoom"><img src="images/community-brushes.jpg" alt="The Community brushes window" width="810" height="682" loading="lazy" decoding="async"></a><figcaption>The Community brushes window</figcaption></figure>
<p>The gallery is cached, so the window still opens offline (with a notice) showing the brushes from your last visit. <strong>Refresh</strong> fetches the latest list. <strong>Share yours</strong> opens the gallery&#x27;s page on GitHub, where you can submit a brush you saved as <code>.sfbrush</code> with a pull request.</p>
<p>You can also browse the gallery on the website at <a href="https://sculptforge.app/brushes.html" rel="noopener">sculptforge.app/brushes.html</a>.</p>
<p>Studios can mirror the gallery or run their own. Enter a URL or folder in the <strong>Gallery</strong> field at the bottom of the window and click <strong>Use</strong>, or set <code>SCULPTFORGE_BRUSH_GALLERY</code> (which then takes precedence and hides the field). See <a href="https://github.com/islandmed/SculptForge/blob/main/docs/brushes.md" rel="noopener">docs/brushes.md</a> for the gallery format.</p>
<h2 id="brushes-from-scripts">Brushes from scripts<a class="anchor" href="#brushes-from-scripts" aria-label="Link to this section">#</a></h2>
<p>Every brush operation is also a command, for <code>sculptforge-cli</code>, the console, Python and AI agents:</p>
<div class="table-wrap"><table><thead><tr><th>Command</th><th>What it does</th></tr></thead><tbody><tr><td><code>brush_ai prompt=...</code></td><td>Design a brush from a description (optional <code>provider</code>, <code>endpoint</code>, <code>model</code>).</td></tr><tr><td><code>brush_create name=... depth=...</code></td><td>Create or update a brush from recipe values.</td></tr><tr><td><code>brush_list</code> / <code>brush_library</code></td><td>List custom brushes (with their source and file, and the library folders).</td></tr><tr><td><code>brush_save path=...</code></td><td>Save a brush as <code>.sfbrush</code> (<code>name</code> defaults to the active brush).</td></tr><tr><td><code>brush_load path=...</code></td><td>Load a <code>.sfbrush</code> file for this session only.</td></tr><tr><td><code>brush_install path=... / code=... / json=...</code></td><td>Install a brush into your library and make it active.</td></tr><tr><td><code>brush_code</code></td><td>Print a brush as a brush code.</td></tr><tr><td><code>brush_rename to=...</code> / <code>brush_delete name=...</code></td><td>Rename or delete a brush.</td></tr><tr><td><code>brush_gallery_search</code> / <code>brush_gallery_install name=...</code></td><td>Search and install from the community gallery.</td></tr></tbody></table></div>
<div class="code-block"><pre class="code"><code class="language-sh"># Design a brush for free and save it for the team
sculptforge-cli -c &#x27;brush_ai prompt=&quot;weathered stone edges&quot;; brush_save path=stone.sfbrush&#x27;

# Install a gallery brush and try it on a sphere
sculptforge-cli -c &#x27;brush_gallery_install name=&quot;Snake Scales&quot;; new_sphere subdivisions=6; stroke points=&quot;-0.5,0,0 0.5,0.2,0&quot;&#x27;</code></pre><button class="copy" type="button" aria-label="Copy">Copy</button></div>
<p>See <a href="scripting.html">Scripting and automation</a> for running commands.</p>
<h2 id="see-also">See also<a class="anchor" href="#see-also" aria-label="Link to this section">#</a></h2>
<ul>
<li>
<a href="sculpting.html">Sculpting and brushes</a>: built-in brushes, strokes, alphas and pressure
</li>
<li>
<a href="studios.html">For studios</a>: shared brush folders and pipelines
</li>
<li>
<a href="troubleshooting.html">Troubleshooting</a>: AI provider errors and rate limits
</li>
</ul>
      </article>
      <nav class="pager" aria-label="Previous and next chapter"><a class="prev" rel="prev" href="sculpting.html"><span>Previous</span>Sculpting and brushes</a><a class="next" rel="next" href="brush-packs.html"><span>Next</span>Brush packs</a></nav>
      <p class="guide-meta fine">Also in the app: <strong>Help &gt; User Guide</strong> (<kbd>Shift</kbd>+<kbd>F1</kbd>).
        Found a mistake? <a href="https://github.com/islandmed/SculptForge/edit/main/docs/guide/brush-lab.md">Edit this page on GitHub</a>.</p>
    </main>
    <aside class="on-page" aria-label="On this page"><p>On this page</p><ul><li><a href="#what-a-custom-brush-is">What a custom brush is</a></li><li><a href="#open-brush-lab">Open Brush Lab</a></li><li><a href="#design-a-brush">Design a brush</a></li><li><a href="#choose-an-ai-provider">Choose an AI provider</a></li><li><a href="#your-brush-library">Your brush library</a></li><li><a href="#share-brushes">Share brushes</a></li><li><a href="#the-community-gallery">The community gallery</a></li><li><a href="#brushes-from-scripts">Brushes from scripts</a></li><li><a href="#see-also">See also</a></li></ul></aside>
  </div>
  <footer class="footer">
    <div class="wrap footer-grid">
      <div>
        <a class="brand" href="../index.html"><img class="brand-mark" src="../img/bust-mark-44.png" srcset="../img/bust-mark-88.png 2x, ../img/bust-mark-132.png 3x" width="32" height="32" alt=""><span>SculptForge</span></a>
        <p class="fine">Copyright © 2026 The SculptForge contributors.<br>The SculptForge User Guide is part of
          SculptForge, licensed under the <a href="https://github.com/islandmed/SculptForge/blob/main/LICENSE">GNU GPL v3.0 or later</a>.</p>
      </div>
      <div class="links">
        <a href="../performance/">Performance</a>
        <a href="index.html">User guide</a>
        <a href="../supporters.html">Members</a>
        <a href="https://github.com/islandmed/SculptForge">Source code</a>
        <a href="https://discord.gg/gWrYkEmQhH">Community Discord</a>
        <a href="https://github.com/islandmed/SculptForge/issues">Report a problem</a>
        <a href="https://github.com/islandmed/SculptForge/blob/main/docs/ai-services.md">AI services &amp; privacy</a>
      </div>
      <p class="fine trademarks">SculptForge is an independent project. Product names are trademarks of their respective owners.</p>
    </div>
  </footer>
</body>
</html>