transfuzzy 0.1.1

TransFuzzy is a robust transliteration system that bridges the gap between Indic scripts and the Latin alphabet.

🔤 TransFuzzy

Multilingual AI-powered name matching — phonetic + semantic + ML in one CLI tool.

TransFuzzy is a high-performance system for matching names across Indic and Latin scripts, combining phonetic algorithms, string similarity, and transformer embeddings into a single intelligent pipeline.

---

🚀 Installation

pip install transfuzzy

---

⚡ Usage

Start API Server

transfuzzy
# or
transfuzzy serve

Runs at:

http://localhost:5000

---

🔍 CLI Prediction

transfuzzy predict "Rahul"

transfuzzy predict "Rahul" --top 5

transfuzzy predict "Rahul" --json

---

Example Output

🔍 Similar names:

1. Rahul
2. Raahul
3. Rahool
4. Rahil

---

🌐 Supported Languages

• English (Latin)
• Hindi (Devanagari)
• Telugu
• Tamil
• Kannada
• Malayalam
• Gujarati
• Gurmukhi

You can input:

"Rahul"
"राहुल"
"రాహుల్"

---

🧠 How It Works

Input Name
   ↓
Script Detection → Transliteration
   ↓
Candidate Filtering (~73k names)
   ↓
Similarity Metrics (8 features)
   ↓
ML Model (Random Forest)
   ↓
Hybrid Scoring
   ↓
Top Matches

---

📡 API Usage

POST /similar_names

{
  "name": "Rahul"
}

Response:

{
  "similar_names": ["Rahul", "Raahul", "Rahool"]
}

---

🏗️ Project Structure

src/transfuzzy/
├── cli.py          # CLI entrypoint
├── app.py          # Flask API
├── core/           # ML pipeline
├── dir/            # processing steps
├── db/             # dataset + model
├── utils/          # helpers
├── templates/      # UI
├── static/         # frontend

---

🧪 Training

uv run python scripts/enrich.py
uv run python scripts/train.py

---

⚙️ Development

git clone https://github.com/your-username/transfuzzy.git
cd transfuzzy
uv sync
uv run transfuzzy

---

✨ Features

• 🔊 Phonetic matching (Soundex, Metaphone)
• 📐 String similarity (Levenshtein, Jaro-Winkler)
• 🧠 Semantic embeddings (Sentence Transformers)
• 🌲 ML model (Random Forest)
• ⚡ Optimized inference pipeline
• 💻 CLI + API + Web UI

---

📄 License

MIT © Goutham

---

🔥 Vision

TransFuzzy is designed for real-world systems like:

• KYC verification
• Government databases
• Search & deduplication
• Multilingual identity matching

---

Built with ❤️ for AI-powered applications