{"id":26851,"date":"2024-04-02T11:15:37","date_gmt":"2024-04-02T09:15:37","guid":{"rendered":"https:\/\/www.codemotion.com\/magazine\/?p=26851"},"modified":"2024-04-04T15:32:34","modified_gmt":"2024-04-04T13:32:34","slug":"oramasearch-your-new-favorite-search-engine","status":"publish","type":"post","link":"https:\/\/www.codemotion.com\/magazine\/backend\/oramasearch-your-new-favorite-search-engine\/","title":{"rendered":"OramaSearch: Your New Favorite Search Engine"},"content":{"rendered":"\n

What Is OramaSearch<\/h2>\n\n\n\n

Welcome to OpenDev Explorer, where I explore the Open Source world with an eye on developer experience<\/strong>. I am Riccardo (aka TheZal), and today I will talk to you about OramaSearch, an open-source search engine with a “battery included” and zero dependencies.<\/p>\n\n\n\n

General Overview<\/h2>\n\n\n\n

“It’s not the finding, but the searching<\/em>” is one of the mottos of OramaSearch, an open-source search engine ready out of the box and with zero dependencies. Originally named Lyra as an exercise for a talk by Michele Riva<\/strong> to explain how a full-text search engine works, it has since become a real project thanks to the feedback from the community (5800 stars on GitHub and thousands of downloads in a few months)<\/a> who found in Orama Search a powerful and optimized search engine that is simple to use and able to meet all the community’s requests.<\/p>\n\n\n\n

Instruction Manual<\/h2>\n\n\n\n

Installation<\/h3>\n\n\n\n

Installing OramaSearch is very simple; it is available on all major package managers (npm, yarn, pnpm) and can be installed with a simple command:<\/p>\n\n\n

npm<\/span> i<\/span> @orama<\/span>\/orama<\/code><\/span>Code language:<\/span> CSS<\/span> (<\/span>css<\/span>)<\/span><\/small><\/pre>\n\n\n
Or you can directly import it into a browser module:<\/p>\n\n\n
<html<\/span>><\/span>\n  <body<\/span>><\/span>\n    <script<\/span> type<\/span>=\"module\"<\/span>><\/span>\n      import<\/span> { create, search, insert } from<\/span> 'https:\/\/unpkg.com\/@orama\/orama@latest\/dist\/index.js'<\/span>\n      \/\/ ...<\/span>\n    <\/span><\/script<\/span>><\/span>\n  <\/body<\/span>><\/span>\n<\/html<\/span>><\/span><\/code><\/span>Code language:<\/span> HTML, XML<\/span> (<\/span>xml<\/span>)<\/span><\/small><\/pre>\n\n\n
Usage<\/h2>\n\n\n\n
First, you need to create a new instance (from now on database) with an index schema.<\/p>\n\n\n\n
The schema represents the searchable properties of the document to be inserted into the database. It is also possible to have additional unindexed properties, as long as these are not needed in the search.<\/p>\n\n\n\n
An example of usage (taken directly from the official documentation) is as follows:<\/p>\n\n\n
import<\/span> { create, search, insert } from<\/span> '@orama\/orama'<\/span>\n\nconst<\/span> db = await<\/span> create({\n  schema<\/span>: {\n    name<\/span>: 'string'<\/span>,\n    description<\/span>: 'string'<\/span>,\n    price<\/span>: 'number'<\/span>,\n    meta<\/span>: {\n      rating<\/span>: 'number'<\/span>,\n    },\n  },\n})\n\nawait<\/span> insert(db, {\n  name<\/span>: 'Wireless Headphones'<\/span>,\n  description<\/span>: 'Experience immersive sound quality with these noise-cancelling wireless headphones.'<\/span>,\n  price<\/span>: 99.99<\/span>,\n  meta<\/span>: {\n    rating<\/span>: 4.5<\/span>,\n  },\n})\n\nconst<\/span> searchResult = await<\/span> search(db, {\n  term<\/span>: 'headphones'<\/span>,\n})\n\nconsole<\/span>.log(searchResult.hits.map((hit<\/span>) =><\/span> hit.document))<\/code><\/span>Code language:<\/span> JavaScript<\/span> (<\/span>javascript<\/span>)<\/span><\/small><\/pre>\n\n\n
The Developer Experience With OramaSearch<\/h2>\n\n\n\n
The greatest success of Orama Search is that the community turned it into a real project (and product). The community has acclaimed Orama thanks to its fantastic developer experience and simplicity of use.<\/p>\n\n\n\n
Several points improve the developer experience of OramaSearch:<\/p>\n\n\n\n
1 – The documentation is clear and well-done
2 – The community is very active and responds very quickly to questions asked on GitHub or Slack
3 – The library is very well written and allows you to start using it in a few minutes
4 – Orama provides several official plugins that allow the use of Orama in different contexts (such as on Astro)<\/p>\n\n\n\n
The Extra Mile<\/h2>\n\n\n\n
OramaSearch has some features that give it an extra mile, making it a very powerful and flexible search engine.<\/p>\n\n\n\n
Having been designed to contain a vector database inside, OramaSearch natively implements vector search of elements.<\/p>\n\n\n\n
It also implements geo-search functionality, allowing searching for elements based on their geographical location.<\/p>\n\n\n\n
Comparison with the Status Quo<\/h2>\n\n\n\n
There are several full-text search engines (such as ElasticSearch), but I don’t think there is one on the market that has the same arsenal as OramaSearch.<\/p>\n\n\n\n
However, I am sure that at the moment there is no utility as powerful as Orama that shares its simplicity of use, making Orama Search unique in its kind.<\/p>\n\n\n\n
Regarding search speed, Orama Search is one of the fastest search engines I have ever tried, and this is another point in its favor.<\/p>\n\n\n\n
\n