README.md

metadata

title: History Map
emoji: 📈
colorFrom: gray
colorTo: yellow
sdk: gradio
sdk_version: 5.5.0
app_file: app.py
pinned: false

Historical Context Mapper

This Gradio app generates network visualizations showing the historical context and connections for terms from Unit 5 (1844-1877) of U.S. History.

Features

• Interactive text input for historical terms
• Network visualization of related concepts
• Color-coded categories for different types of historical elements
• Context-based relationship mapping
• Dark theme visualization for better readability

Setup

1. Install the required packages:

pip install -r requirements.txt
python -m spacy download en_core_web_sm

2. Ensure the Unit5_OCR.txt file is in the same directory as app.py

3. Run the app:

python app.py

Usage

1. Enter a historical term from Unit 5 (1844-1877) in the text input
2. The app will generate a network visualization showing:
   • Related people
   • Connected events
   • Relevant policies/laws
   • Thematic connections
   • Temporal relationships

Categories

• Main Themes (Blue)
• Events (Green)
• People (Brown)
• Laws/Policies (Purple)
• Concepts (Dark Red)

Deployment

This app can be deployed on Hugging Face Spaces. To deploy:

1. Create a new Space on Hugging Face
2. Upload these files:
   • app.py
   • requirements.txt
   • Unit5_OCR.txt
   • README.md
3. The app will automatically deploy and be available online

Data Source

The historical data is sourced from Unit 5 of the AP U.S. History curriculum, covering the period 1844-1877.