Для разработчиков
Картография как структурированный вывод.
Генерируйте и редактируйте DSL-документ детерминированно, затем рендеризуйте в PNG или SVG. По HTTP, MCP или CLI — встраивайте в ваши пайплайны и агентов.
Открыть Studio →example · MCP
> validate_gesta_map(doc)
{ "valid": true, "errors": [] }
> render_gesta_map(doc, format="svg")
{ "image_base64": "PD94…",
"mime": "image/svg+xml" }Три интерфейса, один движок.
HTTP API
REST endpoints
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
Инструменты для агентов
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
Командная строка
$ 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
Детерминированное редактирование
Десять типизированных операций над документом.
Правки — это операции над AST, не регенерации — без регрессий, ручные правки сохраняются.
create_layermodify_layerdelete_layeradd_memberremove_membermodify_arrowmodify_annotationchange_viewapply_classset_disambiguation
- Детерминированно
- Один документ → одна карта, до пикселя. Онлайн-геокодирование снимается в снимок.
- Валидировано
- Каждый документ проверяется по JSON Schema формата V1.
- Вывод
- PNG, SVG (с <g> на слой), PDF, JPG. SVG редактируется далее.
- Один движок
- API, MCP и CLI — тонкие обёртки над одним рендер-пайплайном.
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
Другие входы