{"id":19000458,"url":"https://github.com/typesense/showcase-songs-search","last_synced_at":"2025-04-04T15:09:25.369Z","repository":{"id":56445828,"uuid":"306818877","full_name":"typesense/showcase-songs-search","owner":"typesense","description":"A site to instantly search 32M songs from the MusicBrainz songs database, using Typesense Search (an open source alternative to Algolia / ElasticSearch) ⚡ 🎵 🔍","archived":false,"fork":false,"pushed_at":"2025-02-05T00:52:57.000Z","size":5265,"stargazers_count":181,"open_issues_count":4,"forks_count":22,"subscribers_count":11,"default_branch":"master","last_synced_at":"2025-03-28T14:08:00.764Z","etag":null,"topics":["instantsearch-js","musicbrainz","typesense","typesense-instantsearch-adapter"],"latest_commit_sha":null,"homepage":"https://songs-search.typesense.org","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/typesense.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2020-10-24T06:15:11.000Z","updated_at":"2025-02-16T23:32:44.000Z","dependencies_parsed_at":"2025-03-21T13:13:12.539Z","dependency_job_id":"3aefead9-f8b1-44cc-a528-630fe1e2492e","html_url":"https://github.com/typesense/showcase-songs-search","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/typesense%2Fshowcase-songs-search","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/typesense%2Fshowcase-songs-search/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/typesense%2Fshowcase-songs-search/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/typesense%2Fshowcase-songs-search/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/typesense","download_url":"https://codeload.github.com/typesense/showcase-songs-search/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247198461,"owners_count":20900080,"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":["instantsearch-js","musicbrainz","typesense","typesense-instantsearch-adapter"],"created_at":"2024-11-08T18:07:17.931Z","updated_at":"2025-04-04T15:09:25.351Z","avatar_url":"https://github.com/typesense.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🎶 MusicBrainz Song Search, powered by Typesense\n\nThis is a demo that showcases some of [Typesense's](https://github.com/typesense/typesense) features using a 32 Million database of songs.\n\nView it live here: [songs-search.typesense.org](https://songs-search.typesense.org/)\n\n## Tech Stack\n\nThis search experience is powered by \u003ca href=\"https://typesense.org\" target=\"_blank\"\u003eTypesense\u003c/a\u003e which is\na blazing-fast, \u003ca href=\"https://github.com/typesense/typesense\" target=\"_blank\"\u003eopen source\u003c/a\u003e typo-tolerant\nsearch-engine. It is an open source alternative to Algolia and an easier-to-use alternative to ElasticSearch.\n\nThe songs dataset is from \u003ca href=\"https://musicbrainz.org/\" target=\"_blank\"\u003eMusicBrainz\u003c/a\u003e which is an open\nmusic encyclopedia that collects music metadata and makes it available to the public. Please contribute to it if you're able to!\n\nThe app was built using the \u003ca href=\"https://github.com/typesense/typesense-instantsearch-adapter\" target=\"_blank\"\u003e\nTypesense Adapter for InstantSearch.js\u003c/a\u003e and is hosted on \u003ca href=\"https://www.digitalocean.com/products/app-platform/\" target=\"_blank\"\u003eDigitalOcean's App Platform\u003c/a\u003e.\n\nThe search backend is powered by a geo-distributed 3-node Typesense cluster running on \u003ca href=\"https://cloud.typesense.org\" target=\"_blank\"\u003eTypesense Cloud\u003c/a\u003e,\nwith nodes in Oregon, Frankfurt and Mumbai.\n\n## Repo structure\n\n- `src/` and `index.html` - contain the frontend UI components, built with \u003ca href=\"https://github.com/typesense/typesense-instantsearch-adapter\" target=\"_blank\"\u003eTypesense Adapter for InstantSearch.js\u003c/a\u003e\n- `scripts/indexer` - contains the script to index the MusicBrainz data into Typesense.\n- `scripts/data` - contains a 1K sample subset of the MusicBrainz songs database. But you can download the full dataset from their website.\n- `scripts/benchmarking` - contains a [k6](https://k6.io) script to load test the Typesense Server.\n\n## Development\n\nTo run this project locally, install the dependencies and run the local server:\n\n```sh\nnpm install -g parcel-bundler # Need to use NPM for this: https://github.com/parcel-bundler/parcel/issues/1036#issuecomment-559982275\n\nyarn\nyarn run typesenseServer\nln -s .env.development .env\nBATCH_SIZE=1000 yarn run indexer\nyarn start\n```\n\nOpen http://localhost:3000 to see the app.\n\n## Deployment\n\nThe app is hosted on [DigitalOcean App Platform](https://www.digitalocean.com/products/app-platform/).\n\nPushing to master will deploy the app to production.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftypesense%2Fshowcase-songs-search","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftypesense%2Fshowcase-songs-search","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftypesense%2Fshowcase-songs-search/lists"}