osm-search/Nominatim ? reverse-engineered prompt

Build me an open source search service for OpenStreetMap data that can find places by name and address, and also do reverse geocoding so a map point can turn into a readable address.

I want a Python based project that can import OSM planet data, store it locally, and expose a simple web API and command line tool to search and serve results. It should be able to run on a local machine or server, with clear setup steps for creating a virtual environment, importing data, and starting the service. Include sensible defaults, documentation, and a few practical tests so I can tell it is working.

Make it feel like a real production tool, not a demo. If you need to check current docs or best practices for the web server or dependencies, look them up online.