How dawit-getachew/umurima works
Umurima AI delivers farming advice by SMS: a farmer messages an Android relay, which calls the backend and sends the returned reply. The backend applies triage, verified answers, cache, retrieval/model, and offline fallback stages, then adds a human referral. The README documents this routing and the gateway’s store-and-forward role, but the Flutter application source is absent from the supplied tree, so its internal queue and dashboard are represented only at the gateway level. Native telephony plugin relationships are shown only where the sampled plugin source supports them.
Main entry points: advisor.py Answer orchestrator · sms-gateway SMS relay · main.py FastAPI service · SmsMethodCallHandler.kt Method call handler
Components 20
SMS gateway
- SMS relay
sms-gateway
Advice backend
- FastAPI service
backend/app/main.py - Answer orchestrator
backend/app/advisor.py - Urgency triage
backend/app/triage.py - Verified answers
backend/app/faq.py - Answer cache
backend/app/cache.py - Model client
backend/app/llm.py - Offline fallback
backend/app/rag.py - Language and matching
backend/app/nlp.py - Reply formatting
backend/app/replies.py - History storage
backend/app/memory.py
Advice knowledge
- Note retrieval
backend/app/rag.py - Agronomy notes
backend/knowledge
Android telephony
- Telephony plugin
sms-gateway/packages/telephony/android/src/main/kotlin/com/shounakmulay/telephony/TelephonyPlugin.kt - Method call handler
sms-gateway/packages/telephony/android/src/main/kotlin/com/shounakmulay/telephony/sms/SmsMethodCallHandler.kt - SMS controller
sms-gateway/packages/telephony/android/src/main/kotlin/com/shounakmulay/telephony/sms/SmsController.kt - Incoming SMS handler
sms-gateway/packages/telephony/android/src/main/kotlin/com/shounakmulay/telephony/sms/IncomingSmsHandler.kt - Permission controller
sms-gateway/packages/telephony/android/src/main/kotlin/com/shounakmulay/telephony/PermissionsController.kt
Other components
- Farmer
- OpenRouter
Connections 24
- Farmer → SMS relay: texts SMS
- SMS relay → FastAPI service: sends HTTPS
- FastAPI service → SMS relay: returns reply
- SMS relay → Farmer: sends SMS
- FastAPI service → Answer orchestrator: calls
backend/app/main.py - FastAPI service → History storage: initializes
backend/app/main.py - Answer orchestrator → Urgency triage: checks urgency
backend/app/advisor.py - Answer orchestrator → Verified answers: checks answers
backend/app/advisor.py - Answer orchestrator → Answer cache: checks cache
backend/app/advisor.py - Answer orchestrator → Note retrieval: retrieves notes
backend/app/advisor.py - Answer orchestrator → Model client: requests answer
backend/app/advisor.py - Answer orchestrator → Offline fallback: falls back
backend/app/advisor.py - Answer orchestrator → Reply formatting: formats reply
backend/app/advisor.py - Answer orchestrator → History storage: uses history
backend/app/advisor.py - Answer orchestrator → Language and matching: normalizes text
backend/app/advisor.py - Note retrieval → Agronomy notes: loads and ranks
backend/app/rag.py - Note retrieval → Language and matching: tokenizes queries
backend/app/rag.py - Model client → OpenRouter: calls API
backend/app/llm.py - Answer cache → History storage: persists answers
backend/app/cache.py - Telephony plugin → Method call handler: registers handler
sms-gateway/packages/telephony/android/src/main/kotlin/com/shounakmulay/telephony/TelephonyPlugin.kt - Method call handler → SMS controller: dispatches SMS
sms-gateway/packages/telephony/android/src/main/kotlin/com/shounakmulay/telephony/sms/SmsMethodCallHandler.kt - Method call handler → Incoming SMS handler: configures callbacks
sms-gateway/packages/telephony/android/src/main/kotlin/com/shounakmulay/telephony/sms/SmsMethodCallHandler.kt - Method call handler → Permission controller: checks permissions
sms-gateway/packages/telephony/android/src/main/kotlin/com/shounakmulay/telephony/sms/SmsMethodCallHandler.kt - SMS relay → Telephony plugin: uses native SMS
sms-gateway/packages/telephony/android/src/main/kotlin/com/shounakmulay/telephony/TelephonyPlugin.kt