README.md

metadata

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

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.