AnanduMadhu01/koze_kreol
Domain:
natural language processingRecord type:
software
Creator:
Ana
Host:
MUA kreol
# Morisien CAPT API — Full Technical Documentation
A REST API for **Computer-Assisted Pronunciation Training (CAPT)** for the Morisien (Creole) language.
It accepts audio recordings and returns pronunciation scores and phoneme-level feedback.
Base URL: `localhost`
---
## Table of Contents
1. System Architecture Overview
2. The ASR Model — What It Is and How It Works
3. Audio Processing Pipeline
4. Phonemizer Pipeline
5. GOP-SF Scoring Algorithm
6. Identity Check — Did They Say the Right Word?
7. End-to-End Workflow (Step by Step)
8. API Endpoints
9. Audio Requirements
10. Running the Server
11. Dependencies
---
## 1. System Architecture Overview
```
┌─────────────────────────────────────────────────────────────────┐
│ FastAPI Server (app.py) │
│ │
│ POST /user ──────────────────────────────────────────────┐ │
│ POST /admin ─────────────────────────────────────────┐ │ │
│ GET /lexicon │ │ │
│ GET /health │ │ │
└────────────────────────────────────────────────────────┼───┼───┘
│ │
┌────────────────────────────────────┘ │
▼ ▼
┌──────────────────┐ ┌────────────────────┐
│ AudioProcessor │ │ CreoleCAPTEngine │
│ (preprocessing) │ │ (assess method) │
└────────┬─────────┘ └────────┬───────────┘
│ │
▼ ▼
┌──────────────────┐ ┌─────────────────────────┐
│ MultilingualPhone│ │ CreolePhonemizerPipeline │
│ meASR (Wav2Vec2) │◄─────────────│ (word → IPA phonemes) │
└──────────────────┘ └─────────────────────────┘
│
▼
┌──────────────────┐
│ GOP-SF Scoring │
│ (forward-backward│
│ CTC alignment) │
└──────────────────┘ …