KeoGeo — QGIS for the built environment
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.1.0 · runs in your browser — one KeoGeo sign-in, no model setup · included with KeoGeo Pro (A$20/month)

QGIS Easy Agentv2.1.0KeoGeo Pro 182k of 250k
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

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.
  • 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.
  • Three speeds — ⚡ Fast for quick answers, ⚖ Balanced for everyday GIS work, 🧠 Think deeper for hard multi-step analysis. Straightforward questions are routed to the quick model automatically, so the allowance goes further.
  • 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. Before each message goes to a model, Jev judges whether it is a quick question or real work. A straightforward one — “where is the layer panel?” — is sent to the fast model even if you had Balanced selected, so it answers sooner and costs fewer credits. It only ever moves a request down a tier when it is at least 80% sure, never up, and never off 🧠 Think deeper.
  • 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.

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 a monthly allowance. When it runs out you can top up or wait for the monthly reset.

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.