Tree [048f8a] master /

File Date Author Commit
art 2014-03-17 Assem Chelli Assem Chelli [7649e3] upload a wallpaper (binary) made by walid boumaza
debian 2014-06-29 Abdellah Chelli Abdellah Chelli [cbb2e1] Add partial clean up for debian packaging
docs 2014-07-08 Assem Chelli Assem Chelli [66a969] Generate apidoc and include all generated and e...
interfaces 2015-01-05 FenyLab FenyLab [47b1fc] Android copy developed by FenyLab
localization 2014-03-02 Assem Chelli Assem Chelli [3cd8d0] update the localization file
packaging 2015-01-10 Muhammad Shaban Muhammad Shaban [ad2571] fix errors when use (make dist_rpm)
resources 2015-01-12 Assem Chelli Assem Chelli [e72f37] Fix a mistake in the type of the word Aqol and ...
scripts 2014-01-17 Assem Chelli Assem Chelli [7e34fc] remove unneeded space
src 2015-01-12 Assem Chelli Assem Chelli [048f8a] Eliminate entries with none values in word prop...
store 2014-07-17 Assem Chelli Assem Chelli [c9ca1e] add spanish translation of Shaikh Isa Garcia
.gitignore 2014-07-08 Assem Chelli Assem Chelli [d7bdb6] ignore doctrees generated by sphinx
.travis.yml 2014-03-07 Islam Ali Islam Ali [c91033] fixing travis build process
AUTHORS.rst 2014-07-08 Assem Chelli Assem Chelli [2969f4] update arabic localization by Merwan Ali
CHANGELOG 2013-02-12 Assem Chelli Assem Chelli [4bd54e] Update CHANGELOG
COPYING 2011-11-06 Assem Chelli Assem Chelli [dd3325]
FAQ.rst 2014-07-08 Assem Chelli Assem Chelli [66a969] Generate apidoc and include all generated and e...
INSTALL.rst 2014-07-08 Assem Chelli Assem Chelli [01b808] Update the installation way for ubuntu
LICENSE 2011-09-29 Assem Chelli Assem Chelli [00fe27] Move non-python files outside of src folder
Makefile 2014-07-08 Assem Chelli Assem Chelli [0b59ba] Update release name in Make file
README.rst 2014-10-01 Assem Chelli Assem Chelli [265555] Update README.rst
THANKS.rst 2012-08-15 Assem Chelli Assem Chelli [0eda65] Update THANKS.rst 2014-07-08 Assem Chelli Assem Chelli [cd1ca8] Generate apidoc and include all generated and e... 2014-02-02 Assem Chelli Assem Chelli [c9e135] A script to detect big files in git repo, helpf...
index.rst 2014-07-08 Assem Chelli Assem Chelli [cd1ca8] Generate apidoc and include all generated and e...

Read Me

note This project needs more contributors and/or funding. An open source software does not create itself magically. If you like it, see how you can help?.

Alfanous Project

What is Alfanous?

Alfanous is a functional, dynamic, comprehensive Qur’an search engine that has been effectively designed to carry out simple or advanced Quranic searches. Alfanous uses a contemporary, highly developed approach to retrieve vital information, enabling stable efficient, speedy searches to be conducted. Alfanous aims to implement additional features such as highlight, site suggestions, scoring …etc to further improve your search experience. Alfanous understands the complex nature of the Arabic language and thus offers effective Arabic language processing, allowing the stemming and successful elimination of ambiguities. The Application Programming Interface can be used as a fundamental base for developers to build and enhance interface types within different systems, ex: Desktop GUI, Web-based UI…etc.

Release:0.7 BlackStone
IRC:#alfanous @ freenode
Feedbacks:Alfanous Community Feedbacks
Accounts:@Facebook @Twitter @GooglePlus | @Sourceforge @Launchpad

Build Status


  • If you have a concrete bug report for Alfanous please go to the Issues Tracker, submit your report and tag it "bug".
  • If you want to participate in actively developing Alfanous,by testing read this How to help with testing? and by coding read this How to contribute?.
  • If you want to help in Alfanous somehow, read this How you can help?.
  • If you have a feature request, a proposition or a question for the project, you may use the mailing list or the IRC channel.
  • If you want to criticize the project, we'll be thankful if you resume your criticism and send it to the mailing list.

For anything else, you can contact us via the mailing list: Here also the emails of Maintainers, use them wisely.

