vn-address-converter 0.1.0

A Python package for converting and normalizing Vietnamese addresses

Vietnam Address Converter

This is the result of my vibe coding experiment to fully use AI to solve a problem.

Vietnam recently merged 63 provinces into 34, creating a need to convert old addresses to the new administrative format. This Python package provides a solution for converting old Vietnamese addresses to the new format.

Most of the code is written with Github Copilot using GPT 4.1 and Claude Sonet 4 model.

The mapping data is sourced from here. Initially, I tried to parse from this wiki page, but the result was so bad that I ended up abandoning the parser.

Disclaimer

This package is experimental and may not be 100% accurate. Please verify results and contribute improvements!

Installation

pip install vn-address-converter

Usage Example

from vn_address_converter import convert_to_new_address, Address

address = Address(
    street_address="720A Điện Biên Phủ",
    ward="Phường 22",
    district="Quận Bình Thạnh",
    province="Thành phố Hồ Chí Minh"
)

new_address = convert_to_new_address(address)
print(new_address)
# Output: {'street_address': '720A Điện Biên Phủ', 'ward': 'Phường Thạnh Mỹ Tây', 'district': None, 'province': 'Thành phố Hồ Chí Minh'}

License

MIT