yihong0618

yihong0618 / terraink_py

Public

fork from https://github.com/yousifamanuel/terraink

29
2
100% credibility
Found Mar 09, 2026 at 26 stars -- GitGems finds repos before they trend. Get early access to the next one.
Sign Up Free
AI Analysis
Python
AI Summary

A standalone tool for creating artistic map posters of locations using public map data, outputting high-quality PNG and SVG images.

How It Works

1
🗺️ Discover map posters

You see stunning artistic maps of cities and regions online and want to make your own for your hometown or travels.

2
💻 Set up the map maker

You easily add the map poster creator to your computer so it's ready to use anytime.

3
📍 Pick your location

You tell it a place name like 'Ganjingzi District, China' or exact coordinates to focus on.

4
🎨 Choose style and size

You select a beautiful theme like midnight blue and a layout perfect for printing on A4 paper.

5
🔍 Add details

You decide how far to zoom out and what to show like buildings, parks, roads, and water.

🖼️ Get your posters

Beautiful PNG and SVG map posters appear in a folder, ready to print, frame, or share with friends.

Sign up to see the full architecture

4 more

Sign Up Free

Star Growth

See how this repo grew from 26 to 29 stars Sign Up Free
Repurpose This Repo

Repurpose is a Pro feature

Generate ready-to-use prompts for X threads, LinkedIn posts, blog posts, YouTube scripts, and more -- with full repo context baked in.

Unlock Repurpose
AI-Generated Review

What is terraink_py?

terraink_py is a Python fork github project of https://github.com/yousifamanuel/terraink, a standalone CLI and library for generating styled OpenStreetMap posters as PNG or true vector SVG. Drop a place name like "Ganjingzi District, China" into the `terraink` command with options for themes (e.g., midnight_blue), layouts (e.g., print_a4_portrait), distance scale, and layers like buildings or roads, and it pulls Nominatim geocoding plus Overpass data to render directly—no website required. Python API lets you script it with lat/lon inputs, custom DPI up to 300, and font fallbacks for CJK text.

Why is it gaining traction?

Unlike web-based map tools, it skips browsers for fast, offline-capable PNG/SVG exports with precise control over road hierarchies, water, parks, and rail via flags like --include-buildings. Prebuilt themes and A4 layouts make pro-looking prints instant, while caching speeds repeats and vector output scales perfectly for docs or apps. As a fork git client optimized for Python devs, it adds CLI brevity (positional location arg) and uv-friendly installs over the original.

Who should use this?

Geo devs embedding custom city/region maps in dashboards or reports. Print designers scripting posters for events or real estate. Python scripters automating OSM viz for blogs, apps, or terraink-style wall art without Figma or heavy GIS stacks.

Verdict

Grab it for quick, scriptable map posters—solid CLI/API, bilingual docs, pre-commit hygiene signal care despite 19 stars and 1.0% credibility score. Still early (v0.4); test for your scale before prod, but prototypes shine.

(198 words)

Sign up to read the full AI review Sign Up Free

Similar repos coming soon.