AI Director

WokGen Eral

Eral is the WokGen AI director. Use natural language or WAP commands to plan projects, run multi-step generation workflows, and control every studio from a single chat interface.

1. What is Eral?

Eral is a conversational AI layer built on top of WokGen. It understands your creative intent and translates it into generation calls, project management actions, and platform navigation — all from a chat interface you can open in any studio.

Unlike a simple chatbot, Eral operates with agency. When you ask it to “create a full enemy character set for a dark fantasy RPG”, it does not just respond with suggestions — it plans the asset list, runs each generation, tracks the results, and assembles them into a project. This is the core of Director Mode.

Eral is powered by a selectable backend model (Groq / Gemini / Mistral) and has full awareness of your current project, selected studio mode, generation history, and saved palettes. It remembers context within a session and can be given persistent project context through the memory system.

→Open Eral from any Studio page by clicking the chat icon in the top-right corner, or press ⌘K (macOS) / Ctrl+K (Windows/Linux).

2. Director Mode

Director Mode is Eral's most powerful feature. It lets you describe a complete asset set in plain English and have Eral automatically plan and execute every individual generation step.

How it works

You describe what you want: “8-directional character sprite sheet for a fantasy RPG warrior, dark medieval style, consistent palette”
Eral analyses the request and creates a generation plan — a list of individual assets needed to fulfil the brief
You review and approve (or edit) the plan
Eral runs all generation jobs, parallelising where possible
Completed assets stream back to your workspace as they finish
Eral assembles the results and offers a single-click ZIP export

Activating Director Mode

Eral will auto-detect multi-step requests. You can also explicitly activate it:

/director create a complete UI icon set for a fintech app — 24 icons, line style, blue accent

Or just describe a complex brief naturally and Eral will propose the Director workflow if appropriate.

Example Director session

You: Create a top-down RPG enemy set — 5 enemy types, consistent palette,
     front-facing 32×32 sprites.

Eral: I'll plan this as 5 individual Pixel generations:
      1. Skeleton warrior (rpg_enemy, 32×32)
      2. Goblin archer (rpg_enemy, 32×32)
      3. Cave troll (rpg_enemy, 32×32)
      4. Witch (rpg_enemy, 32×32)
      5. Shadow dragon (rpg_enemy, 32×32)
      
      Shall I apply your "dungeon_palette" to all five? [Yes / No / Edit plan]

You: Yes

Eral: Running 5 generations... ████████░░ 4/5 complete

ℹDirector Mode works best with a connected project — Eral will use the project's palette and style settings automatically.

3. “Plan this project” Flow

The Plan this project command is a structured Director Mode entry point. It prompts Eral to ask a series of scoping questions, then produce a comprehensive asset plan for your project.

/plan

Eral will ask:

What type of project is this? (game, app, brand, website, etc.)
What art style or aesthetic are you targeting?
Which studios do you need? (Pixel, Business, Vector…)
Do you have an existing palette or reference image?
What is your delivery deadline / priority?

Based on your answers, Eral produces a prioritised asset list with suggested prompts, presets, and sizes for each item. You can run the full plan at once or step through it asset by asset.

→The richer the context you give Eral in the planning phase, the more consistent the output. Mention the colour palette, the target platform (mobile, PC, web), and any reference games or brands you want to evoke.

4. Memory System

Eral has two levels of memory: session memory (in-browser, lasts until page refresh) and project memory (persisted to your workspace, survives page loads).

Session memory

Within a single browser session, Eral remembers your entire conversation history, the last 20 generation results, and any palette or style changes you made. Session memory is cleared when you refresh or close the tab.

Project memory

When you connect Eral to a project with /project open {name}, it gains persistent memory for that project:

Project brief — a short description you set with /memory set brief "dark fantasy RPG, low-res 16-bit style"
Palette — saved colour palette applied to all generations
Style presets — default preset per asset category
Generation history — all past outputs with prompts and seeds
Asset checklist — Director-mode plans and their completion status

Setting a project brief

/memory set brief "2D side-scroller, NES-style 8 colours, action-platformer, 1990s aesthetic"

Eral reads the brief before every generation in this project and adjusts its prompting strategy accordingly — you no longer need to repeat the style context in every prompt.

Viewing and editing memory

/memory show       — display all stored project memory
/memory clear       — wipe session memory only
/memory clear all   — wipe session + project memory (irreversible)

5. Voice Mode

Voice Mode lets you talk to Eral using your microphone instead of typing. Click the microphone icon in the Eral chat panel (or press ⌥V / Alt+V) to toggle it.

Voice input is transcribed in real-time using browser-native speech recognition. Eral processes your spoken request identically to a typed one — you can trigger WAP commands, Director Mode, and generation entirely by voice.

Tips for voice input

