openplaceslisted

# openplaces ## What this is A command-line tool that answers place, address and travel questions from open data. It replaces Google Places for the queries below, at zero cost and without sending addresses outside the EU. Read `references/commands.md` for the full flag and output reference. Read `references/troubleshooting.md` when a command fails. ## Before the first call Check the tool is installed: ```bash openplaces --version ``` If that fails, install it and say so — do not silently fall back to guessing coordinates from memory: ```bash uv tool install openplaces-cli # or: pipx install openplaces-cli ``` Needs Python 3.10 or newer; `uv` fetches one itself if none is suitable. The distribution is `openplaces-cli` and the installed command is `openplaces` — `uv tool list` shows the former, `which openplaces` the latter. Do not install `openplaces` without the suffix: that name on PyPI is an unrelated project. ## Core rule: never invent a location If `openplaces` is unavailable or returns nothing, **say so**. Do not supply coordinates, addresses, distances or opening hours from memory. A plausible wrong address is worse than no answer here, because the user cannot tell the difference — that is the whole reason to shell out to real data. The one exception is well-known city-level coordinates used as a `--near` argument, which the tool will itself resolve properly. ## Choosing a command | The user wants | Command | |---|---| | places of a kind, near somewhere