AI Offline Studio
Create AI photo templates that run on the booth computer, with no internet and no cost per photo.
AI Offline Studio turns guest photos into new AI pictures right on the booth computer. There is no internet needed during the event and no cost per photo, so it is ideal for venues with poor Wi-Fi and for events with many guests.
Chapters (8)
Chapters (12)
AI Offline or AI Online?
| AI Offline | AI Online | |
|---|---|---|
| Where the AI runs | On the booth computer | On an online AI service |
| Internet at the event | Not needed | Required, and it must be stable |
| Cost per photo | None | Charged by the service for every generation |
| Hardware | NVIDIA RTX graphics card | Any computer that runs Q-Booth |
| Output | Pictures (plus a Before → After video) | Pictures and AI videos |
AI Offline runs a model on the booth computer; AI Online runs much larger models in the cloud, and those give clearly better results. How they compare:
- Text to picture (Imagine): AI Offline does this very well.
- Changing a guest's photo (Re-Imagine, Re-Imagine + Reference, Composite): the results are good, but not as good as AI Online. Making the result match the guest's photo or a reference picture closely is harder and needs a well-written prompt. An outfit change always changes the outfit, but how close it gets to the outfit picture depends on that picture and on how complex the outfit is, so test with real photos before the event.
- When the result must look just like the guest or the reference: AI Online is the better choice. For a face that must stay exactly the same, Face Swap keeps it.
- Where AI Offline wins: no internet needed, no cost per photo, and nothing leaves the booth computer.
- Speed depends on the computer. On a healthy desktop with an RTX 4060 or better it is usually under 20 seconds a picture. Older cards (RTX 2060, 3060) are slower. A laptop must be plugged in to charge while generating, or it runs much slower. Keeping the Q-Booth folder on an SSD helps a lot, and other programs running at the same time slow it down. A faster card makes AI Offline faster, but the quality of the result comes from the model, not the card.
A Pro licence includes AI Online as well (paid per use with tokens), so you can choose online or offline for each template.
Requirements
- Licence: the AI templates (Imagine, Re-Imagine, Re-Imagine + Reference, Composite) need a Pro licence. Face Swap also works with an Advanced licence. An Advanced licence sees only the Face Swap template in AI Offline: the other templates don't appear in the template list or the gallery. Basic licences don't get AI Offline at all.
- Graphics card: an NVIDIA RTX card with at least 8 GB of VRAM. 8 processor cores and 16 GB RAM or more are recommended. See System requirements.
- Disk space: the offline AI models need tens of GB on top of the app.
- GPU Pack: to run Face Swap and Face Restore on the graphics card, download the GPU Pack in Settings › Advanced › Compute Device. See Advanced settings.
The AI Offline Server
The AI engine starts together with Q-Booth. Its status is shown at the bottom of the sidebar as AI Offline Server:
| Status | Meaning |
|---|---|
| Loading | The engine is starting. This usually takes a minute or two. |
| Online (green) | Ready. You can process AI templates. |
| Offline (red) | Not running. AI templates cannot be processed. |

