Pour les développeurs
La cartographie comme résultat structuré.
Générez et éditez le document DSL de manière déterministe, puis rendez en PNG ou SVG. Via HTTP, MCP ou CLI — à intégrer dans vos pipelines et vos agents.
Ouvrir le Studio →exemple · MCP
> validate_gesta_map(doc)
{ "valid": true, "errors": [] }
> render_gesta_map(doc, format="svg")
{ "image_base64": "PD94…",
"mime": "image/svg+xml" }Trois surfaces, un moteur.
HTTP API
Points de terminaison REST
POST /api/generate → DSL + PNG/SVG POST /api/edit → typed ops POST /api/apply-ops → deterministic patch POST /api/rerender → re-render POST /api/render-svg → SVG, id-tagged layers POST /api/geocode → names → coordinates
MCP
Outils pour agents
render_gesta_map(doc, format, dpi)
validate_gesta_map(doc) → {valid, errors}
extract_draft_from_prose(prose)
how_to(feature) → self-explain
engine_version()CLI
Ligne de commande
$ gesta validate map.gesta.yaml $ gesta render map.gesta.yaml -o out.svg $ gesta geocode map.gesta.yaml --apply $ gesta resolve map.gesta.yaml $ gesta-serve # HTTP · gesta-mcp
Édition déterministe
Dix opérations typées sur le document.
Les modifications sont des opérations sur l'AST, pas des régénérations — zéro régression, et les éditions manuelles persistent.
create_layermodify_layerdelete_layeradd_memberremove_membermodify_arrowmodify_annotationchange_viewapply_classset_disambiguation
- Déterministe
- Même document → même carte, au pixel près. Le géocodage en ligne est figé.
- Validé
- Chaque document est vérifié contre le JSON Schema du format V1.
- Résultat
- PNG, SVG (avec un <g> par couche), PDF, JPG. SVG éditable en aval.
- Un seul moteur
- API, MCP et CLI sont des enveloppes légères autour du même pipeline de rendu.
Open source
The engine is open.
The renderer — the deterministic core that turns a document into a map — is open source. Read it, audit it, run it yourself, self-host. Geographic accuracy comes from the engine and its data, not from a black box.
Renderer on GitHub ↗AGPL-3.0 · commercial licence available
install
# clone the deterministic engine git clone https://github.com/giacomocavalcabo/gesta-renderer cd gesta-renderer pip install -e "renderer[simplify]" # render a document → SVG gesta render map.gesta.yaml -o out.svg
Les autres portes