Settings - Sorceress

🖥️

Local Server Setup

Enable persistent storage for images, videos, and preferences

Feature Requirements at a Glance

Some tools work instantly. Others require a Replicate API key and/or the local server. The header colors match these categories.

Works with no setup

These tools work right away without the local server or a Replicate key.

Spelljammer
Particle Designer
Sprite Analyzer
Spritely
SFX
Paint
Slicer
Tilesets

Needs Replicate API key

These tools require a Replicate API key to run.

BG Remover
Expander
ImGen (also needs local server)
VidGen (also needs local server)

Needs local server

These tools require the Sorceress local server to be running.

Games
Layout
Deploy
ImGen (also needs Replicate key)
VidGen (also needs Replicate key)

Extras

Handy utilities that don’t require special setup.

Chat
Utils
Notes

Configure Your Folders

Sorceress uses two folders: a Data Folder for generated content, and a Games Folder for your game projects.

📁 Data Folder

This is where Sorceress saves all your AI-generated content: images, videos, tilesets, and your preferences. Create a folder anywhere on your computer.

Data Folder Path

Port

🎮 Games Folder (Optional)

This is a separate folder containing your game projects. Each game should be in its own subfolder with an index.html file as the entry point. The Games page will use this path to load and preview your games.

Games Folder Path

── Example Games Folder Structure ──

📂 C:\Users\YourName\Games\
   ├── 📂 my-platformer/
   │     ├── index.html ← Entry point (required)
   │     ├── game.js
   │     └── 📂 assets/
   ├── 📂 space-shooter/
   │     ├── index.html
   │     └── ...
   └── 📂 puzzle-game/
         ├── index.html
         └── ...

💡 Tip: The Games page has its own server script generator. Use the path you enter here when setting up the games server on that page.

Download Server Script

Download the server script for your operating system. This creates a local server that enables persistent storage.

Run the Server & Connect

Windows: Double-click the .bat file to start the server.

Mac: Run chmod +x ~/Downloads/sorceress-server.command in Terminal, then right-click → Open.

Linux: Run chmod +x ~/Downloads/sorceress-server.sh && ~/Downloads/sorceress-server.sh

⏳ Not connected. Start the server script and click Connect.

✨ Access Status

Loading access info...

🔑 Replicate API Key (Optional)

Required for AI features like image generation, video generation, and background removal.

Get your API key from replicate.com

📁 Data Folders Created

🖼️ Images
/sorceress-data/images/

🎬 Videos
/sorceress-data/videos/

🎨 Tilesets
/sorceress-data/tilesets/

✂️ BG Remover
/sorceress-data/bg-remover/

📐 Expander
/sorceress-data/expander/

⚙️ Preferences
/sorceress-data/prefs/

✨ SORCERESS