mkdocs/docs/en/user/quick-start.md
This page has one job: help you complete one real workflow with the shortest possible path.
!!! warning Prompt Optimizer does not include a ready-to-use model by default. Before your first run, configure at least one text model in Model Management, or analysis, optimization, testing, and evaluation will not work.
If you are not sure where to go next:
For most first-time users, the simplest path is:
Once that works, add a second text model only if you actually want side-by-side comparison.
See Model Management and Model Testing Strategy for more detail.
| Workspace | What you optimize | Main right-side input |
|---|---|---|
| System Prompt Workspace | roles, rules, boundaries, output policy | one test message |
| User Prompt Workspace | one direct task prompt | usually no extra input |
| Variable Workspace | a reusable prompt template | one set of variable values |
| Context Workspace | one target message inside a conversation | full conversation + shared variables + optional tools |
| Text-to-Image Workspace | image prompt | image model |
| Image-to-Image Workspace | image-to-image prompt | input image + image model |
| Multi-Image Workspace | multi-image relationship prompt | at least two input images + image model |
This is the most important product boundary in the app:
For the full boundary, see Testing & Evaluation.
In any text workspace, you can start with this sequence:
original / workspace / vN on the right| Your situation | Recommended path | Why |
|---|---|---|
| public HTTPS API only | Web / hosted version | simplest setup |
| Ollama, LM Studio, local network, internal API | Desktop app | avoids common browser CORS and mixed-content limits |
| self-hosted page plus MCP | Docker | packages the web UI and MCP together |
!!! warning The web version is not a built-in proxy layer. The browser still sends requests directly to the model service you configure.
Left side:
You are a technical support assistant. Answer user questions clearly.
Right-side test message:
My app crashes on Windows at launch. What should I check first?
Left side:
Write a poem about autumn.
No extra test text is needed on the right in this workspace. The user prompt itself is the tested object.
Left side:
An orange cat standing on a neon street in the rain, cinematic mood, rich detail, low saturation.
Then:
Open /#/image/multiimage.
Upload at least two images, for example:
Left side:
Use image 1 as the main character identity. Preserve the outfit style and material feel from image 2. Generate one cohesive new image instead of mechanically stitching the references together.
Then:
image 1 / image 2Xoriginal / workspace / vNNo. The browser still connects directly to your configured model service.
The most common reason is browser-side CORS or mixed-content restrictions. In those cases, the desktop app is usually a better fit.
Yes. Browser-side data is stored locally in the browser. Export from data management before clearing it.