Sovereign Amharic NLP & Regional Business Dialect Adaptation

1. Overview & Technical Architecture#

Amharic is a morphologically rich Semitic language. SmartERP incorporates a specialized NLP preprocessing engine to handle root-and-pattern morphology.

1. Morphological Normalization Pipeline#

• Homophone Normalization: Standardizes alternate character forms (e.g., ሀ, ሐ, ኀ mapped to canonical ሀ; ሠ mapped to ሰ).
• Punctuation Normalization: Converts Ge'ez word space (፡) and full stop (።) to unified token delimiters.
• Number Parsing: Native parsing of Ge'ez numerals (፩ to ፼) into numeric integers.

2. Calendar Idiom Resolution#

The model recognizes natural language date expressions in the Ethiopian calendar (e.g., "የመስከረም 2018 የደመወዝ ክፍያ") and maps them accurately to Gregorian UTC timestamp ranges for database querying.

2. Prerequisites & Infrastructure Requirements#

• Runtime Environment: Python 3.12+, PostgreSQL 16 with pgvector extension.
• Security Access Group: Ashewa AI / Administrator (Technical ID: muk_ai.group_ai_manager)
• Hardware Profile: Minimum 16 GB System RAM (CPU inference) or NVIDIA GPU with 8+ GB VRAM.

3. Step-by-Step Configuration & Verification#

Step 1: Navigating to Model Management#

1. Access your SmartERP instance at https://smarterp.et/odoo.
2. Open Settings → Technical → Ashewa AI → Model Registry.
3. Select the custom model profile.

{screenshot:52-amharic-nlp-and-regional-dialect-adaptation-step1-navigation}

Step 2: Testing Endpoint Health & Response Verification#

1. Click the Run Diagnostic Health Check button.
2. Verify token generation speed (tokens/sec) and latency benchmarks.
3. Review sample response in the diagnostic console.

{screenshot:52-amharic-nlp-and-regional-dialect-adaptation-step2-verification}

4. Advanced Configuration Points#

• Automated Tasks: muk_ai.ir_cron_model_health_monitor runs every 15 minutes.
• Multi-Tenant Boundaries: Custom model fine-tuning adapters are strictly segregated per tenant database.

5. Comprehensive Troubleshooting Matrix#