{"id":13392944,"url":"https://github.com/typesense/typesense","last_synced_at":"2025-05-13T16:03:28.695Z","repository":{"id":37254698,"uuid":"79317191","full_name":"typesense/typesense","owner":"typesense","description":"Open Source alternative to Algolia + Pinecone and an Easier-to-Use alternative to ElasticSearch ⚡ 🔍 ✨ Fast, typo tolerant, in-memory fuzzy Search Engine for building delightful search experiences","archived":false,"fork":false,"pushed_at":"2025-05-06T11:24:39.000Z","size":13021,"stargazers_count":22943,"open_issues_count":666,"forks_count":723,"subscribers_count":132,"default_branch":"v29","last_synced_at":"2025-05-06T16:06:44.287Z","etag":null,"topics":["algolia","datastore","elasticsearch","enterprise-search","faceting","full-text-search","fuzzy-search","geosearch","in-memory","instantsearch","merchandising","pinecone","search","search-engine","semantic-search","similarity-search","site-search","synonyms","typo-tolerance","vector-search"],"latest_commit_sha":null,"homepage":"https://typesense.org","language":"C++","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/typesense.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2017-01-18T08:01:47.000Z","updated_at":"2025-05-06T13:31:54.000Z","dependencies_parsed_at":"2022-07-11T00:30:25.068Z","dependency_job_id":"b5a90ee2-3e81-4a4e-a28d-6a625050a756","html_url":"https://github.com/typesense/typesense","commit_stats":{"total_commits":3568,"total_committers":51,"mean_commits":69.96078431372548,"dds":0.5277466367713004,"last_synced_commit":"e9cc6abfb2eeb0c464ab64f35b608acf196a7d21"},"previous_names":[],"tags_count":37,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/typesense%2Ftypesense","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/typesense%2Ftypesense/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/typesense%2Ftypesense/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/typesense%2Ftypesense/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/typesense","download_url":"https://codeload.github.com/typesense/typesense/tar.gz/refs/heads/v29","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253979817,"owners_count":21994039,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["algolia","datastore","elasticsearch","enterprise-search","faceting","full-text-search","fuzzy-search","geosearch","in-memory","instantsearch","merchandising","pinecone","search","search-engine","semantic-search","similarity-search","site-search","synonyms","typo-tolerance","vector-search"],"created_at":"2024-07-30T17:00:39.847Z","updated_at":"2025-05-13T16:03:28.658Z","avatar_url":"https://github.com/typesense.png","language":"C++","readme":"\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://typesense.org\"\u003e\n    \u003cpicture\u003e\n      \u003csource media=\"(prefers-color-scheme: dark)\" srcset=\"assets/typesense_logo_dark.svg\"\u003e\n      \u003cimg src=\"assets/typesense_logo.svg\" alt=\"Typesense\" width=\"600\" /\u003e\n    \u003c/picture\u003e\n  \u003c/a\u003e \n\u003c/p\u003e\n\u003cp align=\"center\"\u003e\n  Typesense is a fast, typo-tolerant search engine for building delightful search experiences.\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  An Open Source Algolia Alternative \u0026 \u003cbr\u003e\n  An Easier-to-Use ElasticSearch Alternative\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n \u003c!-- \u003ca href=\"https://circleci.com/gh/typesense/typesense\"\u003e\u003cimg src=\"https://circleci.com/gh/typesense/typesense.svg?style=shield\u0026circle-token=1addd775339738a3d90869ddd8201110d561feaa\"\u003e\u003c/a\u003e --\u003e\n \u003ca href=\"https://hub.docker.com/r/typesense/typesense/tags\"\u003e\u003cimg src=\"https://img.shields.io/docker/pulls/typesense/typesense\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://github.com/typesense\"\u003e\u003cimg src=\"https://img.shields.io/github/stars/typesense/typesense?label=github%20stars\u0026style=flat\"\u003e\u003c/a\u003e\u003cbr\u003e\n  \u003ca href=\"https://cloud.typesense.org\"\u003e\u003cimg src=\"https://img.shields.io/badge/searches_per_month_on_typesense_cloud-10 Billion-blue\"\u003e\u003c/a\u003e\n\u003cp\u003e\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://typesense.org\"\u003eWebsite\u003c/a\u003e | \n  \u003ca href=\"https://typesense.org/docs/\"\u003eDocumentation\u003c/a\u003e | \n  \u003ca href=\"https://typesense.link/roadmap\"\u003eRoadmap\u003c/a\u003e | \n  \u003ca href=\"https://typesense.link/slack-community\"\u003eSlack Community\u003c/a\u003e | \n  \u003ca href=\"https://threads.typesense.org/kb\"\u003eCommunity Threads\u003c/a\u003e | \n  \u003ca href=\"https://twitter.com/typesense\"\u003eTwitter\u003c/a\u003e\n\u003c/p\u003e\n\u003cbr\u003e\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"assets/typesense_books_demo.gif?raw=true\" alt=\"Typesense Demo\" width=\"459\" /\u003e\n\u003c/p\u003e\n\n✨ Here are a couple of **live demos** that show Typesense in action on large datasets:\n\n- Search a 32M songs dataset from MusicBrainz: [songs-search.typesense.org](https://songs-search.typesense.org/)\n- Search a 28M books dataset from OpenLibrary: [books-search.typesense.org](https://books-search.typesense.org/)\n- Search a 2M recipe dataset from RecipeNLG: [recipe-search.typesense.org](https://recipe-search.typesense.org/)\n- Search 1M Git commit messages from the Linux Kernel: [linux-commits-search.typesense.org](https://linux-commits-search.typesense.org/)\n- Spellchecker with type-ahead, with 333K English words: [spellcheck.typesense.org](https://spellcheck.typesense.org/)\n- An E-Commerce Store Browsing experience: [ecommerce-store.typesense.org](https://ecommerce-store.typesense.org/)\n- GeoSearch / Browsing experience: [airbnb-geosearch.typesense.org](https://airbnb-geosearch.typesense.org/)\n- Search / Browse xkcd comics by topic: [xkcd-search.typesense.org](https://xkcd-search.typesense.org/)\n- Semantic / Hybrid search on 300K HN comments: [hn-comments-search.typesense.org](https://hn-comments-search.typesense.org)\n\n🗣️ 🎥 If you prefer watching videos:\n\n- Here's one where we introduce Typesense and show a walk-through: https://youtu.be/F4mB0x_B1AE?t=144\n- Check out Typesense's recent mention during Google I/O Developer Keynote: https://youtu.be/qBkyU1TJKDg?t=2399\n- Here's one where one of our community members gives an overview of Typesense and shows you an end-to-end demo: https://www.youtube.com/watch?v=kwtHOkf7Jdg\n\n## Quick Links\n\n- [Features](#features)\n- [Benchmarks](#benchmarks)\n- [Roadmap](#roadmap)\n- [Who's using this](#whos-using-this)\n- [Install](#install)\n- [Quick Start](#quick-start)\n- [Step-by-step Walk-through](#step-by-step-walk-through)\n- [API Documentation](#api-documentation)\n- [API Clients](#api-clients)\n- [Search UI Components](#search-ui-components)\n- [FAQ](#faq)\n- [Support](#support)\n- [Contributing](#contributing)\n- [Getting Latest Updates](#getting-latest-updates)\n- [Build from Source](#build-from-source)\n\n## Features\n\n- **Typo Tolerance:** Handles typographical errors elegantly, out-of-the-box.\n- **Simple and Delightful:** Simple to set-up, integrate with, operate and scale.\n- **⚡ Blazing Fast:** Built in C++. Meticulously architected from the ground-up for low-latency (\u003c50ms) instant searches.\n- **Tunable Ranking:** Easy to tailor your search results to perfection.\n- **Sorting:** Dynamically sort results based on a particular field at query time (helpful for features like \"Sort by Price (asc)\").\n- **Faceting \u0026 Filtering:** Drill down and refine results.\n- **Grouping \u0026 Distinct:** Group similar results together to show more variety.\n- **Federated Search:** Search across multiple collections (indices) in a single HTTP request.\n- **Geo Search:** Search and sort by results around a latitude/longitude or within a bounding box.\n- **Vector Search:** Index embeddings from your machine learning models in Typesense and do a nearest-neighbor search. Can be used to build similarity search, semantic search, visual search, recommendations, etc.\n- **Semantic / Hybrid Search:** Automatically generate embeddings from within Typesense using built-in models like S-BERT, E-5, etc or use OpenAI, PaLM API, etc, for both queries and indexed data. This allows you to send JSON data into Typesense and build an out-of-the-box semantic search + keyword search experience.\n- **Conversational Search (Built-in RAG):** Send questions to Typesense and have the response be a fully-formed sentence, based on the data you've indexed in Typesense. Think ChatGPT, but over your own data.\n- **Image Search:** Search through images using text descriptions of their contents, or perform similarity searches, using the CLIP model.\n- **Voice Search:** Capture and send query via voice recordings - Typesense will transcribe (via Whisper model) and provide search results.\n- **Scoped API Keys:** Generate API keys that only allow access to certain records, for multi-tenant applications.\n- **JOINs:** Connect one or more collections via common reference fields and join them during query time. This allows you to model SQL-like relationships elegantly.\n- **Synonyms:** Define words as equivalents of each other, so searching for a word will also return results for the synonyms defined.\n- **Curation \u0026 Merchandizing:** Boost particular records to a fixed position in the search results, to feature them.\n- **Raft-based Clustering:** Setup a distributed cluster that is highly available.\n- **Seamless Version Upgrades:** As new versions of Typesense come out, upgrading is as simple as swapping out the binary and restarting Typesense.\n- **No Runtime Dependencies:** Typesense is a single binary that you can run locally or in production with a single command.\n\n**Don't see a feature on this list?** Search our issue tracker if someone has already requested it and add a comment to it explaining your use-case, or open a new issue if not. We prioritize our roadmap based on user feedback, so we'd love to hear from you.\n\n## Roadmap\n\nHere's Typesense's public roadmap: [https://typesense.link/roadmap](https://typesense.link/roadmap).\n\nThe first column also explains how we prioritize features, how you can influence prioritization and our release cadence. \n\n## Benchmarks\n\n- A dataset containing **2.2 Million recipes** (recipe names and ingredients):\n  - Took up about 900MB of RAM when indexed in Typesense\n  - Took 3.6mins to index all 2.2M records\n  - On a server with 4vCPUs, Typesense was able to handle a concurrency of **104 concurrent search queries per second**, with an average search processing time of **11ms**.\n- A dataset containing **28 Million books** (book titles, authors and categories):\n  - Took up about 14GB of RAM when indexed in Typesense\n  - Took 78mins to index all 28M records\n  - On a server with 4vCPUs, Typesense was able to handle a concurrency of **46 concurrent search queries per second**, with an average search processing time of **28ms**.\n- With a dataset containing **3 Million products** (Amazon product data), Typesense was able to handle a throughput of **250 concurrent search queries per second** on an 8-vCPU 3-node Highly Available Typesense cluster.\n\nWe'd love to benchmark with larger datasets, if we can find large ones in the public domain. If you have any suggestions for structured datasets that are open, please let us know by opening an issue. We'd also be delighted if you're able to share benchmarks from your own large datasets. Please send us a PR! \n\n## Who's using this?\n\nTypesense is used by a range of users across different domains and verticals.\n\nOn Typesense Cloud we serve more than **10 BILLION** searches per month. Typesense's Docker images have been downloaded over 12M times.\n\nWe've recently started documenting who's using it in our [Showcase](SHOWCASE.md).\nIf you'd like to be included in the list, please feel free to edit [SHOWCASE.md](SHOWCASE.md) and send us a PR.\n\nYou'll also see a list of user logos on the [Typesense Cloud](https://cloud.typesense.org) home page.\n\n## Install\n\n**Option 1:** You can download the [binary packages](https://typesense.org/downloads) that we publish for \nLinux (x86_64 \u0026 arm64) and Mac (x86_64).\n\n**Option 2:** You can also run Typesense from our [official Docker image](https://hub.docker.com/r/typesense/typesense).\n\n**Option 3:** Spin up a managed cluster with [Typesense Cloud](https://cloud.typesense.org):\n\n\u003ca href=\"https://cloud.typesense.org\"\u003e\u003cimg src=\"assets/deploy_with_typesense_cloud.svg?raw=true\" alt=\"Deploy with Typesense Cloud\" height=\"60\" /\u003e\u003c/a\u003e \n\n## Quick Start\n\nHere's a quick example showcasing how you can create a collection, index a document and search it on Typesense.\n \nLet's begin by starting the Typesense server via Docker:\n\n```\ndocker run -p 8108:8108 -v/tmp/data:/data typesense/typesense:28.0 --data-dir /data --api-key=Hu52dwsas2AdxdE\n```\n\nWe have [API Clients](#api-clients) in a couple of languages, but let's use the Python client for this example.\n\nInstall the Python client for Typesense:\n \n```\npip install typesense\n```\n\nWe can now initialize the client and create a `companies` collection:\n\n```python\nimport typesense\n\nclient = typesense.Client({\n  'api_key': 'Hu52dwsas2AdxdE',\n  'nodes': [{\n    'host': 'localhost',\n    'port': '8108',\n    'protocol': 'http'\n  }],\n  'connection_timeout_seconds': 2\n})\n\ncreate_response = client.collections.create({\n  \"name\": \"companies\",\n  \"fields\": [\n    {\"name\": \"company_name\", \"type\": \"string\" },\n    {\"name\": \"num_employees\", \"type\": \"int32\" },\n    {\"name\": \"country\", \"type\": \"string\", \"facet\": True }\n  ],\n  \"default_sorting_field\": \"num_employees\"\n})\n```\n\nNow, let's add a document to the collection we just created:\n\n```python\ndocument = {\n \"id\": \"124\",\n \"company_name\": \"Stark Industries\",\n \"num_employees\": 5215,\n \"country\": \"USA\"\n}\n\nclient.collections['companies'].documents.create(document)\n```\n\nFinally, let's search for the document we just indexed:\n\n```python\nsearch_parameters = {\n  'q'         : 'stork',\n  'query_by'  : 'company_name',\n  'filter_by' : 'num_employees:\u003e100',\n  'sort_by'   : 'num_employees:desc'\n}\n\nclient.collections['companies'].documents.search(search_parameters)\n```\n\n**Did you notice the typo in the query text?** No big deal. Typesense handles typographic errors out-of-the-box!\n\n## Step-by-step Walk-through\n\nA step-by-step walk-through is available on our website [here](https://typesense.org/guide). \n\nThis will guide you through the process of starting up a Typesense server, indexing data in it and querying the data set. \n\n## API Documentation\n\nHere's our official API documentation, available on our website: [https://typesense.org/api](https://typesense.org/api).\n\nIf you notice any issues with the documentation or walk-through, please let us know or send us a PR here: [https://github.com/typesense/typesense-website](https://github.com/typesense/typesense-website).\n\n## API Clients\n\nWhile you can definitely use CURL to interact with Typesense Server directly, we offer official API clients to simplify using Typesense from your language of choice. The API Clients come built-in with a smart retry strategy to ensure that API calls made via them are resilient, especially in an HA setup.\n\n- [JavaScript](https://github.com/typesense/typesense-js)\n- [PHP](https://github.com/typesense/typesense-php)\n- [Python](https://github.com/typesense/typesense-python)\n- [Ruby](https://github.com/typesense/typesense-ruby)\n\nIf we don't offer an API client in your language, you can still use any popular HTTP client library to access Typesense's APIs directly. \n\nHere are some community-contributed clients and integrations:\n\n- [Go](https://github.com/typesense/typesense-go)\n- [.Net](https://github.com/DAXGRID/typesense-dotnet)\n- [Java](https://github.com/typesense/typesense-java)\n- [Rust](https://github.com/typesense/typesense-rust)\n- [Dart](https://github.com/typesense/typesense-dart)\n- [Perl](https://github.com/Ovid/Search-Typesense)\n- [Swift](https://github.com/typesense/typesense-swift)\n- [Clojure](https://github.com/runeanielsen/typesense-clj)\n- [python orm client](https://github.com/RedSnail/typesense_orm)\n- [PHP SEAL Adapter](https://github.com/schranz-search/seal-typesense-adapter)\n- [Elixir](https://github.com/jaeyson/ex_typesense)\n\nWe welcome community contributions to add more official client libraries and integrations. Please reach out to us at contact@typsense.org or open an issue on GitHub to collaborate with us on the architecture. 🙏\n\n### Framework Integrations\n\nWe also have the following framework integrations:\n\n- [Laravel](https://github.com/typesense/laravel-scout-typesense-engine)\n- [Firebase](https://github.com/typesense/firestore-typesense-search)\n- [Gatsby](https://www.gatsbyjs.com/plugins/gatsby-plugin-typesense/)\n- [WordPress](https://wordpress.org/plugins/search-with-typesense/?ref=typesense)\n- [WooCommerce](https://www.codemanas.com/downloads/typesense-search-for-woocommerce/?ref=typesense)\n- [Symfony](https://github.com/acseo/TypesenseBundle)\n- [InstantSearch](https://github.com/typesense/typesense-instantsearch-adapter)\n- [DocSearch](https://typesense.org/docs/guide/docsearch.html)\n- [Docusaurus](https://github.com/typesense/docusaurus-theme-search-typesense)\n- [ToolJet](https://tooljet.com/?ref=typesense)\n- [Plone CMS](https://pypi.org/project/zopyx.typesense/)\n- [Craft CMS](https://plugins.craftcms.com/typesense)\n- [SEAL](https://github.com/schranz-search/schranz-search) provides integrations of Typesense in Laravel, Symfony, Spiral, Yii and Laminas Mezzio PHP Framework\n\n### Postman Collection\n\nWe have a community-maintained Postman Collection here: [https://github.com/typesense/postman](https://github.com/typesense/postman).\n\n[Postman](https://www.postman.com/downloads/) is an app that let's you perform HTTP requests by pointing and clicking, instead of having to type them out in the terminal.\nThe Postman Collection above gives you template requests that you can import into Postman, to quickly make API calls to Typesense.\n\n## Search UI Components\n\nYou can use our [InstantSearch.js adapter](https://github.com/typesense/typesense-instantsearch-adapter) \nto quickly build powerful search experiences, complete with filtering, sorting, pagination and more.\n\nHere's how: [https://typesense.org/docs/guide/search-ui-components.html](https://typesense.org/docs/guide/search-ui-components.html) \n\n## FAQ\n\n### How does this differ from Elasticsearch?\n\nElasticsearch is a large piece of software, that takes non-trivial amount of effort to setup, administer, scale and fine-tune. \nIt offers you a few thousand configuration parameters to get to your ideal configuration. So it's better suited for large teams \nwho have the bandwidth to get it production-ready, regularly monitor it and scale it, especially when they have a need to store \nbillions of documents and petabytes of data (eg: logs).\n\nTypesense is built specifically for decreasing the \"time to market\" for a delightful search experience. It's a light-weight\nyet powerful \u0026 scaleable alternative that focuses on Developer Happiness and Experience with a clean well-documented API, clear semantics \nand smart defaults so it just works well out-of-the-box, without you having to turn many knobs.\n\nElasticsearch also runs on the JVM, which by itself can be quite an effort to tune to run optimally. Typesense, on the other hand, \nis a single light-weight self-contained native binary, so it's simple to setup and operate.\n\nSee a side-by-side feature comparison [here](https://typesense.org/typesense-vs-algolia-vs-elasticsearch-vs-meilisearch/).\n\n### How does this differ from Algolia?\n\nAlgolia is a proprietary, hosted, search-as-a-service product that works well, when cost is not an issue. From our experience,\nfast growing sites and apps quickly run into search \u0026 indexing limits, accompanied by expensive plan upgrades as they scale.\n\nTypesense on the other hand is an open-source product that you can run on your own infrastructure or\nuse our managed SaaS offering - [Typesense Cloud](https://cloud.typesense.org). \nThe open source version is free to use (besides of course your own infra costs). \nWith Typesense Cloud we don't charge by records or search operations. Instead, you get a dedicated cluster\nand you can throw as much data and traffic at it as it can handle. You only pay a fixed hourly cost \u0026 bandwidth charges \nfor it, depending on the configuration your choose, similar to most modern cloud platforms. \n\nFrom a product perspective, Typesense is closer in spirit to Algolia than Elasticsearch. \nHowever, we've addressed some important limitations with Algolia: \n\nAlgolia requires separate indices for each sort order, which counts towards your plan limits. Most of the index settings like \nfields to search, fields to facet, fields to group by, ranking settings, etc \nare defined upfront when the index is created vs being able to set them on the fly at query time.\n\nWith Typesense, these settings can be configured at search time via query parameters which makes it very flexible\nand unlocks new use cases. Typesense is also able to give you sorted results with a single index, vs having to create multiple.\nThis helps reduce memory consumption.\n\nAlgolia offers the following features that Typesense does not have currently: personalization \u0026 server-based search analytics. For analytics, you can still instrument your search on the client-side and send search metrics to your web analytics tool of choice. \n\nWe intend to bridge this gap in Typesense, but in the meantime, please let us know\nif any of these are a show stopper for your use case by creating a feature request in our issue tracker. \n\nSee a side-by-side feature comparison [here](https://typesense.org/typesense-vs-algolia-vs-elasticsearch-vs-meilisearch/).\n\n### Speed is great, but what about the memory footprint?\n\nA fresh Typesense server will consume about 30 MB of memory. As you start indexing documents, the memory use will \nincrease correspondingly. How much it increases depends on the number and type of fields you index. \n\nWe've strived to keep the in-memory data structures lean. To give you a rough idea: when 1 million \nHacker News titles are indexed along with their points, Typesense consumes 165 MB of memory. The same size of that data \non disk in JSON format is 88 MB. If you have any numbers from your own datasets that we can add to this section, please send us a PR!\n\n### Why the GPL license?\n\nFrom our experience companies are generally concerned when **libraries** they use are GPL licensed, since library code is directly integrated into their code and will lead to derivative work and trigger GPL compliance. However, Typesense Server is **server software** and we expect users to typically run it as a separate daemon, and not integrate it with their own code. GPL covers and allows for this use case generously **(eg: Linux is GPL licensed)**. Now, AGPL is what makes server software accessed over a network result in derivative work and not GPL. And for that reason we’ve opted to not use AGPL for Typesense. \n\nNow, if someone makes modifications to Typesense server, GPL actually allows you to still keep the modifications to yourself as long as you don't distribute the modified code. So a company can for example modify Typesense server and run the modified code internally and still not have to open source their modifications, as long as they make the modified code available to everyone who has access to the modified software.\n\nNow, if someone makes modifications to Typesense server and distributes the modifications, that's where GPL kicks in. Given that we’ve published our work to the community, we'd like for others' modifications to also be made open to the community in the spirit of open source. **We use GPL for this purpose.** Other licenses would allow our open source work to be modified, made closed source and distributed, which we want to avoid with Typesense for the project’s long term sustainability.\n\nHere's more background on why GPL, as described by Discourse: https://meta.discourse.org/t/why-gnu-license/2531. Many of the points mentioned there resonate with us.\n\nNow, all of the above only apply to Typesense Server. Our client libraries are indeed meant to be integrated into our users’ code and so they use Apache license.\n\nSo in summary, AGPL is what is usually problematic for server software and we’ve opted not to use it. We believe GPL for Typesense Server captures the essence of what we want for this open source project. GPL has a long history of successfully being used by popular open source projects. Our libraries are still Apache licensed.\n\nIf you have specifics that prevent you from using Typesense due to a licensing issue, we're happy to explore this topic further with you. Please reach out to us.\n\n## Support\n\n👋 🌐 If you have general questions about Typesense, want to say hello or just follow along, we'd like to invite you to join our public [Slack Community](https://typesense.link/slack-community). \n\nIf you run into any problems or issues, please create a GitHub issue and we'll try our best to help.\n\nWe strive to provide good support through our issue trackers on GitHub. However, if you'd like to receive private \u0026 prioritized support with:\n\n- Guaranteed SLAs\n- Phone / video calls to discuss your specific use case and get recommendations on best practices\n- Private discussions over Slack\n- Guidance around scaling best practices\n- Prioritized feature requests\n\nWe offer Paid Support options described [here](https://typesense.org/support/).\n\n## Contributing\n\nWe are a lean team on a mission to democratize search and we'll take all the help we can get! If you'd like to get involved, here's information on where we could use your help: [Contributing.md](https://github.com/typesense/typesense/blob/master/CONTRIBUTING.md)\n\n## Getting Latest Updates\n\nIf you'd like to get updates when we release new versions, click on the \"Watch\" button on the top and select \"Releases only\". GitHub will then send you notifications along with a changelog with each new release.\n\nWe also post updates to our Twitter account about releases and additional topics related to Typesense. Follow us here: [@typesense](https://twitter.com/typesense).\n\n👋 🌐 We'll also post updates on our [Slack Community](https://typesense.link/slack-community). \n\n## Build from source\n\nWe use [Bazel](https://bazel.build) to build Typesense.\n\nTypesense requires the following dependencies: \n\n* C++11 compatible compiler (GCC \u003e= 4.9.0, Apple Clang \u003e= 8.0, Clang \u003e= 3.9.0)\n* Snappy\n* zlib\n* OpenSSL (\u003e=1.0.2)\n* curl\n* ICU\n\nPlease refer to the [CI build steps](.github/workflows/tests.yml) for the latest set of dependencies.\n\nOnce you've installed them, run the following from the root of the repo:\n\n```shell\nbazel build //:typesense-server\n```\n\nThe first build will take some time since other third-party libraries are pulled and built as part of the build process.\n\n---\n\u0026copy; 2016-present Typesense Inc.\n","funding_links":[],"categories":["C++","Search Engines","Install from Source","Search","cpp","数据搜索引擎","Apps","search-engine","\u003ca name=\"cpp\"\u003e\u003c/a\u003eC++","Industry players","Search \u0026 Data","Platforms services and devops"],"sub_categories":["Vectors","Search","网络服务_其他","Development","Products and services","Search (Algolia alternatives)"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftypesense%2Ftypesense","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftypesense%2Ftypesense","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftypesense%2Ftypesense/lists"}