<h1 id="what-is-neural-render-4l7q6f7ev">What is Neural Render?</h1>Neural Render is a Blender add-on that integrates AI models from Replicate into your Blender workflow. It allows you to process rendered images with AI, enhancing their quality and resolution or generating new images based on your renders directly within Blender.<h2 id="why-replicate-d31qi0x0z">Why Replicate?</h2>While we can use local models for inference, making the project truly open-source, the first version was built on top of Replicate – cloud computing provider, to ensure we can run any models in the cloud with great speed and quality. I plan to publish updates on this workflow when we’ll be closer to on-device image inference. <h2 id="render-will-never-be-the-same-fhaptzyr9">Render Will Never Be The Same</h2>While traditional render still is very important and nothing can be compared to its flexibility, there are already many applications AI render could be better, or even replace the traditional approach. I will show you some of the recently discovered. <h2 id="current-features:-8ymolv99s">Current Features:</h2><ul><li>Upscale and enhance rendered images using Clarity Upscaler</li><li>Generate new images based on your renders using Control Net</li><li>Customizable parameters for AI processing</li><li>Seamless integration with Blender's render pipeline</li><li>Support for various Stable Diffusion models and control types</li><li>Options for tiling, downscaling, and custom LoRA models </li></ul><img src="https://image.civitai.com/xG1nkqKTMzGDvpLrqFT7WA/de8e24c7-5576-4688-a803-8a4e7257cba4/width=525/de8e24c7-5576-4688-a803-8a4e7257cba4.jpeg" /> You can find the detailed instructions on how to install and use the add-on below, along with the code and necessary requirements. Be open to contributing and adding any information or examples directly into the GitHub repo.<a target="_blank" rel="ugc" href="https://github.com/n1x-ax/Neural-Render">Blender Neural Render GitHub</a><h2 id="installation-iqzmm8vs2">Installation</h2><ol><li>Download the addon ZIP file</li><li>In Blender, go to Edit &gt; Preferences &gt; Add-ons</li><li>Click "Install" and select the downloaded ZIP file</li><li>Enable the "Render: Neural Render" addon </li></ol><h2 id="usage-clwto8lss">Usage</h2><ol><li>Set up your Replicate API key in the addon preferences</li><li>Go to the Properties panel &gt; Render tab &gt; Neural Render section</li><li>Choose the AI model you want to use (Clarity Upscaler or Control Net)</li><li>Adjust the AI processing parameters as needed</li><li>Click the "Neural Render" button to process your render with AI </li></ol><h2 id="requirements-safha9ibi">Requirements</h2><ul><li>Blender 4.2.0 or higher</li><li>Active internet connection</li><li>Replicate account</li><li>Replicate API key </li></ul><h2 id="getting-started-with-replicate-z8k7z4bd5">Getting Started with Replicate</h2><ol><li>Visit the Replicate website: <a target="_blank" rel="ugc" href="https://replicate.com">https://replicate.com</a></li><li>Sign up for an account if you don't have one</li><li>Once logged in, go to your account settings</li><li>Find the API tokens section and generate a new API token</li><li>Copy this API token and keep it secure - you'll need it for the addon</li></ol>Remember to never share your API token publicly. You can always generate a new token if needed. <h2 id="configuration-tkfgvt8dl">Configuration</h2><ul><li>API Key: Enter your Replicate API key in the addon preferences</li><li>AI Model: Choose between Clarity Upscaler and Control Net</li><li>Model-specific parameters: Adjust based on the selected model </li></ul><h3 id="clarity-upscaler-parameters-w93gyusrj">Clarity Upscaler Parameters</h3><ul><li>Positive Prompt: Describe what you want to enhance in the image</li><li>Negative Prompt: Describe what you want to avoid in the image</li><li>Seed: Set a seed for reproducible results</li><li>Steps: Number of inference steps</li><li>Scheduler: Choose the AI scheduler algorithm</li><li>Scale Factor: Set the upscaling factor</li><li>Other parameters: Adjust creativity, resemblance, tiling, etc. </li></ul><h3 id="control-net-parameters-2wb7avv76">Control Net Parameters</h3><ul><li>Prompt: Describe the image you want to generate</li><li>Negative Prompt: Describe what you want to avoid in the image</li><li>Seed: Set a seed for reproducible results</li><li>Steps: Number of inference steps</li><li>Control Type: Choose between canny, soft edge, or depth</li><li>Guidance Scale: Adjust the influence of the prompt</li><li>Control Strength: Set the strength of the control</li></ul><h2 id="usage-recommendations-and-cautions-887abqunn">Usage Recommendations and Cautions</h2><h3 id="caution-xu44iyern">CAUTION</h3>Using this plugin with Replicate API may incur costs. Users are responsible for their usage and any associated charges. Carefully manage your settings to avoid high usage and costs.<h3 id="usage-recommendations-d1wbzbpsf">Usage Recommendations</h3><ul><li>You can render very low quality without downscaling for fast speed and low pricing.</li><li>Use downscale when rendering more than 1024 pixels in size.</li><li>To keep details while downscaling, you can render up to any resolutions (2-6k), but it's very important to use downscale to maintain details while saving usage and costs.</li><li>If using a scale factor more than 2, make sure your rendered images have low resolution.</li></ul><h3 id="useful-tips-ckyrpd4j7">Useful Tips</h3><ul><li>Change the seed to diversify your generation.</li><li>Lower creativity and resemblance values will only upscale/enhance your render. For creative outputs, try increasing these numbers and don't hesitate to experiment.</li></ul><h3 id="installation-tip-gt561lwf5">Installation Tip</h3>If you encounter issues with missing dependencies when installing the addon, you can manually install the required packages. Here's how:Method 1 (Works for Mac, may work for some Windows setups):<ol><li>Open Blender's Script Editor</li><li>Create a new text file</li><li>Paste and run the following Python code:</li></ol><pre><code>import sys
import subprocess
subprocess.check_call([sys.executable, '-m', 'pip', 'install', 'replicate'])</code></pre><ol><li>Restart Blender</li><li>Try enabling the Neural Render addon again</li></ol>Method 2 (Alternative for Windows users):If Method 1 doesn't work on your Windows system, follow these steps:<ol><li>Locate your Blender installation folder. It's typically in: <code>C:\Program Files\Blender Foundation\Blender 4.2</code></li><li>Open Windows File Explorer and navigate to this folder</li><li>In the address bar at the top, type <code>cmd</code> and press Enter. This will open a Command Prompt window in the Blender folder</li><li>In the Command Prompt, type the following command and press Enter:<pre><code>4.2\python\bin\python.exe -m pip install replicate
</code></pre></li><li>Wait for the installation to complete. You should see a success message</li><li>Close the Command Prompt and restart Blender</li><li>Try enabling the Neural Render addon again</li></ol>These methods should install the necessary 'replicate' package in Blender's Python environment. If you're still experiencing issues, please check our GitHub repository for the most up-to-date troubleshooting tips. <h2 id="parameter-descriptions-svslvi85l">Parameter Descriptions</h2><ul><li>Positive Prompt: Describe what you want to enhance or add to the image.</li><li>Negative Prompt: Describe what you want to avoid or remove from the image.</li><li>Seed: Set a seed for reproducible results (0 means random).</li><li>Steps: Number of inference steps (higher values may produce better quality but take longer).</li><li>Scheduler: Choose the AI scheduler algorithm for the diffusion process.</li><li>Scale Factor: Set the upscaling factor for the image.</li><li>Dynamic: Adjusts the HDR effect, try values from 3 to 9.</li><li>Creativity: Controls the level of creative interpretation, try values from 0.3 to 0.9.</li><li>Resemblance: Determines how closely the output resembles the input, try values from 0.3 to 1.6.</li><li>Tiling Width/Height: Affects the fractality of the image, lower values result in higher fractality.</li><li>SD Model: Choose the Stable Diffusion model checkpoint.</li><li>Downscaling: Enable to downscale the image before upscaling (recommended for large images).</li><li>Downscaling Resolution: Set the resolution for downscaling.</li><li>LoRA Links: Add links to LoRA files for additional fine-tuning.</li><li>Custom SD Model: Provide a link to a custom Stable Diffusion model.</li><li>Sharpen: Apply sharpening to the image after upscaling.</li><li>Mask: Provide a mask image URL to preserve specific areas during upscaling.</li><li>Hand Fix: Use Clarity to fix hands in the image.</li><li>Pattern: Enable for upscaling patterns with seamless tiling.</li><li>Output Format: Choose the format for the output images (WebP, JPEG, or PNG).</li></ul><h2 id="credits-d8va8cdk9">Credits</h2><ul><li>Developed by Alex Nix</li><li>Powered by Replicate and the Clarity Upscaler model</li><li>Built for Blender, the free and open source 3D creation suite</li><li>Flux Control Net model by xlabs-ai</li><li>Control Net model by jagilley</li><li>Cursor AI for everything else</li></ul>

Files with SHA256: 92167383628a622d142988eb96a2079a188048c70fcac69bb54d52d81b7787b8