daimon3332/address

Address is a self-hosted tool that generates realistic residential addresses for testing purposes, covering 27 countries and regions. Instead of assembling random streets, numbers, and postcodes that only look plausible, it pulls actual address data from official government registers, open mapping projects, and other public sources, so the addresses it produces correspond to real streets and locations rather than invented ones. Each generated address comes with source coordinates, so it can be located on services like Google Maps, and the tool lets you filter results by country, administrative area, city, district, or postcode. If a filter combination has no matching addresses, the tool returns an error rather than quietly substituting a different location. Results can be shown in several languages, including English, Simplified and Traditional Chinese, Japanese, Korean, German, French, Spanish, and Portuguese, and users can save favorite addresses in their browser, organized by country and region. Beyond the web interface, Address offers a JSON API that developers can call directly, with example code shown in Python, cURL, and JavaScript, covering things like searching for addresses, generating single or batch results, and checking system health. It also includes an administrator dashboard for managing data sources, synchronization schedules, access control, and API tokens. Because Address is self-hosted, running it requires setting up your own server with a PostgreSQL database, which the tool depends on for storing and quickly searching through address records. The project's code is released under the MIT license, a permissive license that allows free use, modification, and commercial use, though the underlying address data itself comes from a mix of official and open sources with their own terms. This tool is aimed at developers and quality assurance teams who need realistic, geographically valid test data for forms, e-commerce checkouts, or other systems that need to be tested against real world address formats across many different countries.