README.md

---
title: Mobile Lookup
emoji: 📱
colorFrom: blue
colorTo: indigo
sdk: streamlit
sdk_version: 1.57.0
app_file: app.py
pinned: false
license: mit
---

# Mobile Lookup

Search mobile numbers across a HuggingFace parquet dataset using DuckDB.

## How it works

1. Searches `mobile1_index.parquet` and `mobile2_index.parquet` in parallel via DuckDB
2. Uses the `row_group_id` + `row_start`/`row_end` from the index to fetch only the exact row group from HuggingFace
3. Returns all matching records with full details

## Setup

Set the following repository secret in your Space settings:

| Secret | Description |
|--------|-------------|
| `HF_TOKEN` | HuggingFace token with read access to the dataset |

## Index files

Upload `mobile1_index.parquet` and `mobile2_index.parquet` to the Space repository,
or set `MOBILE1_IDX` / `MOBILE2_IDX` env vars to `hf://` paths if stored in a dataset.