| --- |
| title: Human Adoption Office |
| emoji: 🐈 |
| colorFrom: green |
| colorTo: yellow |
| sdk: gradio |
| sdk_version: 6.13.0 |
| python_version: "3.10" |
| app_file: app.py |
| pinned: false |
| short_description: Find the cat who chooses to adopt you. |
| --- |
| |
| # Human Adoption Office |
|
|
| Find the cat who chooses to adopt you. |
|
|
| ## Visual Direction |
|
|
| The interface uses a vintage illustrated-book system inspired by the supplied |
| layout reference: warm paper texture, double-line borders, dark green chapter |
| headers, relationship cards, editorial photo frames, and fixed horizontal |
| screens with no long-page scrolling. |
|
|
| ## Included Flow |
|
|
| 1. Landing / intro |
| 2. Draw a cat relationship card |
| 3. Lifestyle rhythm question |
| 4. Preferred cat relationship question |
| 5. Matching / listening screen |
| 6. Matched cat story |
| 7. Real photo placeholder and final CTA |
|
|
| The interface uses `gr.State` for: |
|
|
| - `selected_card` |
| - `selected_lifestyle` |
| - `selected_relationship` |
| - `matched_cat` |
|
|
| Cat records are loaded from `cats.csv`. The `match_cat()` function scores each |
| record against the three selected values and returns the highest-scoring cat. |
|
|
| ## Run Locally |
|
|
| ```bash |
| python -m pip install -r requirements.txt |
| python app.py |
| ``` |
|
|
| Open the local Gradio URL shown in the terminal. The desktop layout is designed |
| for a viewport at least 980 pixels wide. |
|
|
| ## Replace the Sample Content |
|
|
| - Add real shelter records to `cats.csv`. |
| - Store real cat photos under `assets/` and update each row's `image` field. |
| - Replace the final CTA link in `app.py` with the shelter's adoption page. |
|
|
