README.md

metadata

title: Tutorial Hackathon
emoji: 🚀
colorFrom: blue
colorTo: red
sdk: streamlit
app_file: app.py
pinned: false

Image Subject Comparison Tutorial

This is a Streamlit-based web application for a tutorial on determining if two images depict the same subject. It presents 8 scenarios based on specific rules, allowing users to select a scenario, view placeholder images, and choose "Yes" or "No" to receive feedback.

Features

• Interactive Scenarios: Select from 8 predefined scenarios.
• Image Display: View two images side-by-side for each scenario.
• Feedback System: Click "Yes" or "No" to get instant feedback on correctness.
• Tutorial Rules: Based on rules for same-subject comparison (e.g., same person vs. associated items).

Scenarios

1. Different pictures of the same person - Yes
2. Identical or resized picture - Yes
3. Different pictures of the same landmark - Yes
4. Subject vs. representation (e.g., landmark vs. keychain) - No
5. Person vs. associated item (e.g., player vs. jersey) - No
6. Person vs. their signature - No
7. Person vs. their tombstone - No
8. Same person at different ages - Yes

Installation

1. Clone or download the repository.
2. Install dependencies:

   pip install -r requirements.txt
   

Running Locally

1. Ensure you have Python installed.
2. Run the Streamlit app:

   streamlit run app.py
   

3. Open the provided local URL in your browser (usually http://localhost:8501).

Hosting on Hugging Face Spaces

1. Go to Hugging Face Spaces.
2. Create a new Space.
3. Select "Streamlit" as the SDK.
4. Upload app.py and requirements.txt.
5. The app will be hosted and accessible via the Space's URL.

Usage

• Select a scenario from the dropdown.
• View the two images.
• Click "Yes" or "No" to see if your answer is correct and read the feedback.

Customization

• Images: Replace placeholder URLs in app.py with actual Wikimedia Commons image links.
• Scenarios: Modify the scenarios list in app.py to add or change scenarios.

Dependencies

• streamlit

License

[Add license if applicable]