Why Alfanous?

  • Alfanous is FREE LIBRE OPEN SOURCE: Any one can use it and any one can contribute in coding, translating, design...etc. Alfanous will die only if his community dies!
  • Alfanous is a Python API: that allows anyone to create independently a web interface, desktop interface , Android/Iphone/Windows phone interfaces , facebook/twitter/G+ applications ...and so on. The search process is too fast and too stable
  • Alfanous is a research project : so we figure out features not only do what other websites/applications do.
  • Alfanous has lot of features: see Search Features.
  • Alfanous has many interfaces for many platforms: see Interfaces.
  • Alfanous is FREE GRATIS: no payment, no ads.

see FAQ

Research Foundation


  1. Alfanous Python API, source.
  2. JSON web interface 2, link, source.
  3. Django web interface [Multi-language], link , source.
  4. Web User interface for mobiles [Multi-language], link , source.
  5. Alfanous Desktop application (Windows: [Arabic] [English]; Ubuntu/Sabily), source.
  6. Alfanous Firefox toolbar, link, source.
  7. Alfanous Firefox search bar addon, link.
  8. Chrome extension (alpha), source.
  9. App for Nokia S60 (prototype), source.
  10. Facebook app (prototype), source.
  11. Third party:

note: you can find the perspective interfaces under the milestone: Extra Interfaces.

Search Features

This is the list of search features already implemented, preview links use Alfanous web user interface:

  1. Exact Word: that is the simple search, eg: فأسقيناكموه

  2. Phrase: for searching a whole phrase rather then independent words, eg:"رسول الله"

  3. Logical relations

    • Conjuction: for searching only the ayahs that contains two terms or more, eg: الصلاة + الزكاة.
    • Disjunction (default): for searching all the ayahs that contains one of two terms or more, eg:الصلاة | الزكاة.
    • Exception: for eleminating a term from search results, eg:الصلاة - الزكاة. You can understand it as "Ayahs that contains الصلاة but doesn't contain الزكاة".
  4. Wildcards or Jokers: for search all words that share many letters, we have:

    • Asterisk: replace zero or many undefined letters, eg: *نبي*
    • Interogation mark: replace one undefined letter, eg: نعم؟
  5. Fielded search: to search in more information of Quran , not only ayahs'text, we cite here the most significant fields for users:

    • aya_id or رقم_الآية (Aya local ID): that's the number of ayah inside its sura, use it for example to search all first ayahs (رقم_الآية:1).
    • sura_id or رقم_السورة (Sura ID): use it with aya_id to specify an exact ayah,for example the first ayah of surate an-nass will be : aya_id:1 + sura_id:114.
    • subject or موضوع (Topics): thats field contains all topics information, it will be helpful to search for a topic,eg: موضوع:الشيطان

    for more fields, see: Fields

  6. Intervals: this will be helpful in statistics or positions, for example search the divine name only in the first surahs: رقم_السورة :[1 الى 5 ] + الله

  7. Partial vocalization: to consider given diacritics and ignore the others, eg: آية_ :'مَن'.

  8. Word Properties: to search using root and type of words, type could be اسم, فعل or أداة,eg: {قول،اسم}.

  9. Derivations

    • light (using lemma): to search all the words having the same lemma of the given word,eg: >ملك.
    • heavy (using root): to search all the words having the same root of the given word,eg: >>ملك.

