# Tigrinya Spelling Suggester
A modern web application for Tigrinya spell checking with intelligent suggestions. Features a FastAPI backend with efficient spell-checking algorithms and a beautiful, responsive frontend interface.
## Features
- ✨ Real-time spell checking for Tigrinya text
- 🎯 Intelligent spelling suggestions using edit distance algorithms
- 📚 **Comprehensive dictionary with 22,766 Tigrinya words** (from HuggingFace)
- 🚀 Performance-optimized with caching
- 🎨 Modern, beautiful UI with dark mode
- 📱 Responsive design for all devices
- 🔤 Full support for Ge'ez/Ethiopic script
## Installation
### Prerequisites
- Python 3.8 or higher
- pip package manager
### Setup
1. Clone or navigate to the project directory:
```bash
cd eternal-trifid
```
2. Install Python dependencies:
```bash
pip install -r requirements.txt
```
## Usage
### Starting the Backend Server
Run the FastAPI backend server:
```bash
uvicorn backend.main:app --reload
```
The API will be available at `
localhost`
### Using the Frontend
1. Open `frontend/index.html` in your web browser
2. Type or paste Tigrinya text in the textarea
3. Misspelled words will be highlighted automatically
4. Click on suggestions to replace misspelled words
## API Documentation
### Endpoints
#### Health Check
```
GET /
```
Returns server status.
#### Check Word
```
POST /check
Content-Type: application/json
{
"word": "ሰላም"
}
```
Returns whether the word is spelled correctly.
#### Get Suggestions
```
POST /suggest
Content-Type: application/json
{
"word": "ሰላም",
"max_suggestions": 5
}
```
Returns spelling suggestions for the word.
### Interactive API Documentation
Once the server is running, visit:
- Swagger UI: `
localhost`
- ReDoc: `
localhost`
## Project Structure
```
eternal-trifid/
├── backend/
│ ├── main.py # FastAPI application
│ ├── spe …