qgis-process

Execute QGIS Processing algorithms from the command line with JSON I/O.

49|9|Updated Mar 9, 2026
One-click install
npx skills add https://github.com/znlgis/opengis-skills --skill qgis-process
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: qgis-process
Source: https://github.com/znlgis/opengis-skills/tree/main/qgis-process
Command: npx skills add https://github.com/znlgis/opengis-skills --skill qgis-process

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Enables running QGIS Processing algorithms and models from the command line without launching the QGIS desktop, removing the need for manual GUI interaction and enabling automation on servers and CI pipelines.

Core Features & Use Cases

  • Command-line execution: Run built-in algorithms, plugin-provided algorithms, processing models, and Python scripts entirely from the CLI.
  • Machine-friendly I/O: JSON-formatted help and execution output for deterministic parsing and AI-driven automation.
  • Headless & CI use: Designed for headless servers and automation pipelines with options to disable Python, skip loading plugins, and accept complex parameters via STDIN JSON.
  • Common workflows: Batch buffering and dissolve, raster clipping and slope analysis, format conversion and reprojecting, and exporting print layouts via a project file.

Quick Start

Use qgis_process to list available algorithms, inspect an algorithm's JSON help to build parameters, and run the algorithm with JSON inputs to produce structured results and output files.

Frequently Asked Questions about qgis-process

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I run QGIS geoprocessing algorithms from the command line without launching the desktop GUI?

You can execute QGIS geoprocessing algorithms from the command line using headless processing, which runs built-in tools, models, and scripts entirely without the QGIS desktop GUI. This enables automated server-side workflows.

Can I use QGIS processing models and scripts in a CI/CD pipeline for batch GIS tasks?

Yes, QGIS processing models and scripts can be used in a CI/CD pipeline for batch GIS tasks. The command-line tool is designed for headless servers, accepting complex parameters via STDIN JSON and outputting structured JSON results.

Does headless QGIS processing support JSON input and output for automated workflows?

Headless QGIS processing supports JSON input and output for automated workflows. It provides JSON-formatted help and execution output, and accepts complex algorithm parameters via STDIN JSON for deterministic parsing and AI-driven automation.

What is the best way to automate raster clipping and format conversion on a headless server?

The best way to automate raster clipping and format conversion on a headless server is using command-line QGIS processing. It executes these tasks without GUI interaction, supporting batch processing and automated GIS workflows.

Do I need QGIS installed to run qgis_process commands for geoprocessing?

Yes, you need QGIS 3.16 or later installed with the qgis_process executable available in your system PATH. This environment setup is required to execute processing algorithms, models, and scripts from the command line.

Can I disable Python and skip loading plugins when running QGIS algorithms from the CLI?

Yes, you can disable Python and skip loading plugins when running QGIS algorithms from the CLI. The command-line processor includes options to bypass plugin loading, ensuring isolated and deterministic execution in CI pipelines.