Rasterflow, Earth Intelligence & inference engine now in public preview Learn More

Wherobots for QGIS: Cloud-Scale Spatial Data, from Wherobots Labs

Authors

Wherobots for QGIS panel running spatial SQL with results on the QGIS map canvas

Wherobots for QGIS is a new plugin that connects QGIS to Wherobots Cloud. From a panel inside QGIS, an analyst can run spatial SQL against WherobotsDB, load the results as a map layer, push a local layer up to a Wherobots Iceberg table, and pull raster data into the canvas. 

Why Wherobots for QGIS: Eliminating the partitioning tax

GIS analysts hit the same wall in city after city. A workflow that runs fine on a neighborhood runs fine on a district. At state scale, it crashes or runs for hours. At country scale, the analyst has to write a loop, tile the data by county, process each tile, handle the features that fall on the boundary, reassemble the output, and discover the seam artifacts two days later. That loop is not the analysis. It is overhead that the existing tools and databases impose.

This is the partitioning tax. It is not a performance problem. It is an architectural one. Desktop GIS and single-node databases process data on one machine. When the data outgrows that machine, the analyst absorbs the cost: split the extent, manage the tiles, merge the results, debug the edges. Every time a parameter changes, run it again. Testing at city scale and assuming it generalizes is not a workflow, it is a bet.

The same constraint blocks AI coding assistants. Tools like Claude Code and Cursor are fluent at writing spatial SQL for a single-pass query. Ask one to scale a workflow from a county to a state and it generates a partition loop with no overlap buffer and no dedupe logic. The model does not know about edge effects. The developer still has to do the work.

Wherobots for QGIS is a new plugin that removes the wall on the QGIS side of the stack. An analyst writes spatial SQL in a panel inside QGIS. WherobotsDB executes it in the cloud across the full extent, whether that extent is a city block or a continent, with no partition logic in the query and no tile management by the analyst. The result loads as a map layer.

What the Wherobots QGIS plugin does

The panel has three tabs, plus a connection screen where you enter an API key and pick a region and runtime.

SQL Query

Write spatial SQL in a free-form editor, or switch to Browse Tables and pick a table from the catalog. Set a row limit. Check one box to restrict results to the current map extent. Results land in the QGIS project as a layer, ready for styling, joins, or export.

Upload

Select a vector layer in your project, give it a destination table name, and send it to Wherobots. The plugin creates the table and inserts the features in batches while QGIS stays responsive.

Raster

Run raster SQL with RS_ functions against raster tables. Use the current map extent as the bounding box. A query that returns RS_AsGeoTiff loads as a raster layer. A query that returns RS_Values gives you pixel values as a table.

The plugin runs on QGIS 3.22 through QGIS 4.0, covering both Qt5 and Qt6 builds.

One copy of the data across QGIS, notebooks, and AI coding assistants

Wherobots has one job in this picture: hold the data and run the compute. The interface should follow the person doing the work.

Today the same WherobotsDB tables are reachable from a Python notebook, a SQL client, a Python Job, the Wherobots CLI, and from AI coding assistants like VS Code, Cursor, and Claude Code through the Wherobots MCP Server. QGIS joins that list. The tables an analyst opens on the canvas are the same tables an agent queries through MCP. One copy of the data. No exports.

This is what making spatial accessible means in practice. An analyst who knows QGIS and knows SQL can now run a spatial join across hundreds of millions of records and see the result on a map, without standing up a cluster or learning a new interface. WherobotsDB, built by the original creators of Apache Sedona, handles the distribution, indexing, and coordinate systems underneath.

How to install the Wherobots plugin in QGIS

  1. Download the plugin zip from the Releases page and install it in QGIS under Plugins → Manage and Install Plugins → Install from ZIP.
  2. Install the wherobots-python-dbapi package into QGIS’s bundled Python. The README has a two-line snippet for the QGIS Python Console that works on every platform.
  3. Open the Wherobots panel from the toolbar or Web → Wherobots, paste your API key, and connect.

You need a Wherobots Cloud account. Start a free trial if you do not have one. The wherobots_open_data catalog, including Overture Maps, is a good first query.

Introducing Wherobots Labs

Wherobots for QGIS is the first project published under Wherobots Labs.

Labs is where Wherobots ships the projects that live at the edge of the platform: connectors, plugins, adapters, example pipelines, and skills for AI coding assistants. They are built by the solutions architects and customer engineers who work with Wherobots customers every day, and by community contributors.

