IntelliGeo is a QGIS plugin that facilitates interaction with Large Language Models in QGIS environment.
The plugin is in development phase. We have recently released version 0.0.2: IntelliGeo on QGIS Python Plugins Repository
Welcome to the IntelliGeo repository.
This is the central hub where our team (Mahdi Farnaghi, Gustavo García, Zehao Lu）, in collaboration with the community, develops the IntelliGeo software. Here you'll find the source code and issue tracker for the project.
The code is released under the Apache 2.0 license.
IntelliGeo is a QGIS plugin that leverages Large Language Models (LLMs) to automate geospatial workflows.
Designed for GIS professionals, it assists users by automatically operating QGIS software through two primary methods: generating PyQGIS scripts or creating graphical models. This AI-powered tool streamlines complex GIS tasks, enabling users to efficiently design and execute geoprocessing workflows without extensive manual coding or model building. By integrating seamlessly with QGIS, IntelliGeo enhances productivity and simplifies the execution of sophisticated geospatial analyses.
- Seamless integration with QGIS
- LLM-powered geoprocessing workflows
- Collaborative modeling between AI and human experts
There are two ways to install the IntelliGeo plugin: via the QGIS plugin hub or by installing it from the source.
Install from plugin hub:
In QGIS, click on plugins->Manage and install Plugins, In the search bar, type "IntelliGeo", locate the plugin and click on Install Experimental Plugin.
Install from source:
- Visit the IntelliGeo GitHub repository and download the latest release of the plugin as a ZIP file.
Install via QGIS Plugin Manager:
- Open QGIS.
- Go to
Plugins>Manage and Install Plugins. - Click the
Install from ZIPbutton. - Browse to the location where you downloaded the IntelliGeo ZIP file and select it.
- Click
Install Plugin.
Activate the Plugin:
- Go to
Plugins>Manage and Install Plugins. - Find IntelliGeo in the list and check the box next to it to activate the plugin.
Note
In some cases, you may need to install the dependencies manually. We are working on fixing this issue, but some users may still need to take this step.
For Linux or macOS, use pip to install the Python dependencies listed in the requirements.txt file.
For Windows, ou can use the OSGeo4W shell, which comes with QGIS. First, open the OSGeo4W shell (found in the QGIS installation folder). Then, use the pip command to install packages listed in the requirements.txt file., just as you would in a regular Python environment, by running pip install package_name. This will ensure that the packages are installed in the environment QGIS uses. For a step-by-step guide, you can watch this video tutorial that demonstrates the process in detail.
To use the IntelliGeo plugin, you need access to a large language model (LLM) via an API call. Currently, we support OpenAI and Cohere. Based on our experience, OpenAI’s models perform better, but they are not free. Cohere offers free access to their API calls, although their performance is not as high as that of OpenAI’s models.
Sign up for Chat GPT at https://platform.openai.com/signup?launch You can register using your email address or an existing Google, Microsoft, or Apple account.
After registration, you will go to to OpenAI dashboard https://platform.openai.com/api-keys to get your API key.
Create a new ChatGPT API key by clicking on API Keys to access the API Keys page. Then, click + Create new secret key and enter an optional name in the popup. Click 'Create secret key' to generate your unique alphanumeric API key. Be sure to save it somewhere safe.
The ChatGPT API key is universal for all models; you do not need to create separate keys for each one.
Copy the API key and enter it when creating new conversations. The key will be stored only in your local database; IntelliGeo backend does not store or access your key.
Sign up for Cohere at https://dashboard.cohere.com/welcome/register You can register using your email address or an existing Google, or github account.
After registration, Once logged in, navigate to the API Keys section.
Create a new Cohere API key by clicking on API Keys to access the API Keys page. Then, click + New Trial key and enter an optional name in the popup. Click 'Create secret key' to generate your unique alphanumeric API key. Be sure to save it somewhere safe.
The Cohere API key is universal for all models; you do not need to create separate keys for each one.
Copy the API key and enter it when creating new conversations. The key will be stored only in your local database; IntelliGeo backend does not store or access your key.
After setting up your API key, you can now use the IntelliGeo plugin. Clicking on the IntelliGeo icon will open the chat interface. To start chatting and experience the powerful AI-driven geo-workflow, you can follow the video tutorial.
BufferExample.mp4
IntelliGeo offers a chat interface that allows users to input requests and receive either PyQGIS code or a graphical model. This output can be used to execute QGIS operations directly.
Important
To use the IntelliGeo plugin, you need to select a desired LLM provider and provide an API key (we won’t take your key!). For OpenAI, log into your account and visit the provide link. For Cohere, visit the this link.
If you encounter any issues while using IntelliGeo, please report them on our GitHub repository. Your feedback helps us enhance the plugin and provide a better experience for all users. To submit a bug report or feature request, visit our GitHub Issues page.