Honua
// qgis plugin · v0 preview

Honua QGIS Plugin.
Local-first GIS assistant workflows.

Honua GIS Assistant is an early-preview QGIS plugin for private/local assisted GIS workflows. The current 0.1.0 build ships a toolbar action, right-docked chat/control panel, local Ollama model refresh, streamed generation, cancellation, local audit JSONL, default-off remote endpoint settings, and a bounded PyQGIS query bridge.

The plugin is self-contained, GPL-2.0-or-later, and account-free for local use. It sends no network telemetry; local model calls go only to the configured Ollama endpoint, and remote calls happen only when an operator intentionally enables a non-local endpoint.

View GPL repo Check releases Install path Media status release ZIP and demo media are pending owner handoff
honua_gis_assistant EARLY PREVIEW
Plugin repo honua-io/honua-qgis-plugin
License GPL-2.0-or-later
Current version 0.1.0 preview
QGIS target 3.34+
Release ZIP Pending GitHub Release
Current UI Docked chat/control panel
Implemented bridge Vector-layer query
Default privacy Local-first, no telemetry
// screenshots & demo

Proof media stays tied to released behavior.

The plugin repository defines the screenshot targets, but the binary screenshots, demo poster, and demo video are not published yet. This page keeps the public media slots visible without inventing product proof.

Pending screenshot: docked chat panel with a local Ollama model selected. Capture after release media handoff.
Pending screenshot: the bounded query tool returning sample vector-layer attributes.
Pending screenshot: optional OpenAI-compatible endpoint settings with remote mode clearly off by default.
Pending screenshot: local JSONL audit folder and enable/disable controls in the plugin UI.
demo video pending

Demo embed will publish when source media is supplied.

No self-hosted .webm, .mp4, or poster asset is currently available in this site repository or the plugin repository. When supplied, it should be committed under assets/qgis-plugin/ and embedded with native <video controls preload="metadata">.

View plugin media checklist
// install path

Install through QGIS Plugin Manager once a ZIP is published.

The public repository can build a QGIS-installable ZIP, but there is not yet a GitHub Release asset or approved QGIS Plugin Repository listing.

01 · Requirements
Use QGIS 3.34 or newer. The plugin is pure Python and uses the PyQt5/PyQGIS bindings shipped with QGIS.
02 · Get the ZIP
For release installs, download honua_gis_assistant-<version>.zip from the GitHub Releases page once the release owner attaches it. Until then, the source repo is the handoff point.
03 · Install from ZIP
In QGIS, open Plugins -> Manage and Install Plugins -> Install from ZIP, select the downloaded archive, and enable Honua GIS Assistant.
04 · Open the panel
Use Plugins -> Honua GIS Assistant -> Show Panel. The preview dock opens the local Ollama chat/control panel with model refresh, prompt streaming, cancellation, and local audit controls.
05 · Keep the endpoint explicit
Use local mode by leaving remote endpoints off. Configure only the operator-owned HTTP endpoint you intend to use; non-loopback Honua-compatible or OpenAI-compatible endpoints send context to that operator.
current release boundary
status: 0.1.0 early preview
ships_now: toolbar, menu, docked chat panel
bridge_now: vector-layer query tool
model_calls_now: local Ollama from QGIS UI
local_model_path: Ollama over configured HTTP(S)
fallback_model: qwen2.5-coder
future_preference: Honua-GIS beta when available
remote_endpoints: optional, off by default
release_zip: pending GitHub Release

Maintainer builds use the plugin repository packager. This site intentionally avoids publishing local build commands as an end-user install path until a release artifact exists.

// privacy & model boundary

Anonymous and local-first by default.

Default mode No Honua account required.

Local use does not require signup or a Honua login. The preview does not send analytics, crash reports, prompts, responses, project files, layer data, or audit records to Honua. Local model requests go only to the configured Ollama endpoint when the operator refreshes models or sends a prompt.

Account-free local usev0
No network telemetrydefault
Local model path Ollama stays on loopback.

The local generation path talks to a configured Ollama server over HTTP, defaulting to loopback. Until the Honua-GIS beta model is published, qwen2.5-coder is the documented fallback model.

Loopback HTTP boundaryimplemented
Honua-GIS beta preferencefuture
Remote mode Operator-configured only.

Optional OpenAI-compatible remote endpoints are available, off by default, and change the privacy boundary. Remote usage is governed by the endpoint operator's terms, logging, retention, billing, and data-handling rules.

Remote endpoint callsopt-in
Provider policy appliesoperator-owned

See the site privacy notice for honua.io analytics consent. The plugin's local-first privacy boundary is separate from this website's consent-gated analytics.

// boundaries

What this page does and does not claim.

Area Current public wording Boundary
Repository Dedicated public plugin repository under honua-io/honua-qgis-plugin. GPL-2.0-or-later, self-contained plugin repo.
Release 0.1.0 early preview; release ZIP pending. Do not say "download now" until a GitHub Release asset exists.
QGIS endorsement QGIS 3.34+ plugin target. No QGIS project endorsement, certification, or marketplace approval claim.
Assistant behavior Docked local chat/control panel, local audit controls, remote endpoint settings, and bounded query bridge exist. Do not claim QGIS Processing toolbox actions or marketplace approval.
Model availability qwen2.5-coder fallback until Honua-GIS beta is available. Do not imply a Honua-GIS model is bundled or auto-downloaded.

Honua is not affiliated with, sponsored by, or endorsed by the QGIS project.

// related paths
docs Run Honua locally Start the server, hit readiness, and make an authenticated SDK call. Open quickstart ai AI-ready GIS How Honua treats AI as a workflow primitive across analysis, maps, reports, and DevOps. Read the AI pillar claims Public wording rule Preview and proof-media caveats for the QGIS plugin page. Open claims row
// next

Try the source.
Keep the privacy boundary explicit.

View plugin repo Talk to us