Every Labs repository follows the same rules. It is public on GitHub under the wherobots organization with a labs- prefix. It is Apache 2.0 licensed unless noted otherwise. It has a README with a plain statement of support expectations, a CONTRIBUTING.md, and GitHub Issues enabled. It gets a security review before first release, and security fixes continue under the standard Wherobots security policy.

What a Labs project does not carry is a production SLA. You are responsible for confirming a project fits your use case before you rely on it, and you are free to fork it. A Labs project that earns adoption can graduate to a supported product surface.

More Labs projects are on the way. Browse them at here and open an issue or a pull request on any of them.

If you use QGIS and you have a dataset that stopped fitting on your machine, install the plugin and tell us what you build.

Key takeaways

  • Wherobots for QGIS connects QGIS to Wherobots Cloud, so an analyst runs spatial SQL against WherobotsDB without leaving the map.
  • The compute runs in the cloud. QGIS stays the place to view the answer. One copy of the data, no exports.
  • Three tabs: SQL Query, Upload, and Raster. The plugin runs on QGIS 3.22 through QGIS 4.0, on both Qt5 and Qt6.
  • The same WherobotsDB tables reach Python notebooks, SQL clients, the Wherobots CLI, and AI coding tools through MCP. QGIS joins that list.
  • Available today from the QGIS Plugin Repository. It needs a Wherobots Cloud account, with a free trial. It is the first release from Wherobots Labs.
Get Started with Wherobots

Frequently Asked Questions

What is Wherobots for QGIS?

Wherobots for QGIS is a plugin that connects QGIS to Wherobots Cloud. From a panel inside QGIS, an analyst runs spatial SQL against WherobotsDB, loads results as a map layer, pushes a local layer up to a Wherobots table, and pulls raster data into the canvas.

How do I run spatial SQL in QGIS?

Open the Wherobots panel, enter your API key, and pick a region and runtime. In the SQL Query tab, write spatial SQL in a free-form editor or switch to Browse Tables and pick a table from the catalog. Results land in the QGIS project as a layer, ready for styling, joins, or export.

Is the Wherobots QGIS plugin free?

Wherobots for QGIS is available from the QGIS Plugin Repository. As a Wherobots Labs project, its repository is public on GitHub and Apache 2.0 licensed unless noted otherwise. You need a Wherobots Cloud account to run queries, and a free trial is available.

Which QGIS versions does the plugin support?

The plugin runs on QGIS 3.22 through QGIS 4.0, covering both Qt5 and Qt6 builds.

Do I need to export my data to use it?

No. WherobotsDB holds one copy of the data. The tables an analyst opens on the canvas are the same tables reached from a Python notebook, a SQL client, the Wherobots CLI, and AI coding tools through MCP.

What is Wherobots Labs?

Wherobots Labs is the home for projects at the edge of the platform: connectors, plugins, adapters, example pipelines, and skills for AI coding assistants. Every Labs repository is public on GitHub with a labs- prefix, Apache 2.0 licensed unless noted otherwise, and gets a security review before first release. Labs projects do not carry a production SLA.

RELATED POSTS
VIEW MORE

RasterFlow is now available in Public Preview

RasterFlow makes planetary-scale earth intelligence workflows easy and costs predictable. We are excited to announce that RasterFlow is now in Public Preview, opening up the power of planetary scale Earth Intelligence to all Wherobots Professional Edition customers! RasterFlow let’s you solve complex monitoring challenges with vision-language models or tailored models for specific use cases, without […]

How Wherobots builds with NVIDIA to let AI see the physical world

The world and what happens in it is digitized by petabytes of raw and derivative spatial datasets of various data types and scales, and the potential for applying AI to it is immense. But the AI models and agents we use every day need connectivity to tools that turn this data into usable insights and relationships. Wherobots gives AI the ability operate on and understand raw physical-world data, and NVIDIA GPUs are core to it. Architecturally here’s how this works at a high level.

El Niño 2026, atmospheric rivers, and California’s burn scars: one SQL engine, two data models

7,713 mapped building footprints sit inside or within 500 m (1,640 ft) of the 42 Eaton basins USGS rates high hazard for debris flows, and 388 km (241 mi) of mapped road and path cross the low ground below the scar. WherobotsDB finds both in SQL: a join to the USGS basins for the buildings, and a raster vector join over elevation for the roads.

Orchestrating Wherobots Jobs from AWS Step Functions: A Reference Architecture

When the execution engine is loosely coupled with orchestration, the pipeline is blind while waiting for one fact: did the job finish, fail, or die? This was the case with jobs running inside Wherobots Cloud and the AWS pipeline launching it… That was not cool with me, so we designed a reference implementation using AWS […]