Skip to content
Alfanous is an Arabic search engine API provides the simple and advanced search in Quran , more features and many interfaces...
PLpgSQL Python HTML JavaScript CSS Makefile
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.
interfaces/web/jquery_demo Remove discontinued interfaces Oct 12, 2018
.gitignore Update translation list in pre-build May 26, 2018
INSTALL.rst Update INSTALL.rst Jan 13, 2016


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.10 Kahraman
Accounts:@Facebook @Twitter @GooglePlus | @Sourceforge @Launchpad


Install it from Pypi:

$ sudo pip install alfanous

You can use it from console:

$ alfanous-console -a search -q الله
$ alfanous-console -a search -q Allh

or from Python:

>>> import alfanous
>>>{"action":"search","query":u"Allh"}) # Buckwalter transliteration

You can use it also from the web service:الله


  • 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:

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.


  • 4 March 2015: Launching "GUI 0.7.20 Kahraman release" of the GUI: clean, uptodate technologies, localization, translation search.
  • 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”.

Featured Posts

  • Alfanous, mesin pencari ayat Al-Quran masa depan, ahmadbinhanbalblog
  • الفانوس مشروع محرك بحث متقدم للقرآن الكريم, arabcrunch
  • جزائري يطلق محرك بحث شامل للقرآن الكريم, onislam
  • Alfanous – Quran Search Engine, muslihzarthblog
  • إطلاق الإصدارة الجديدة لموقع الفانوس, kacemb
  • إصدار نسخة “الياقوت” من موقع الفانوس للبحث القرآني المتقدّم, kacemb2
  • مزية جديدة في الفانوس، أنقر ما تريد لتبحث من جديد!, chiffra1
  • التحقق من أحد المنشورات حول الإعجاز العددي في القرآن الكريم, chiffra2
  • AlFanous, Terdepan dalam Penelusuran Teks dan Informasi Ayat Al Qur’an, fath_multimedia
  • Alfanous, Dakwah Al-Quran Lewat Search Engine, fimadani

Note: If you wrote -yourself- a good post about Alfanous in any language, please just tell us to refer it here!

See also

  1. Application Programming Interface & Console Interface
  2. JSON output system
  3. Desktop Interface
  4. Django application
  5. Packaging
You can’t perform that action at this time.