criterion.life

Developers

Criterion is fully open source. Built to help people understand Islam through authentic sources using modern AI technology.

Open Source on GitHub

Explore our code, contribute, or learn how we built it

View on GitHub →

What is Criterion?

An AI assistant that helps people learn about Islam through:

  • 6,236 Quran verses - Full Arabic text with English translations
  • 12,416 Hadiths - From authentic collections (Sahih Bukhari, Muslim, etc.)
  • Semantic search - Find verses and hadiths by meaning, not just keywords
  • RAG technology - Grounded responses with citations

Why Open Source?

  • Transparency - Anyone can verify our sources and methodology
  • Trust - Open code builds confidence in authenticity
  • Education - Learn how to build AI applications with RAG
  • Collaboration - Community can improve and extend the project
  • Islamic values - Knowledge should be shared freely

Tech Stack

  • Frontend: Next.js 15, React 19, TypeScript, Tailwind CSS
  • AI: GPT-4o Mini, Gemini embeddings, Vercel AI SDK
  • Search: PostgreSQL + pgvector (HNSW index)
  • Hosting: Vercel, Neon Database

How to Contribute

  1. Fork the repository on GitHub
  2. Clone and set up locally (see README)
  3. Pick an issue or suggest a feature
  4. Make your changes and test
  5. Submit a pull request

All contributions welcome - features, bug fixes, documentation, or ideas!

Documentation

Check the repository for detailed documentation:

  • README.md - Quick start guide
  • CRITERION.md - System overview
  • CRITERION_DETAILED.md - Technical deep dive

Report Issues

Found a bug? Have a feature request? Let us know

Join Discussions

Ask questions, share ideas, or help others

License

Criterion is open source. Check the LICENSE file for details.