Support #15439

Migration to "Gisaf NG"

Added by Philippe May about 1 month ago. Updated 30 days ago.

In Progress
Target version:
Start date:
Due date:
% Done:




I have installed last night (20/4/2024) "the" big update for Gisaf, that i worked on these past few months. We can call it "Gisaf NG" (New Generation) in our exchanges.

I checked that most of Gisaf runs as usual (map, dashboards, measures, admin). But there are quite a few things that i still need to fix, some of them i know, and probably others that i haven't noticed yet.

In the next few days i'll fix those that i already noticed - please bear with me as i'll be traveling a bit. You can add the issues that you notice here.

Some technical details

There are 2 main updates in the underlying code that Gisaf is made of.


See It does the main job of handling HTTP requests following a clean standard called OpenAPI (see

This replaces GraphQL (, another standard that was used by the "old" Gisaf. OpenAPI is much easier to deal with in general, lightweight, and can integrate more easily with other tools.

FastAPI provides a handy tool for exploring the functions provided by the server side of Gisaf: see .

Because of that radical change on the server side, i had to completely revamp the client, migrating all GraphQL calls to OpenAPI ones. This usually does not change anything to the user experience.

One notable exception is the "login" (or logout), that now pops up a dialog, Once logged in (or logged out), the user interface shows (or hides) the functions that the user is allowed to perform, without the need to refresh the page.

It's worth noting that there's another small component that greatly simplifies the development of the client, thanks to OpenAPI: .


See, This was the initial motivation for that big update, as this allows Gisaf to drop Gino (, a core library which is clearly not maintained anymore.

SQLModel interfaces with the database in a very neat way, using new Python capabilities that were not available when Gisaf was initially developed. Beside, SQLModel is really well integrated with FastAPI.

The result is a much more straightforward integration between the database, the server, the API interface and the final user interface.

Hosting the code

The new version of Gisaf is now split in 2 separate new repositories (client and server). There are hosted in a public portal:

For CSR Geomatics (models and extensions), there are 2 more repositories:


#1 Updated by Philippe May about 1 month ago

  • Description updated (diff)

#2 Updated by Philippe May 30 days ago

Download of layers (gpkg and DXF) fixed

Also available in: Atom PDF