Face Swap does not use the AI Offline Server: it can process even when the status is Offline. All other AI Offline templates need it to be Online, and so does a Collage, Lenticular or Motion template that contains one. Otherwise Process stops with "AI Offline server is not online. Check the sidebar status pill — it must be green before processing." If it stays red, update the NVIDIA driver to the latest version and restart the PC first, see If the server stays Offline.
Hover over the box to see the full status. The box only shows on a Pro licence, and only in Expert mode: it is hidden in Easy mode. Advanced licences don't have it, because Face Swap doesn't use the server.
The Server Log window
Double-click the AI Offline Server box to open the Server Log window, which shows what the engine is doing. It has Start Server and Stop Server to start or restart the engine by hand, plus Copy Log, Export to File and Clear. Closing the window only hides it; the server keeps running. (If the server is set to an external setup, Start and Stop are not shown.)
If the server stays Offline
Wait a couple of minutes after opening Q-Booth first. If the box never turns green:
- Update the NVIDIA driver to the latest version first. This is the most common cause. Download the driver for your card from nvidia.com (or update it in the NVIDIA app), install it, and restart the PC. The AI engine needs driver 580 or newer. To see which driver you have, type
nvidia-smiin Command Prompt: the top line shows "Driver Version". - Open Q-Booth again, double-click the AI Offline Server box, press Start Server and watch the log.
- Check that the computer really has an NVIDIA RTX card, close other heavy programs to free memory, and make sure security software isn't blocking Q-Booth.
- Only if it still stays Offline after the driver update: press Export to File in the Server Log window and send the log to support.
It worked before, but after a restart it goes Offline every time? If the Server Log shows "only one usage of each socket address" or "error while attempting to bind on address ('127.0.0.1', 8188)", the old AI engine is still running in the background and blocks the new one. Close Q-Booth, open Task Manager and end every python.exe (or just restart the PC), then open Q-Booth again and wait for Online. Fixed in 5.9.6.1: restarting the server now closes the old engine first.
Choose an AI template
- Open Studio › AI Offline (or Create in Studio › AI Offline from an event).
- Click the Template button at the top of the middle panel. The Select AI Template dialog opens.
- Click a template in the list. On the right you see a preview and its details: Name, Version, ID, Model, Available for Event and Description.
- Click Use Template. When a ready-made sample exists, a Load Sample button also appears: it loads a complete example template you can study or change.

The AI template types
| Template | What it does | Needs a guest photo |
|---|---|---|
| Face Swap | Puts the guest's face into a scene picture. Explained in its own article: Face Swap. | Yes |
| Imagine | Creates a picture from text only. | No |
| Re-Imagine | Changes the guest's photo according to your prompt and keeps their faces. The right choice for most events. | Yes |
| Re-Imagine + Reference | Like Re-Imagine, plus a reference image that the AI follows for style, costume or composition. | Yes |
| Composite | Puts the guest into a background you choose, then uses AI to blend it so the light and edges look natural. | Yes |
Imagine can't be used in an event, because there is no guest photo to put in. The event editor refuses it with "This template can't be used in an event. Only templates that take the captured photo as a source qualify…" All the other templates can.
Picking a template resets the Aspect Ratio to Auto and the Quality to the template's default.
Build a Re-Imagine template step by step
- Check that AI Offline Server shows Online.
- Choose Re-Imagine in Select AI Template.
- In Source Image, click Select Image and load a test photo (Camera, Clipboard, Gallery or File).
- Open the Prompt tab, keep Basic and write your prompt as an instruction (see the example below).
- Set Quality with the slider.
- Set Aspect Ratio in the left panel. Auto keeps the shape of the photo.
- Press Process (F5). After a short wait the result appears; check it with Compare.
- Add a frame under Overlay and, if you like, turn on Before → After Video under Options.
- Fill in Caption and Cover image under Event, then click Save. AI Offline templates are saved as
.qsdfiles.

