Islamic AI: ask questions, get scholar-cited answers. Not a fatwa engine; a study companion.

Live: chatislam.org

IslamQA (islamqa.us) has merged into ChatIslam. All Q&A functionality is available here.

P7 status (2026-05): Engineering Excellence Foundation complete. Prompt-injection defenses hardened, rate-limit adapter updated to Upstash for multi-instance safety. See CHANGELOG for details.

Before contributing, read .github/wiki/ENGINEERING-CHARTER.md. It is the single source of truth for code standards across every Ummeco repo. The most-read sections:

• § 21 Common AI-Agent Mistakes
• § 4 Naming Conventions
• § 6 Documentation Bar

ChatIslam is a free AI chat app for Islamic knowledge and dawah, built on Claude with strict Ahl us-Sunnah wal-Jama'ah guidelines. It adapts its tone to the audience (practicing Muslim, new Muslim, or non-Muslim) and cites sources from Quran, Hadith, and classical scholarship. It is not a fatwa service; complex fiqh questions are escalated to vetted human scholars.

• AI chat powered by Claude with strict Ahl us-Sunnah wal-Jamaah guidelines
• Audience-adaptive modes:
  • Muslim mode — scholarly, cited answers with source references
  • New Muslim mode — step-by-step guidance, encouraging tone
  • Dawah mode — gentle, bridge-building for non-Muslim audiences
• Source citations from Islam.wiki knowledge base
• Embeddable JS widget for partner websites
• Human escalation to vetted scholars and volunteers
• Chat history and session persistence (Hasura-backed, ci_ table prefix)
• Rate limiting and prompt-injection defense on all AI routes

chatislam/
└── web/        chatislam.org — Next.js web app
    └── app/    pages and API routes

Start the shared Ummat backend first:

cd ~/Sites/ummeco/ummat/backend && nself start

Web app:

cd web
cp .env.example .env.local   # fill in ANTHROPIC_API_KEY + Hasura/auth URLs
pnpm install
pnpm dev --port 3042   # https://www.chatislam.local.nself.org:8543 (port 8543)

ANTHROPIC_API_KEY is required for all Claude API routes. Never set it in any NEXT_PUBLIC_* variable or expose it to the browser.

All data access goes through Hasura GraphQL. The Anthropic API key is server-side only — all Claude calls happen in Route Handlers, never in Client Components.

Local API: https://api.chatislam.local.nself.org:8543/v1/graphql Production API: https://api.chatislam.org/v1/graphql

See .github/wiki/Contributing.md for architecture docs, theological guidelines, and contribution guidelines.

MIT