ميزان | Meezan

The World's First Shariah-Compliant Personal AI Assistant

⚖️ مساعدك الإسلامي الذكي

For 1.8 Billion Muslims Worldwide

What is Meezan?

Meezan (ميزان, "The Balance") is an open-source, Shariah-compliant personal AI assistant built for the Muslim world. It runs on WhatsApp and Telegram — apps already on every Muslim's phone — and filters every response through Islamic principles before replying.

Built on: OpenClaw (MIT License) + Claude (Anthropic) + Aladhan API

Features

🛡️ Shariah Filter Layer

Every single message passes through a Shariah compliance layer that:

Redirects Riba (interest) questions to halal alternatives
Blocks gambling/speculation advice
Only recommends halal-certified food & restaurants
Defers religious rulings to qualified scholars

🕌 Prayer Times

Real-time prayer times via Aladhan API
Supports all major madhabs (Hanafi, Maliki, Shafi'i, Hanbali)
Proactive Adhan reminders via Telegram
Ramadan Suhoor/Iftar times

💰 Zakat Calculator

AAOIFI-standard calculation (2.5% of net wealth above Nisab)
Real-time gold price for Nisab calculation
Supports all asset types: cash, gold, silver, investments, business inventory
Recommends verified Zakat organizations in Kuwait/GCC

📊 Halal Stock Screener

AAOIFI-based screening criteria
Database of known halal/haram stocks
Recommends Shariah-compliant ETFs (HLAL, SPUS, AMANX)
Debt ratio and haram revenue checks

🏦 Islamic Finance Advisor

Explains Murabaha, Ijara, Musharaka, Sukuk, Takaful
Recommends GCC Islamic banks: Boubyan Bank, KFH (بيتك), KIB
Never recommends interest-bearing products

🇰🇼 Kuwait Government Services

MOI, PACI, civil ID guidance
Sahel app step-by-step help
Prayer-time aware scheduling

🤖 AgenThink Bridge

Connects consumer users to AgenThink institutional AI agents
Gateway to institutional Islamic finance analysis

Quick Start

# Clone
git clone https://github.com/agentthink/meezan-assistant
cd meezan-assistant

# Setup (interactive wizard)
npm install
npm run setup

# Start
npm run dev

Open http://localhost:3000

Telegram Setup

Message @BotFather on Telegram
Create new bot: /newbot
Copy the token to your .env:
```
TELEGRAM_BOT_TOKEN=your_token_here
```
Restart Meezan
Message your bot on Telegram

Docker Deployment (Recommended for Production)

# Copy env
cp .env.example .env
# Edit .env with your API keys

# Deploy
docker-compose up -d

# Logs
docker-compose logs -f

Recommended: Deploy on Bahrain AWS or UAE Azure for GCC data residency.

API Reference

Chat

POST /api/chat
{
  "userId": "user123",
  "message": "ما هي مواقيت الصلاة اليوم؟",
  "channel": "web"
}

Prayer Times

GET /api/prayer-times?lat=29.3759&lng=47.9774&city=Kuwait+City

Zakat Calculator

POST /api/zakat
{
  "cash": 5000,
  "gold": 50,
  "investments": 3000,
  "debts": 1000
}

Halal Screener

GET /api/screen/AAPL

Supported Languages

Language	Code	Status
Arabic (Gulf)	ar	✅ Default
English	en	✅
Urdu	ur	✅
Malay	ms	✅

Language is auto-detected from the user's first message.

Architecture

User (WhatsApp/Telegram/Web)
        ↓
Meezan Gateway (Node.js/TypeScript)
        ↓
Skills Router (detects intent)
    ↙        ↓        ↘
Prayer    Zakat    Screener  ...
Times   Calculator
        ↓
Shariah Filter Layer
        ↓
Claude Sonnet 4.6 (Anthropic API)
        ↓
Shariah Response Filter
        ↓
Reply to User

Security & Privacy

All user data stored locally on your own server
No data sold to advertisers (this is also a Shariah principle — Amanah)
End-to-end encrypted memory storage
PDPL (Kuwait Personal Data Protection Law) compliant

License

MIT License — Free for commercial use.

Built by AgenThink

Meezan is developed by AgenThink — Kuwait's institutional AI company.

Website: agentthink.ai
ADGM Registered, Kuwait City

"وَمَا تَوْفِيقِي إِلَّا بِاللَّهِ"

🌙 Built with love for the Muslim Ummah worldwide

جزاكم الله خيراً

Downloads last month: -; Downloads are not tracked for this model. How to track

Inference Providers NEW

This model isn't deployed by any Inference Provider. 🙋 Ask for provider support