Sulo AI

AI-Powered UV Layout Optimization for Blender

Overview

Sulo AI is a Blender addon that leverages artificial intelligence to optimize UV mapping workflows. It provides intelligent UV packing, AI-powered naming suggestions, and automated seam detection.

Features

• Smart UV Packing: Advanced rectangle packing algorithms with rotation optimization
• AI-Powered Naming: Intelligent naming for UV maps based on mesh analysis
• Seam Suggestions: Automated seam detection for optimal UV unwrapping
• Batch Processing: Process multiple objects efficiently
• Caching System: Fast results with intelligent caching

Requirements

• Blender 4.0 or higher
• Python 3.10+
• Claude API key (for AI features)

Installation

1. Download the latest release
2. In Blender, go to Edit > Preferences > Add-ons
3. Click "Install" and select the downloaded zip file
4. Enable "Sulo AI" in the addon list
5. Configure your Claude API key in the addon preferences

Quick Start

1. Select a mesh object with UV maps
2. Open the N-panel (press N in 3D viewport)
3. Navigate to the "Sulo AI" tab
4. Click "Pack UVs" to optimize UV layout
5. Use "Generate Names" for AI-powered naming suggestions

Development

Setup Development Environment

# Clone the repository
git clone <repository-url>
cd sulo-ai

# Install dependencies
pip install -r requirements.txt

# Run tests
pytest tests/

Project Structure

sulo-ai/
├── sulo_ai/          # Main addon code
│   ├── core/         # Core algorithms (Blender-independent)
│   ├── blender/      # Blender integration
│   ├── ai/           # AI client and prompts
│   ├── ui/           # User interface panels
│   └── utils/        # Utilities and helpers
├── tests/            # Test suite
├── docs/             # Documentation
└── scripts/          # Development scripts

Documentation

See the docs/ directory for detailed documentation:

• User Guide
• API Reference
• Contributing
• Changelog

License

GPL-3.0 (Required for Blender addons)

Contributing

Contributions are welcome! Please read CONTRIBUTING.md for details on our code of conduct and the process for submitting pull requests.

Support

• Report bugs on the issue tracker
• Join our community discussions
• Check the documentation for guides and tutorials

Acknowledgments

• Built with the Anthropic Claude API
• Powered by advanced packing algorithms
• Inspired by the Blender community

---

Made with care for the Blender community