Amara AI
---
Amara AI: Credit risk assessment platform for microfinance lending. Combines ML predictions with Gemini AI analysis to evaluate loan applications.
## Features
- **ML Risk Scoring** - Decision tree model predicts probability of default (70% weight)
- **Gemini Vision Analysis** - Analyzes business/home photos for additional risk signals (15% weight)
- **Gemini NLP Analysis** - Processes field agent notes for sentiment and risk factors (15% weight)
- **Dashboard Analytics** - Real-time charts for risk distribution, loan status, and recommendations
- **Borrower Management** - Track customers, loans, and assessment history
## Tech Stack
| Layer | Technology |
| ------------- | ---------------------------------------------- |
| Frontend | Next.js 16, React 19, TypeScript, Tailwind CSS |
| UI Components | Radix UI, Lucide Icons, Recharts |
| Backend | FastAPI, Pydantic, SQLAlchemy (async) |
| Database | PostgreSQL (Cloud SQL) |
| AI/ML | Google Gemini API, scikit-learn |
| Auth | JWT with bcrypt |
## Project Structure
```
amara-ai/
├── backend/
│ ├── app/
│ │ ├── core/ # Config, security
│ │ ├── models/ # Pydantic & SQLAlchemy models
│ │ ├── routers/ # API endpoints
│ │ │ ├── auth.py # Login/register
│ │ │ ├── assessment.py # Credit assessment
│ │ │ └── dashboard.py # Stats & charts
│ │ └── services/ # Business logic
│ │ ├── scoring_engine.py # Risk calculation
│ │ ├── ml_inference.py # ML model
│ │ └── gemini_service.py # AI analysis
│ ├── model/ # Trained ML models
│ └── requirements.txt
│
├── frontend/
│ ├── app/
│ │ ├── (auth)/ # Login page
│ │ └── (dashboard)/ # Dashboard, borrowers, assessments
│ ├── components/ # React com …