Activate Your License & Connect Your AI
Video tutorial: Watch the onboarding walkthrough on YouTube.
Setting up the app takes two one-time steps: activate it with a license key, and connect the AI account that powers generation.
Activate Your License
Section titled “Activate Your License”Coloring Book Engine runs on a license key — either a trial key (free, from coloringbook.dev) or a full license. After a purchase, your key arrives by email, together with the download link:

When the app first starts, the Activate Your License dialog asks for that key:

- Paste your License Key.
- Optionally give this computer a Device Name (handy later if you use more than one machine).
- Agree to the End User License Agreement and press Activate.
Don’t have a key yet? The Get a Trial Key link in the dialog takes you straight to the free trial.
Once activated, the license panel (Settings → License) shows your Plan, how many Devices are in use, and the expiry (Lifetime for a full license):

A few things worth knowing:
- Trial keys unlock the full workflow with some limits (such as the number of pages per project). Everything in this handbook works on a trial.
- Device seats — your license allows a set number of devices. If you hit “Maximum Activations Reached”, open Manage Devices and Deactivate a machine you no longer use, then activate the new one. Moving to a new PC is exactly this: deactivate old, activate new.
- Upgrading from trial to full is the same dialog with your new key.
CBE Setup
Section titled “CBE Setup”After activation, CBE Setup opens once. GPU detection runs while you choose your profile. The GPU result and Local AI download share one stage; if detection fails, answer the hardware question yourself. Next becomes available when Local AI is ready, and you can skip a setup stage to configure it later. Artist and Publisher profiles also guide you through connecting an OpenAI API key. The final recommendation is 0 Cost for Hobbyist & Educator, Quality for Artist, or Publisher for Publisher; without an eligible GPU, Publisher is recommended for every profile. Applying a recommendation requires its selected routes to be ready. Hover a disabled Use button to see what is missing.
- Hobbyist & Educator — Create coloring books for personal use and education as often as you like with your GPU, at no additional cost.
- Artist — I have some or all of my artwork ready and want to turn it into a finished coloring book.
- Publisher — I want to create coloring books for commercial use and am willing to invest in better quality and productivity.
Local AI models
Section titled “Local AI models”New installations use Qwen3.5 4B for planning, writing and image understanding. It has two files, about 3.2 GiB. FLUX.2 Klein image generation keeps its three components, about 7.3 GiB: five component files, about 10.5 GiB in total, plus the runtime and project data. Verified installed files are reused. Downloads try the pinned Unsloth GGUF source first, then CBE’s mirror, and check SHA-256. Existing Qwen3 users can keep text-only planning or choose the recommended upgrade. A successful upgrade removes obsolete standalone language files while retaining the shared FLUX prompt encoder.
Local AI targets a supported GPU with at least 8 GB of available GPU memory. Apple Silicon uses a unified-memory budget rather than dedicated VRAM. A successful hardware check does not guarantee every workload on every 8 GB device.
Connect Your AI
Section titled “Connect Your AI”Open Connect Your AI from Projects or the Go to AI settings button in Settings. The old Settings → AI tab is grayed out. Each task has radio choices for Local, OAuth and API; unavailable choices stay locked. API choices retain their orange accent. The final setup recommendation shows Local and API columns. Presets prefer Local for their free tasks and use OAuth when Local is unavailable; an existing task selection does not switch automatically after a failure.
Local generation does not consume API credits. Plan chat, image analysis and project drafting also follow Plan & Text; they incur provider usage charges when API is selected. Presets select routes, while Cost / Quality controls image-generation quality. Estimates vary with model, pages, references and retries.
On the Projects screen, choose Connect Your AI, pick your provider, and paste your API key — OpenAI or Google AI for the image-generation stages (a Get API Key link takes you straight to your provider’s key page):

Don’t have a key yet? Grab one from your provider’s official page — it takes a couple of minutes:
Two things worth knowing:
- Your API key is stored locally on this PC and used only to send requests directly to the provider you choose.
- Your own artwork can be the starting point of the workflow. Connect a generative AI, though, and Coloring Book Engine becomes more than an image generator — it becomes the execution environment that turns the coloring book in your head into a ready product, starting at the planning stage. Because the AI can carry the work forward through every production stage, we recommend the latest top-tier model for the full workflow.
