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.

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
>>> alfanous.search(u"الله")
>>> alfanous.do({"action":"search","query":u"الله"})
>>> alfanous.do({"action":"search","query":u"Allh"}) # Buckwalter transliteration

You can use it also from the web service:

http://alfanous.org/jos2 ? action=search & query=الله

http://alfanous.org/jos2 ? action=search & query=Allh

• More about Install
• More about API

• 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: [email protected].

• 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

• Link to Magister Thesis Research gate Slideshare
• Link to General Behavior Schema.

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:

• Alfanous4WinStore by FenyLab , source : here.
• Alfanous4WP7 by Abdelmoumen BOUABDALLAH , source: here.
• Alfanous4Iphone by i4islam, source: closed.

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

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

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 Mar2015: 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: http://m.alfanous.org/, 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: http://wui.alfanous.org
• 26 July 2011: Launching json_web_service of Alfanous ,this service is available in the link: http://www.alfanous.org/json
• 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”.

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

1. Application Programming Interface & Console Interface
2. JSON output system
3. Desktop Interface
4. Django application
5. Packaging