Para desenvolvedores
Cartografia como saída estruturada.
Gere e edite o documento DSL deterministicamente, depois renderize para PNG ou SVG. Via HTTP, MCP ou CLI — para integrar em seus pipelines e agentes.
Abrir o Studio →exemplo · MCP
> validate_gesta_map(doc)
{ "valid": true, "errors": [] }
> render_gesta_map(doc, format="svg")
{ "image_base64": "PD94…",
"mime": "image/svg+xml" }Três superfícies, um motor.
HTTP API
Endpoints 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
Ferramentas para agentes
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
Linha de comando
$ 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
Edição determinística
Dez operações tipadas no documento.
Edições são operações na AST, não regenerações — sem regressões, e edições manuais persistem.
create_layermodify_layerdelete_layeradd_memberremove_membermodify_arrowmodify_annotationchange_viewapply_classset_disambiguation
- Determinístico
- Mesmo documento → mesmo mapa, ao pixel. Geocodificação online é capturada.
- Validado
- Todo documento é verificado contra o JSON Schema do formato V1.
- Saída
- PNG, SVG (com um <g> por camada), PDF, JPG. SVG editável a jusante.
- Um motor
- API, MCP e CLI são wrappers finos sobre o mesmo pipeline de renderização.
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
As outras portas