Skip to content
This repository

Alfanous (The Lantern - الفانوس ) is an Arabic search engine API provides the simple and advanced search in the Holy Quran , more features and many interfaces...

This branch is 0 commits ahead and 0 commits behind master

Merge pull request #405 from assem-ch/kill_baidospider

Restrict some crawling bots + arabic localization update
latest commit 19a23657bd
Assem Chelli assem-ch authored April 18, 2014
Octocat-spinner-32 art upload a wallpaper (binary) made by walid boumaza March 17, 2014
Octocat-spinner-32 debian Update alfanous.install March 23, 2014
Octocat-spinner-32 docs initial README file for sphinx documentation folder October 04, 2012
Octocat-spinner-32 interfaces updating the todo list May 12, 2013
Octocat-spinner-32 localization update the localization file March 02, 2014
Octocat-spinner-32 packaging update packaging scripts for Arch/RedHat linuxes February 25, 2014
Octocat-spinner-32 resources fix the root of ملكا , fix #291 February 03, 2014
Octocat-spinner-32 scripts remove unneeded space January 17, 2014
Octocat-spinner-32 src Merge pull request #405 from assem-ch/kill_baidospider April 18, 2014
Octocat-spinner-32 store fix a hidden alef in words , fix #224 November 10, 2013
Octocat-spinner-32 .gitignore Ignore dynamic_resources by git. January 06, 2014
Octocat-spinner-32 .travis.yml fixing travis build process March 07, 2014
Octocat-spinner-32 AUTHORS.rst Add Salaheddine Chelli as a contributor for design in the AUTHORS list March 17, 2014
Octocat-spinner-32 CHANGELOG Update CHANGELOG February 12, 2013
Octocat-spinner-32 COPYING November 06, 2011
Octocat-spinner-32 FAQ.rst update the documentation : pyside instead of pyqt4 #296 February 22, 2014
Octocat-spinner-32 INSTALL.rst create a new Makefile target for simple installation of API & Desktop February 20, 2013
Octocat-spinner-32 LICENSE Move non-python files outside of src folder September 29, 2011
Octocat-spinner-32 Makefile Migrate to use PySide instead of Pyqt4, fix #296 February 22, 2014
Octocat-spinner-32 README.rst updates on the perspective objectives March 17, 2014
Octocat-spinner-32 THANKS.rst Update THANKS.rst August 15, 2012
Octocat-spinner-32 A script to detect big files in git repo, helpful for cleaning the re… February 02, 2014

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.

Authors: Authors.rst
Release: 0.7 BlackStone
License: AGPL
Tracker: Alfanous-team/alfanous/Issues
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)

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

Docutils System Messages

System Message: ERROR/3 (<string>, line 143); backlink

Duplicate target name, cannot be used as a unique reference: "".
Something went wrong with that request. Please try again.