Speak the asset description naturally — Eral infers style presets and sizes from context
Pause briefly before speaking to let the microphone activate cleanly
You can say “slash director” to trigger /director
Voice Mode works best in Chrome and Edge; Firefox support is partial

ℹVoice Mode is designed for hands-free generation workflows — useful when you are sketching or working in another application simultaneously.

6. WAP Commands

WAP (WokGen Action Protocol) commands are slash-prefixed shortcuts for the Eral chat interface. Type them exactly as shown.

Navigation

/go pixel — switch to Pixel mode
/go business — switch to Business mode
/go vector — switch to Vector mode
/go uiux — switch to UI/UX mode
/go docs — open the Docs Hub

Generation

/generate {prompt} — generate with current mode settings
/generate hd {prompt} — HD mode (uses credits)
/style {preset} — change active style preset
/negative {terms} — set negative prompt for next generation
/seed {number} — pin the seed for reproducible output

Director

/director {brief} — activate Director Mode with a brief
/plan — enter the guided project planning flow
/plan status — show current plan progress
/plan export — export all completed plan assets as ZIP

Batch

/batch {prompt} ×N — N variations (e.g. /batch robot ×4)
/batch csv — upload a CSV of prompts
/batch status — check last batch status

Project & memory

/project new {name} — create a project
/project open {name} — switch project
/project list — list all projects
/project export — download all project assets as ZIP
/memory set brief "…" — set project brief
/memory show — display project memory
/memory clear — clear session memory

Utility

/help — list all WAP commands
/clear — clear Eral chat history (session only)
/model {name} — switch backend model (groq | gemini | mistral)
/voice — toggle Voice Mode

7. Batch Generation

Batch mode generates multiple assets from a single command or a CSV file.

Inline variation batch

/batch Viking warrior sprite, front view ×6

Enqueues 6 parallel generation jobs with varied seeds. Results stream back as they complete.

CSV batch

Type /batch csv and upload a CSV file:

prompt,style,width,height,negative
fire sword,rpg_icon,32,32,blurry
ice staff,rpg_icon,32,32,blurry
poison dagger,rpg_icon,32,32,blurry

Eral processes each row as an independent generation. Optional columns will override the current studio settings for that row only.

⚠Each item in a batch counts as one generation against your rate limit. Large CSV batches (50+ rows) are processed in queued waves, not all at once.

8. Tips for Best Results

Give Eral rich project context

The single biggest improvement you can make is to set a project brief before starting work. Include: the genre or domain, the visual style, target platform, colour constraints, and any reference touchstones.

/memory set brief "Mobile endless runner, flat design, 3-colour palette (navy, orange, cream), inspired by Alto's Odyssey"

Be specific about what you want — not how to make it

Tell Eral what you need, not which tool to use. “I need five enemy sprites for a dungeon level” is more effective than “use the Sprite tool with the rpg_enemy preset five times”. Eral will select the right tool and settings.

Use Director Mode for sets, not singles

Director Mode has overhead (the planning phase takes a few seconds). For a single asset, just use the studio directly or type a plain /generate command. Director Mode pays off for 4+ related assets where consistency matters.

Review and edit the plan before running

Always review Eral's generation plan before approving it. The plan shows each prompt, preset, and size. Adjust anything that doesn't look right — it is much faster to edit the plan than to regenerate a misaligned asset after the fact.

Switch models for different tasks

/model groq — fastest, best for quick iterations and simple generation commands
/model gemini — best for complex planning, long project briefs, and Director Mode
/model mistral — strong at structured outputs and CSV batch planning

Keep session memory clean

If Eral starts giving inconsistent responses mid-session, use /clearto reset session memory and restate the project brief. Long chat histories can cause model context drift.

9. FAQ

Which AI model does Eral use?

Eral defaults to the fastest available model for your plan. Switch with/model groq, /model gemini, or /model mistral. All three backends are compatible with the free tier.

Does Eral store my chat history?

Session chat history is stored in your browser only and is not sent to our servers beyond the active API request. Clearing your browser data clears Eral's session memory. Project memory (brief, palette, plan) is stored server-side in your workspace.

Can I use Eral in self-hosted mode?

Yes. Set GROQ_API_KEY, GOOGLE_AI_API_KEY, or MISTRAL_API_KEY in your .env.local. Eral will use whichever key is present. See the API Reference for the /api/eral/chat endpoint specification.

Does Director Mode cost credits?

Director Mode itself is free — it is a planning layer that calls the generation API on your behalf. Credits are consumed exactly as if you had run each generation manually. If Director Mode runs 6 Standard generations, you use no credits. If it runs 6 HD generations, you use 6 HD credits.

Can Eral generate assets across multiple studios in one session?

Yes. Use /go {studio} to switch studios within an Eral session, or describe a multi-mode project in a Director brief and Eral will switch studios automatically as it works through the plan.

← Docs Hub API Reference →