Version: 1.8.7
Author: Maxim Semenov
Website: smnv.org
Email: maxim@smnv.org
If this project helps your work, consider supporting future development: GitHub Sponsors or smnv.org/sponsor.
Release Date: May 9, 2026
License: MIT
GrokImagine is a ProcessWire module that allows you to generate high-quality AI images directly within your Pageimage fields using the x.ai (Grok) API.
Features
- Progressive Loading: Images appear one-by-one as they are generated.
- Batch Generation: Generate up to 4 variations at once with a single prompt.
- Smart Variations: Automatically adds subtle prompt differences to ensure variety in batch results.
- Format Support: Choose between 16:9, 1:1, 9:16, and 4:3 aspect ratios.
- Model Selection: Supports
grok-imagine-image-quality and grok-imagine-image. - Resolution Control: Toggle between 1k and 2k resolutions.
- Interactive UI: Preview results, select the ones you like, and save them directly to the page.
- System Prompt: Define a reusable base prompt in module settings, pre-filled into the input field on every page. Supports
%fieldname% placeholders (e.g. %title%) that are automatically resolved from the current page's field values.
Installation
- Upload the
GrokImagine folder to your /site/modules/ directory. - In the ProcessWire admin, go to Modules > Refresh.
- Find Grok Imagine and click Install.
Configuration
- Go to the module settings.
- Enter your x.ai API Key (obtainable at console.x.ai).
- Optionally set a System Prompt — a base context pre-filled into the prompt field on every page. Use
%fieldname% placeholders to inject page field values (e.g. Professional photo of %title%, white background). - Select which image fields should have the Grok Imagine interface enabled.
- Choose your preferred default model and resolution.
How to Use
- Open a page for editing that contains an enabled image field.
- Locate the Grok Imagine bar below the image field.
- The prompt field will be pre-filled with the system prompt (if configured). Edit or extend it as needed.
- Select your desired aspect ratio and quantity, then click Generate.
- Once images appear, click on the ones you want to keep (a blue checkmark will appear).
- Save the page to download and store the selected images.
License
MIT License - Free to use in personal and commercial projects.