README.md

---
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:
```bash
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:
```bash
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.