Web Tools · QGIS Agent Flow

QGIS Easy Agent — The Same QGIS Agent, With Nothing To Configure.

Type what you want in plain language — “buffer the roads layer by 50 m”, “fix the invalid geometries”, “what CRS is this project in?” — and the agent inspects your live project, proposes one action at a time, runs it in QGIS after you approve it, sees the result and keeps going until the task is done. No models to install, no API keys, no provider accounts: pick a speed and start. Included with KeoGeo Pro.

v2.3.0 · runs in your browser — one KeoGeo sign-in, no model setup · included with KeoGeo Pro (A$20/month)

QGIS Easy Agentv2.3.0KeoGeo Pro 9,850 of 12,000 credits
YouBuffer the roads layer by 50 m and add the result to the map.
Agent · plan1 · check the roads CRS and units  →  2 · run native:buffer at 50 m  →  3 · add the new layer and style it.
Step 1 · ran automatically
READ-ONLY · 0.96Jev: reads the layer only — no approval needed.
lyr = QgsProject.instance().mapLayersByName('roads')[0] print(lyr.crs().authid(), lyr.crs().mapUnits())
EPSG:7855 · DistanceUnit.Meters ✓
Step 2 · waiting for you
WRITES A LAYERCreates roads_buffer_50m as a new layer. Nothing existing is overwritten — reversible, but it changes the project, so it stops here.
processing.runAndLoadResults('native:buffer', {'INPUT': lyr, 'DISTANCE': 50, 'DISSOLVE': False, 'OUTPUT': 'memory:roads_buffer_50m'})
▶ Run in QGISSkipEdit
⚡ Fast⚖ Balanced🧠 Think deeper
Auto-run safe steps — read-only and reversible steps run without asking
Last reply: DeepSeek V4.1 Flash · Auto — Jev chose ⚡ Fast (93% sure) · 7.9k in / 0.6k out ·  3 credits

The agent console. Step 1 only reads the project, so it ran straight through; step 2 writes a layer, so it waits for your click — with the reason shown above the code.

What It Does

Two Steps To Start, Then Plan, Act, Check, Repeat.

Easy Agent is the hosted edition of QGIS Agent Flow. It runs the same agent core, with every setup decision already made for you:

  • Nothing to configure — no Ollama install, no API keys, no accounts with AI providers. The models run on KeoGeo's server and are billed to your KeoGeo Pro allowance of 12,000 credits a month. Run out before the reset? Top up 12,000 credits for A$20 from inside the app; top-up credits never expire.
  • One sign-in — your keogeo.io login is the only login; there is no account inside the app. Your remaining credits are always visible in the header and update after every reply.
  • You choose the model, or let Jev choose — leave the speed on ✨ Auto and Jev picks ⚡ Fast, ⚖ Balanced or 🧠 Think deeper for each request; or pin a speed; or pin the exact model from a list grouped by company — OpenAI (ChatGPT), Anthropic (Claude), Google (Gemini), Moonshot (Kimi), DeepSeek, Z.ai (GLM), Qwen, plus free models (Laguna, LongCat, Solar Pro, Step). Every model shows its price in credits per 1,000 tokens, and the list can be searched, filtered and sorted by price.
  • Every reply shows what it cost — the model that answered, why it was chosen, the tokens in and out, and the credits charged. Nothing is hidden in a bundle.
  • Approve every action — on by default, with a 12-step cap on automatic runs. The novice defaults are deliberately cautious.
  • The same hardened core — plan-then-act with pinned goals, automatic layer preflight (CRS, units, validity), loop and stall recovery, live documentation lookups, workflow playbooks, action history with undo, and audited PyQGIS export.
  • One download, once — a small bridge installer lets the app talk to your open QGIS. Run it once and QGIS connects itself from then on.
Example Outputs

What You Get Out Of It.

Agent Console

A conversation with the agent: plan, proposed action, approval, result — streamed, with the QGIS project state alongside.

Action History And Undo

Every action run in QGIS, newest first, with undo where QGIS supports it.

Audit Report

A checksummed record of the session's actions and results for review or QA.

PyQGIS Script

The session exported as a standalone PyQGIS script you can rerun without the agent.

Method & References