note: you can find the perspective search features under the milestones: Quranic Search Features Pack 1, Quranic Search Features Pack 2.


  • 25 November 2013: Launching "API 0.7.01 BlackStone release" of the API: Extensible, More stable, and has Many features.
  • 4 August 2013: Launching "WEB 0.7.5 alyaqoot release" of the web interface: based on Twitter Bootstrap, Responsive , Simple, Clean , Accept skins, and has many improvements and bug fixes. kacemb2
  • 10 June 2013: Launching the django web interface, localizable, indexable, and has many search features, improvements and bug fixes. kacemb
  • 26 June 2012: Launching the clickable feature, making most of results information searchable. chiffra1
  • 02 January 2012: Launching new web interface for mobiles, uses: json_web_service, link:, wiki: mobile_web_interface
  • 19 September 2011: Launching a new web interface with a new design based on the json_web_service, the link is:
  • 26 July 2011: Launching json_web_service of Alfanous ,this service is available in the link:
  • 06 March 2011:A Symposium in Riyadh - Saudi Arabia called NITS2011 or Third National Information Technology Symposium "Arabic an d Islamic Contents on the Internet",the search paper published in Arabic with the name “Indexation/Search API in Holy Qur'an”
  • 17 January 2010: Launching the arabic web-interface and reserving the domain alfanous.org_
  • 29 November 2010: Uploading the english_interface of alfanous-Desktop version 0.4 beta for Windows and Linux
  • 19 October 2010: A workshop in Damascus called “.......”,the search paper published in Arabic with the name “Indexation/Search API in Holy Qur'an”
  • 21 July 2010: Uploading the arabic_interface of alfanous-Desktop version 0.3 beta for Windows
  • 30 September 2009 - 6 July 2010: Graduation project for obtaining State-Engineer degree in National higher school of computer science (ESI ,ex.INI) - Algiers. The project was entitled “Developpement d'un moteur d'indexation et de recherche dans les documents coranique”.


  1. Milestone GUI 0.7 Amber (الكهرمان) - Cleaning the Desktop application
    • Fix the installer to Ubuntu Linux
    • Fix the installer to Windows
    • Tiny fixes
  2. Milestone API 0.7.5 Coral (المرجان) - Enriching the linguistic and Quranic resources
    • Search in Islamic Figures
    • Search&show diverse rewayates
    • Enhancement of the search by word derivations
    • Make the search queries easier and simpler
    • Search in Prayers as Hisn almuslim
    • Basic stone for Search in Hadith : 40 nawawiya
    • Sajadate based on different references
    • Search in Quran Boundary Corpus (waqf)
    • Technical improvements on Alfanous Core
  3. Milestone WUI 0.8 Emerald (الزمرد) - Interactivity of web interface
    • Live suggestions in the search input
    • Divine Names Highlight
    • Syntactic Coloration of ayah words
    • Uthmani script with full diacritical marks
    • Show the linguistic annotations of ayah words as popup tips
    • More options on the click-able tags
    • Make the info tags drag-able into the search input
  4. Milestone GUI 0.8 Garnet (العقيق) - Invasion diverse plate-forms
    • User Documentation
    • Localization to diverse languages of the world
    • Make it available on Debian, one of main Linux distributions
    • Make it available on different Arabic/Islamic Linux distributions: Ojuba, HilalLinux
    • Customize it to work well with Unity, Gnome Shell
    • Make it available on Mac OSX
  5. Milestone API 0.8 Iron (الحديد) - Whoosh 2X upgrade - Completely Technical - Move from using whoosh 0.3.18 to use 2.4.x - Optimisation of indexes
  6. Milestone API 0.9 Silver (الفضة) - Quran Search Features Silver Pack
    • Search in Quran Stories (Qassass)
    • Statistical frequencies based on Root/Stem/Lemma (word origins)
    • Vocalized word frequency
    • Faceted Thematic Search to search by topics
    • Semantically related words Search like synonyms, antonyms..
    • Qur'anic Parables (الأمثال القرآنية)
    • Abrogators and Abrogated ayahs search (الناسخ والمنسوخ)
    • Repetitions and Allegorical ayahs (التكرار والمتشابهات)
    • Search for Recitation marks
    • Search by word properties
    • Search by specific derivations like the verb conjugation
    • Partial vocalization as default
    • Romanization systems like Buckwalter, Arabtex
    • Suggest Collocated words
    • Suggest Semantically related keywords
    • Results grouping by surah, by topic, by revelation event
    • Simplifying the search for ayah statistics
    • Detect the used language in query and suggest the search in appropriate Quran translation
    • Search using the names of ayas like the sword aya (آية السيف)
    • Group words by their Lemma instead of the exact word
    • Guess declinable words and ingnore Declinison case mark
    • Auto-Completion of Query keywords
    • Offer prayer times
  7. Milestone API 1.0 Platinum (البلاتين) - Stability of Alfanous Core - Completely Technical - Write Unit tests - Auto-building of required resources from - Separate interfaces - Full Documentation using Sphinx - Manpage for Alfanous linux console interface
  8. Milestone Extra 1.0 The Pearls (اللآلِئُ) - Extra applications of Alfanous on different platforms
    • Twitter Application that posts ayahs daily
    • Facebook application that allow the user to search and share with friends
    • Application for Android feature-full
    • Application for Windows Phone
    • Application for BlackBerry
    • Application for Symbian
    • Integration with Joomla CMS
    • Integration with Drupal CMS
    • Integration with WordPress
    • ChatBot, You ask him, he will answer you.
  9. Milestone API 1.1 Rhodium (الروديوم) - Python 3000 - Completely Technical - Porting the Code to Python 3000
  10. Milestone API 1.2 Gold (الذهب) - Quranic Search Features Golden Pack
    • Vocal Search
    • Real time output
    • (lot of features not discussed yet)
  11. Milestone API 2.0 Galaxy Stone (حجر المجرات) - Multiple Search Units
    • Exploit more search units possibilities.
    • (not discussed yet)
  12. Milestone API 3.0 Technetium (تكنيشيوم) - To the bestest best optimization
    • Fixing PEP8 conventions
    • (not discussed yet)