# Karekare → English Translator (Streamlit)
A simple web app to translate Karekare (Karai-Karai) words/phrases to English using an Excel dictionary.
## Features
- Upload your own Excel dictionary or use the provided `kdataset.xlsx`
- Exact match + fuzzy suggestions
- Bulk translate (paste a list) and download results as CSV
- Browse the dictionary in a table
## Excel Format
The app expects an Excel file (`.xlsx`) with these columns:
- `Karai-karai` — Karekare words/phrases
- `English` — English equivalents
> Column names are detected case-insensitively and tolerantly (e.g., `Karai Karai`, `Karekare` also work).
## Run Locally
```bash
pip install -r requirements.txt
streamlit run app.py
```
## Deploy on Streamlit Community Cloud
1. Push this folder to a public GitHub repository.
2. Go to
streamlit.io and create a new app.
3. Point it to your repo and select `app.py` as the entry file.
4. Ensure `requirements.txt` is present.
5. (Optional) Keep `kdataset.xlsx` in the repo root, or upload a dataset via the sidebar in the app.
## Notes
- Unicode normalization is applied so minor accent/spacing differences won't block matches.
- Fuzzy suggestions are provided when no exact match is found.