What The Agent Is Working From.

  • PyQGIS Developer Cookbook and API reference (docs.qgis.org, qgis.org/pyqgis) — patterns, algorithm IDs, console behaviour. The agent looks algorithm IDs up rather than guessing them.
  • QGIS Training Manual (docs.qgis.org) — the workflow sequencing behind the playbooks (modules 2, 5–8 and 18).
  • Live documentation tools — algorithm_help, pyqgis_help, web search and page fetch, so answers track the current docs.
  • Bridge pattern — Python http.server ThreadingHTTPServer with QTimer polling on the Qt main thread, loopback only. Nothing in your project is exposed beyond your own machine.
  • Model access — requests go through a metered KeoGeo proxy. The provider key lives only on the server, never in the page, so no key of yours is involved and none of ours is exposed.
Faster And Safer

How Jev Makes Every Session Quicker — And Harder To Break.

Alongside the language model that writes the plan and the code, Easy Agent runs a second, much faster kind of model: Jev, a decision model from TypeSafe AI. It does not write text. You give it a situation and typed questions, and it answers all of them at once, in tens of milliseconds, with a confidence score. Easy Agent uses it in two places:

  • Routing (Auto). With the speed on ✨ Auto, Jev reads each message and picks the speed for it: a straightforward one — “where is the layer panel?” — goes to the fast model; a projection problem or a PyQGIS traceback goes to Think deeper. It only acts when it is at least 60% sure (otherwise Balanced), and it never overrides a speed or a model you pinned yourself. The choice, and Jev's confidence, are printed under the reply.
  • Approval gating. Every step the agent proposes is checked before it runs. Jev classifies the code as read-only, reversible or destructive, and separately asks whether it could lose existing work and whether it actually does what you asked. Read-only and reversible steps run straight through; anything else stops for your approval, with the reason shown above the code. This is what turns “ask before every action” from a wall of identical prompts into a handful of prompts that matter.

What Jev is never allowed to do. A fixed list of dangerous patterns — deleting files or features, overwriting outputs, dropping fields, clearing the project, running system commands, sending data off the machine — always needs your click, whatever Jev says. Jev can only remove a click from a step that list has already cleared; it can always add one. If the check cannot run for any reason, the step waits for you. A model that decides things this fast can also be talked to through a layer name or an attribute value, and this is the reason it never gets the final say.

You can switch the auto-run off in the console and approve every step yourself; the dangerous-pattern list applies either way.

Data Security

Where Your Prompts And Project Details Go.

Easy Agent is a hosted service, and that has a cost you should weigh before using it on client work. Your messages, the agent's own notes, and a snapshot of the open project — layer names, CRS, field names, feature counts, and any file you attach — leave your computer. They go to KeoGeo's service and on to the model provider you pick (Nous Portal, which routes most models through OpenRouter to OpenAI, Anthropic, Google, Moonshot, DeepSeek, Z.ai, Qwen and others, typically on servers outside Australia). Each provider's own terms and data-retention rules apply to what it receives.

  • Stays on your computer: every PyQGIS step, which runs in your own QGIS through the local bridge. The service never connects to QGIS; your browser does.
  • KeoGeo keeps: your Pro status and a per-account credit counter for the month. Conversations are not stored on the server; the session autosaves in your browser and “Save session” downloads it as a file you control.
  • Never stored: passwords — sign-in is handled by keogeo.io and the app never asks for one.

If that is a concern, use QGIS Agent Flow instead. It is the desktop edition of the same agent — same core, same playbooks, same audit report — running on your own machine with a local model, so prompts, project details and data never leave your computer. It is a one-off purchase, and Pro members can put their A$50 credit toward it. The same notice is shown permanently inside Easy Agent, under the message box.

Limitations

Where It Stops, And What You Still Have To Check.

  • The agent runs real code in your QGIS project. Save and back up before a session, watch the action history, and leave “Ask before every action” on for anything risky.
  • Undo is best-effort: QGIS edits are not transactional and some actions (for example deleting a file on disk) cannot be reversed.
  • The app talks to a small bridge on localhost to reach your open QGIS. The first time, your browser asks once for permission to reach your local network — that prompt is the bridge, and it is expected.
  • QGIS must be open, with the bridge installed, before the agent can do anything. The bridge installer is a one-time download.
  • An active KeoGeo Pro subscription is required, and usage draws down the monthly allowance of 12,000 credits. The monthly allowance does not roll over; when it runs out the app offers a 12,000-credit top-up for A$20 (top-up credits never expire and are used after the allowance). Model list prices can change without notice — the app shows the current price table each time it opens.

All KeoGeo tools are provided for preliminary assessment and educational purposes. Results must be verified by a suitably qualified engineer before use in design or construction; the full disclaimer is inside the app and in our terms.

Opens in this tab with your KeoGeo sign-in — there is nothing separate to log in to. Not on Pro yet? See what KeoGeo Pro includes.