Skip to main content

review-bridge

License: MIT Python 3.9+ No dependencies

My parents run a noodle restaurant. They don't read English, so in fifteen years they have never read a single one of their own Google Maps reviews. The 1-star reviews sit there unanswered — and every restaurateur knows that replying to reviews is what brings new customers in.

review-bridge is their review secretary. It watches Google Maps for them and runs a loop they can actually use:

盯着 → 汇总 → 预警 → 代笔回复 — watch, brief, alert, ghostwrite.

  1. 📊 中文简报 (brief) — every morning, a Chinese briefing: average rating, rating trend, which dishes customers praise most, what they complain about most. Google Translate can translate a review. It cannot do this.
  2. 🚨 差评预警 (alert) — 1–2 star reviews get flagged immediately with urgency. My parents never open Google Maps; the tool watches it for them.
  3. ✍️ 代笔回复 (ghostwrite) — for each flagged review, a polite, natural English reply draft they can post publicly, plus a Chinese explanation of what the reply says and why. This is the real unlock: non-English-speaking owners responding to customers in fluent English.

Translation happens underneath, as plumbing. It is never presented as the product.

Why open AI matters here

  • Runs offline on the family laptop — no internet needed in a restaurant backroom.
  • Customer feedback never leaves the laptop — no review data sent to a third-party AI API.
  • Zero cost — a small family business shouldn't pay a SaaS subscription to read its own reviews.
  • The family controls it — the whole UI is in Simplified Chinese, tuned for the owners, not for a generic dashboard.

The AI core is Gemma 3 running locally via Ollama. Review fetching uses SerpApi's Google Maps Reviews API (free tier: 100 searches/month — plenty for one restaurant).

Built for the Hacktoberfest 2026 Weekend Challenge (Build for a Friend). Entered prize categories: Best Use of Gemma ($200), Best Use of SerpApi ($100).

Quickstart (Windows laptop)

# 1. Install Ollama from https://ollama.com, then:
ollama pull gemma3:4b

# 2. Free SerpApi key from https://serpapi.com (no credit card), then:
setx SERPAPI_KEY "your-key-here"

# 3. Install and run:
pip install review-bridge
review-bridge serve --query "Best Noodle House Rosemead"
# open http://localhost:8080 on your phone (same Wi-Fi)

No SerpApi key? Paste mode needs nothing:

review-bridge paste < reviews.txt     # blocks separated by ---
review-bridge serve --mock            # demo with sample data, no network/AI

Paste format — blocks separated by a --- line:

author: Jane D.
rating: 2
date: 2026-09-20
The noodles were cold and we waited 40 minutes...
---
author: Bob
rating: 5
Best beef noodle soup ever!

CLI

review-bridge fetch --query "Restaurant Name"   # pull + print Chinese briefing
review-bridge fetch --place-id <serpapi_id>     # skip the name lookup
review-bridge paste [--file reviews.txt]        # no API key needed
review-bridge serve [--port 8080]               # Chinese web UI
review-bridge <cmd> --mock                      # canned data, no network/AI

Tests

python -m pytest tests/ -q    # 26 tests, stdlib only

Honest limitations

  • The SerpApi free tier caps at 100 searches/month; a busy restaurant chain would outgrow it.
  • Review-reply drafts are AI-generated — the owners should skim the Chinese explanation before posting.
  • Star ratings on aggregator mirrors are sometimes sub-ratings; the tool trusts what the API returns.
  • The local model needs ~4GB RAM free; a very old laptop will be slow (the --mock demo still works).
  • This watches Google Maps reviews only — Yelp/DoorDash are separate worlds.

Metadata

Release files for review-bridge 0.1.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for review-bridge 0.1.1
File Size Uploaded Provenance Actions
review_bridge-0.1.1.tar.gz 19.9 kB Without provenance Details for review_bridge-0.1.1.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for review-bridge 0.1.1
File Interpreter ABI Platform Actions
review_bridge-0.1.1-py3-none-any.whl Python 3 none any Details for review_bridge-0.1.1-py3-none-any.whl

Total release size: 38.1 kB

Release files / review_bridge-0.1.1.tar.gz

Download URL review_bridge-0.1.1.tar.gz
Size 19.9 kB
Tags Source
SHA-256 checksum
How to use checksums
4c1c0a5a5b3f338773e389cfc52496a54c10f0ffd452618f366ed55a1db13f05
BLAKE2b-256 checksum
How to use checksums
979bf393db005835931cc5253db7f0104226e58a1514c963aaf9b7a7bea32888
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.12.3

Release files / review_bridge-0.1.1-py3-none-any.whl

Download URL review_bridge-0.1.1-py3-none-any.whl
Size 18.2 kB
Tags Python 3
SHA-256 checksum
How to use checksums
cca14ad406a28916c75c3513a25170729949f3a6cf1a6f097f0b897412f754f0
BLAKE2b-256 checksum
How to use checksums
b5c5f1b37fbe43d1387ddb82d298c16da2d3dbdad7d8537ff947b4890dd045b8
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.12.3

Security for review-bridge 0.1.1

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.1.1 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page