https://github.com/clearclown/pizza
🍕 PI-ZZA: Process Integration & Zonal Search Agent — Next-gen location intelligence for franchise research. Go orchestrator + gRPC + polyglot modules.
https://github.com/clearclown/pizza
browser-automation firecrawl franchise-research golang google-maps-scraper grpc llm-agent location-intelligence polyglot tdd
Last synced: 1 day ago
JSON representation
🍕 PI-ZZA: Process Integration & Zonal Search Agent — Next-gen location intelligence for franchise research. Go orchestrator + gRPC + polyglot modules.
- Host: GitHub
- URL: https://github.com/clearclown/pizza
- Owner: clearclown
- License: mit
- Created: 2026-04-22T15:17:42.000Z (about 2 months ago)
- Default Branch: main
- Last Pushed: 2026-04-22T17:24:51.000Z (about 2 months ago)
- Last Synced: 2026-04-22T17:35:51.369Z (about 2 months ago)
- Topics: browser-automation, firecrawl, franchise-research, golang, google-maps-scraper, grpc, llm-agent, location-intelligence, polyglot, tdd
- Language: Go
- Homepage: https://github.com/clearclown/pizza
- Size: 509 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 7
-
Metadata Files:
- Readme: README.en.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Codeowners: .github/CODEOWNERS
- Security: SECURITY.md
Awesome Lists containing this project
README
# PI-ZZA 🍕 — Process Integration & Zonal Search Agent
> **"Serving you high-precision data, piping hot!"**
> PI-ZZA is a next-generation location intelligence tool that combines exhaustive Google Maps search with autonomous AI browsing.
[日本語 README](./README.md)
---
## What It Does
Identifies **mega franchisees** (operators running 20+ stores) and classifies **directly-operated vs. franchised** outlets — the kind of multi-week investigative work that PI-ZZA reduces to hours.
## Architecture — 4 Toppings
```
┌──────────────────────────────────────────────────────────────────┐
│ 🔥 Oven (Go Orchestrator) │
└─────────┬────────────┬───────────────┬─────────────┬─────────────┘
│ gRPC │ gRPC │ REST │ SQLite
▼ ▼ ▼ ▼
┌───────────┐ ┌─────────────┐ ┌────────────┐ ┌──────────┐
│ 🫓 Dough │ │ 🛵 Courier │ │ 🧀 Kitchen │ │ 📦 Box │
│ Seed (Go) │ │ Delivery(Py)│ │ Firecrawl │ │ BI (Py) │
└───────────┘ └──────┬──────┘ └────────────┘ └──────────┘
│
Multi-LLM (Anthropic / OpenAI / Gemini)
```
| # | Module | Lang | Upstream fork | License |
|---|---|---|---|---|
| M1 | Seed (dough) | Go | gosom/google-maps-scraper + googlemaps/google-maps-services-go | MIT / Apache-2.0 |
| M2 | Kitchen (toppings) | TypeScript | mendableai/firecrawl | AGPL-3.0 (isolated via REST) |
| M3 | Delivery (courier) | Python | browser-use/browser-use | MIT |
| M4 | Box (BI) | Python (Streamlit + SQLite) | — | — |
## Quick Bake
```bash
git clone git@github.com:clearclown/pizza.git
cd pizza
make bootstrap
cp .env.example .env # edit keys
make proto
make test
make up
./bin/pizza bake --query "Anytime Fitness" --area "Tokyo"
```
## Dev Workflow — TDD First
We enforce **Red → Green → Refactor** commits. See [CONTRIBUTING.md](./CONTRIBUTING.md) and [docs/tdd-workflow.md](./docs/tdd-workflow.md).
## Docs
- [ARCHITECTURE.md](./ARCHITECTURE.md)
- [docs/architecture.md](./docs/architecture.md) — sequence diagrams, gRPC contracts
- [docs/tdd-workflow.md](./docs/tdd-workflow.md)
- [docs/fork-strategy.md](./docs/fork-strategy.md) — git subtree upstream sync
- [docs/license-compliance.md](./docs/license-compliance.md) — AGPL isolation rationale
- [docs/proto-versioning.md](./docs/proto-versioning.md)
## License
[MIT](./LICENSE) for PI-ZZA itself. Upstream forks retain their own licenses. Firecrawl (AGPL-3.0) is reached via REST only, never linked into the Go binary.