Example prompt that keeps the guests as they are, for one person or a whole group:
Change the clothes of the people in this photo to elegant 1920s Great Gatsby evening wear, and change the background to an empty Art Deco ballroom with gold chandeliers, warm golden light and falling confetti. Keep the same people, the same number of people, their faces, poses and positions unchanged. Do not add anyone.
Write Re-Imagine prompts as instructions ("change the clothes…, change the background…, keep the same people…, do not add anyone"). A purely descriptive prompt can make the AI add extra people or change faces. More advice in Writing good AI prompts.
The Prompt tab
| Control | What it does |
|---|---|
| Basic | One fixed prompt for every guest. |
| Dynamic | A prompt with blanks that guests fill in by answering questions. Build it with Dynamic Prompt Editor (called Prompt Builder before 5.8.0.0). See Dynamic Prompt. |
| Prompt Library | Your saved prompts: pick one to use it, or save the current one for later. |
| Prompt Builder | Since 5.8.0.0, for Basic prompts: builds the prompt by picking from lists instead of typing. Same window, language choice and lock / Unlock as in AI Online Studio. Only on templates that take a prompt. There is no reference-image section here: in AI Offline the template itself decides what a reference image is used for. |
There is one prompt box; there is no separate negative-prompt box. With Dynamic, the box shows a read-only preview, and when you press Process (or a guest uses the template) a window asks the questions first.
Quality
The Quality slider (middle panel, under Template) has four levels: Low, Medium, Good and High. Shipped templates start at Good. Higher looks better but takes longer, and guests are waiting at the booth. Choose the highest quality whose waiting time is still comfortable, and time it on the event computer.
Reference, guide and background images
Depending on the template, extra tabs appear in the middle panel:
| Tab | What to put in it |
|---|---|
| Reference Image | Re-Imagine + Reference: the image whose style, costume or composition the AI should follow. Required as soon as the tab is shown. |
| Guide Image | Composite: a PNG with transparent areas, for example a frame, props or a cut-out figure. It is laid over the guest, full frame, and stays visible in the result (then blended in by the AI). Must be a PNG file, so only gallery and file are offered (Camera and Clipboard can't keep the transparency). Required when the tab is shown. When the photo is taken in the studio, the camera window shows the guide over the live view so the guest can line up. |
| Background | Composite: the scene picture the guest is placed into. Required. On the other templates (since 5.6.0.2) this tab is an extra step on the finished picture: Original, Remove BG or Change BG, with the same Model (Standard / Detailed) and Outline choices as Photo Studio. |
| Color Correction | Five sliders for the final look, each from -100 to +100 (0 = no change): Temperature, Hue, Brightness, Contrast, Saturation. |
Do not confuse Guide Image with Background: the guide image is laid over the guest and shows in the result, while the background is the scene behind them. If a required image is missing, Process and Save show a message telling you which tab to fill in.
Composite
Composite puts the guest into your background and uses AI to blend and relight it, with a prompt, guide image and colour correction. The older Composite (Raw) template, which only cut the guest out and laid a guide and background over them with no AI, was removed in 5.6.0.2. To get that result, use Photo Studio: Background › Change BG plus Guide Image pictures set to Camera + Result.
Output options
| Setting | What it does |
|---|---|
| Aspect Ratio | The shape of the result. Auto keeps the shape of the guest's photo (for Imagine, which has no photo, the template's own default shape). When a shape is picked, the camera window shows a guide of that shape while the photo is taken. |
| Overlay | Default (the global overlay from Settings, or the event's inside an event), Custom (a frame just for this template) or Disabled. Since 5.9.6.1, with Custom, the Put the photo inside the frame's window switch puts the result inside the frame's window instead of under the whole overlay, for AI and Face Swap templates alike; see Put the photo inside a frame. The Include original photo and Before → After Video overlays have the same switch. |
| Include original photo in result | Delivers the guest's original photo as an extra result next to the AI picture. An Overlay choice appears for that photo: Disabled (default), Default (the same overlay as the result) or Custom. No effect on Imagine. |
| Before → After Video | Makes a short video that turns the guest's photo into the AI picture. Great for sharing on social media. Available for every template that uses a guest photo, including Face Swap; not for Imagine. Settings below. |
Before → After Video settings
- Photo hold: how long the original photo shows, 0.5–6 s (default 1.5 s).
- Result hold: how long the AI picture shows, 0.5–6 s (default 2 s).
- Transition: Fade, Dissolve, Wipe Left, Slide Left or Circle Open.
- Overlay: the video's own overlay, Disabled, Default (the same overlay as the result) or Custom.

The file format follows the template; JPEG and video quality are set once for the whole app in Settings › Other.
Use it in an event
- Expert mode: in the event open Templates and click Open File to add the
.qsd, or Create in Studio › AI Offline to build it there and click Save & Return. - Easy Mode: the AI Photo offline card does the same in one dialog, and Try it runs a test photo. Since 5.8.0.0, Build my prompt above the prompt box opens the Prompt Builder.
At the event the guest picks the template and takes a photo; the booth computer creates the picture and the result is shared as usual (for example with a QR code). See Templates and Run an event.
Messages you may see when the event opens or runs:
| Message | What it means |
|---|---|
| "Some templates use AI Offline and need the local AI engine, which is not ready." | Shown in Before You Start when an event opens and the AI Offline Server isn't Online yet. Wait for it, or press Start Anyway. If it never turns green, update the NVIDIA driver first (see If the server stays Offline). |
| "The local AI engine is still starting up. Please wait a moment and try again." | A guest picked an AI Offline template while the server was still starting. |
| "This template runs AI Offline Studio, but the local AI engine is not available on this computer. It needs a Pro license and an NVIDIA RTX graphics card." | The computer has no AI engine (not Pro, or no RTX card). |
| "This template uses Face Swap, which needs an Advanced license or higher." | A Face Swap template on a Basic licence. |
Common problems
The server stays on Loading or shows Offline (red).
Give it a minute or two after Q-Booth starts. If it does not become Online:
- First update the NVIDIA driver to the latest version (580 or newer) from nvidia.com or the NVIDIA app, and restart the PC. This is the most common cause.
nvidia-smiin Command Prompt shows your version on its top line ("Driver Version"). - Open Q-Booth, double-click the AI Offline Server box, press Start Server and watch the log.
- Make sure the computer has an NVIDIA RTX card and enough free memory (close other heavy programs), and that security software isn't blocking Q-Booth.
- Only if it still stays Offline after the driver update: use Export to File and send the log to support.
See also Troubleshooting.
After a restart the server goes Offline every time ("only one usage of each socket address").
The old AI engine is still running in the background and blocks the new one. Close Q-Booth, open Task Manager, end every python.exe (or just restart the PC), then open Q-Booth again and wait for Online. Fixed in 5.9.6.1: restarting the server now closes the old engine first.
"AI Offline server is not online" when you press Process.
Wait for the green Online dot at the bottom of the sidebar. If it stays red, update the NVIDIA driver to the latest version and restart the PC first, then double-click the box › Start Server. Full steps: If the server stays Offline.
"This AI Offline template needs a Pro license to run."
Imagine, Re-Imagine, Re-Imagine + Reference and Composite need a Pro licence. With an Advanced licence only Face Swap is available.
I don't see the AI Offline Server box.
The licence isn't Pro, or the app is in Easy mode.
"The template '…' this file was saved with is no longer installed."
The .qsd was made with an AI template this computer doesn't have. Rebuild it with an installed template.
Where is Composite (Raw)?
It was removed in 5.6.0.2. Build the same thing in Photo Studio with Change BG and a Guide Image set to Camera + Result.
Processing is much slower at the event than in the studio.
During the event the camera and the event screens also use memory. Lower the Quality, close other programs, and always time a test run with the event launched, not only in the studio.
The result adds people or changes faces.
Rewrite the prompt as an instruction and end with "Keep the same people, the same number of people, their faces, poses and positions unchanged. Do not add anyone." If the face must stay exactly the same, use Face Swap or AI Online instead (see AI Offline or AI Online?).
Process or Save is blocked with "This template needs a guide image" (or reference / background image).
Open the tab named in the message and choose an image. Guide images must be PNG files.
Three things to remember
- Start Q-Booth early and wait until the server is Online.
- Pick a quality your guests will not mind waiting for.
- Test every template on a real photo, in the event, before the doors open.
Next steps
Still need help?
Our team answers on WhatsApp. Tell us your Q-Booth version and what you see on screen.