# Install libpostal-rest with Homebrew

REST API for libpostal. Version 1.1.0 via Homebrew; verified from local package data.

## Install

```sh
sudo av install brew:libpostal-rest
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install libpostal-rest
```

  Evidence: local Homebrew formula metadata

## Package facts

- **Package key:** brew:libpostal-rest
- **Package manager:** Homebrew
- **Version:** 1.1.0
- **Source summary:** REST API for libpostal
- **Homepage:** <https://github.com/johnlonganecker/libpostal-rest>
- **Repository:** <https://github.com/johnlonganecker/libpostal-rest>
- **Generated:** 2026-08-03T19:37:03+00:00

## Executables

- libpostal-rest (alias)

## Install behavior

- Bottle: not available

## Freshness

- Page generated: 2026-08-03
- Package-manager version: 1.1.0
## Project history and usage

libpostal-rest is a small Go REST service that exposes libpostal address parsing and expansion over HTTP. Its history is best understood as a deployment wrapper around the larger libpostal geospatial NLP library.

### Project history

The repository documents a Go 1.13+ build, HTTP endpoints for parsing, expansion, and combined expand-and-parse calls, and environment-variable configuration for listen address, logging, and Prometheus metrics. Its go.mod file depends on openvenues/gopostal, the Go binding for libpostal.

### Adoption history

The package has a narrow adoption story: it makes libpostal easier to run as a service when callers do not want to link directly to C or language bindings. The related libpostal project has broader adoption for normalizing and parsing international street addresses from open data.

### How it is used

Operators run `libpostal-rest` as an HTTP service, then send address strings to `/parser`, `/expand`, or `/expandparser`. Environment variables configure the bind host, port, log format, log level, and optional Prometheus metrics endpoint.

### Why package nerds care

The package is useful because libpostal itself has a heavy native build and large model-data footprint. A REST wrapper turns that local native dependency into a network service that other applications can consume with plain HTTP.

### Timeline

- 2022-06-17: The GitHub repository lists a public release around this date.
- 2022: The README documents Prometheus metrics and structured logging configuration for the service.

### Related projects

- libpostal is the core C address-normalization and parsing library.
- gopostal is the Go binding used by libpostal-rest.
- OpenStreetMap-derived data and libpostal's training pipeline are part of the upstream libpostal ecosystem.

### Sources

- <https://github.com/johnlonganecker/libpostal-rest>
- <https://github.com/openvenues/libpostal>
- <https://raw.githubusercontent.com/johnlonganecker/libpostal-rest/master/README.md>
- <https://raw.githubusercontent.com/johnlonganecker/libpostal-rest/master/go.mod>
- <https://raw.githubusercontent.com/openvenues/libpostal/master/README.md>


## Security Notes

library-like package without higher-risk signals.

- **Geiger risk:** green / low
- library-like package without higher-risk signals


## Combined YAML source

View the package source record on GitHub. [combined/libpostal-rest.yml](https://github.com/mxcl/pkgdb/blob/main/combined/libpostal-rest.yml)


## Sources

- pkg.so package database
- Geiger risk classifier
- curated package history
- pkgdb category and tag curation
- cross-ecosystem install command graph