Video: this flow built from an empty canvas, run, then its result inspected.
Features
- Formats, read and written: PostgreSQL/PostGIS, GeoPackage, Shapefile, MapInfo (TAB, MIF), DXF (AutoCAD), GeoJSON,
(Geo)Parquet (local or over https), FlatGeobuf, CSV with WKT or X/Y columns, Excel; Oracle and SQLite / SpatiaLite
databases. Formats
- About a hundred modifiers: attributes, filters, joins, statistics; vector geometry (buffer, clip, dissolve,
polygon overlay, spatial joins, reprojection with the IGN grids, validation…); rasters (GeoTIFF / COG, JPEG 2000,
NetCDF, STAC search; calculator, terrain analysis, contours, zonal statistics…). Catalogue
- Inspector: the output of any node on a table (column filters, sorting, SQL
WHERE) and a map (colors by
attribute, OpenStreetMap, satellite imagery or your own tile server), with the selection shared between the two.
Queries run in DuckDB and the map is drawn from vector tiles, so large datasets stay usable.
- Editing: forms generated from the modifiers' parameters, with help on each field and a link to the catalogue.
SQL and expression editors offer completion, error checking, and the list of attributes with their most frequent
values.
- Runs in the background, with nodes in parallel and memory limited to the budget set in Settings. Each node's
result is kept: the next run only recomputes what changed. Runs can be scheduled.
- Flows are JSON files, stored wherever the team wants; reusable components are shared through a folder.
- Modifiers are Python files: a plugin is one class in one file (see below).
- AI assistant, optional (Claude, OpenAI, OpenRouter, Ollama): it reads the flow and proposes changes, applied in
one click; what it may read is configurable. ADR 0027
- Desktop or server: on a computer, Carriole runs with the user's own permissions on local drives and network
shares, with no server to install. On a shared machine, the server (Docker image) serves several users in their
browser: local accounts managed by administrators; flows and connections private until shared with a user or a
group; files limited to the folders the administrator allows; Python code
of flows isolated (bubblewrap); fair queue and quotas per user; activity log; metadata in SQLite or PostgreSQL.
Server guide (French)
- Interface in English and French.
Install
Download from the latest release:
| System | File | |
|---|
| Windows 10/11 (x64) | Carriole-Setup-<version>.exe | Installer for all users of the computer. It is not code-signed: on the SmartScreen warning, click More info → Run anyway. |
| Linux (x64) | Carriole-<version>-x86_64.AppImage | chmod +x the file and run it: no installation, no admin rights. |
Everything is bundled (Python, GDAL, DuckDB Spatial, PROJ grids): no Internet access is needed to work.
More in the installation guide (French).
Server
On a shared server, several users work with Carriole in their browser. Each release publishes a Docker image,
ghcr.io/tlecae/carriole. On a Linux server with Docker and its Compose plugin, nothing else is needed (no clone,
no build):
mkdir carriole && cd carriole
curl -fsSLO https://raw.githubusercontent.com/TLecae/Carriole/main/docker/compose.yaml
curl -fsSL -o carriole.env https://raw.githubusercontent.com/TLecae/Carriole/main/docker/carriole.env.example
nano carriole.env # ETL_ADMIN_PASSWORD: password of the first administrator, "admin"
mkdir donnees && sudo chown 10001:10001 donnees # folder the users read and write; as root, without sudo
docker compose pull && docker compose up -d
Carriole then answers on http://127.0.0.1:8080: sign in as admin, then create the users' accounts in
Tools → Accounts. Put an HTTPS proxy (nginx, Caddy…) in front of port 8080 to open it to the network.
To update without losing flows or accounts (backup, then docker compose pull && docker compose up -d), follow
Mettre à jour in the server guide. A .env file next to compose.yaml holds the Compose
variables: CARRIOLE_VERSION=0.2.1 pins a version, CARRIOLE_DONNEES=/mnt/share mounts another folder,
CARRIOLE_BIND=0.0.0.0 opens the port to the network without a proxy (for a trial: passwords then travel in clear).
Allowed folders, administrators, quotas, PostgreSQL and the other ETL_* settings are described in the
server guide (French). From a clone of the repository: docker compose up -d --build in the
docker folder; without Docker: etl serve --server.
Write a modifier
A modifier is one Python class in one file. Its parameters become a form in the editor; it receives batches of
features (Arrow tables, geometry as WKB) and returns one batch per output port.
This is the beginning of the README. Read the rest at the original. Read the full README ↗
