🗺️ Map Mosaic

Unfold endless worlds at the click of a button.

Map Mosaic is an open-source, AI-powered tool that fuses classic procedural noise with modern generative AI to craft cohesive, stylized maps—perfect for video games, tabletop RPGs, world-building, storytelling, and data visualization.

✨ Features

• Procedural Heightmap Generation
  Tweak noise parameters with intuitive sliders and preview unique elevation maps in real time.

• Custom Color Mapping
  Define terrain bands with adjustable color stops—guide AI styling while preserving your vision.

• Paint Mode & AI-Driven Rendering
  Hand-paint rivers, forests, or landmarks, then apply an art-style prompt to generate a polished map in one shot using OpenAI’s Image API.

• Intuitive GUI
  A clean, step-by-step interface walks you through map creation—no steep learning curve.

• Flexible Export
  Output high-resolution 1024×1024 PNG files ready for your engine, printout, or digital atlas.

📋 System Requirements

• Executable currently runs on Windows x86 architecture

🚀 Roadmap (In Progress)

• Configurable LLM Provider Support – Bring your own AI engine (e.g., Google Gemini, Ollama).

• Advanced Noise & Colormap Controls – Region presets, real-world projection support.

• Feature Inpainting – Selectively refine map sections using inpainting.

• Batch Export & Templates – Generate multiple themed maps automatically.

❓ FAQ

Do I need an API key?
In order to utilize all of the features of this tool, you will need to provide your own OpenAI API key.

What resolutions are supported?
Current maps are output in 1024×1024 resolution.

Can I use these maps commercially?
Yes! Map Mosaic is GPL-3.0 licensed. See the LICENSE for details.

🔗 Links

• GitHub Repo: https://github.com/keystoneintelligence/mapmosaic

• Official Website: https://www.keystoneintelligence.ai/mapmosaic

📝 License

Map Mosaic is released under the GNU General Public License v3.0.