{"id":18802398,"url":"https://github.com/jd-opensource/vearch","last_synced_at":"2026-01-05T04:30:13.487Z","repository":{"id":241072337,"uuid":"710238357","full_name":"jd-opensource/vearch","owner":"jd-opensource","description":null,"archived":false,"fork":false,"pushed_at":"2024-11-18T01:36:56.000Z","size":36173,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2024-12-29T20:16:18.924Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Go","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/jd-opensource.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":"GOVERNANCE.md","roadmap":"ROADMAP.md","authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-10-26T09:48:53.000Z","updated_at":"2024-11-18T01:37:00.000Z","dependencies_parsed_at":null,"dependency_job_id":"0782de9d-559e-4c37-9b2f-f754f52565ec","html_url":"https://github.com/jd-opensource/vearch","commit_stats":null,"previous_names":["jd-opensource/vearch"],"tags_count":14,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jd-opensource%2Fvearch","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jd-opensource%2Fvearch/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jd-opensource%2Fvearch/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jd-opensource%2Fvearch/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jd-opensource","download_url":"https://codeload.github.com/jd-opensource/vearch/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":239735262,"owners_count":19688262,"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":[],"created_at":"2024-11-07T22:27:51.768Z","updated_at":"2026-01-05T04:30:13.404Z","avatar_url":"https://github.com/jd-opensource.png","language":"Go","readme":"\u003cdiv align=\"center\"\u003e\n  \u003cimg src=\"assets/vearch_logo.png\"\u003e\n  \u003cp\u003e\n    \u003ca href=\"https://github.com/vearch/vearch/blob/master/README_ZH_CN.md\"\u003e简体中文\u003c/a\u003e | \u003ca href=\"https://github.com/vearch/vearch/blob/master/README.md\"\u003eEnglish\u003c/a\u003e\n  \u003c/p\u003e\n\u003c/div\u003e\n\n[![License: Apache-2.0](https://img.shields.io/badge/License-Apache--2.0-blue.svg)](./LICENSE)\n[![Build Status](https://github.com/vearch/vearch/actions/workflows/CI.yml/badge.svg)](https://github.com/vearch/vearch/actions/workflows/CI.yml)\n[![Go Report Card](https://goreportcard.com/badge/github.com/vearch/vearch/v3)](https://goreportcard.com/report/github.com/vearch/vearch/v3)\n[![Gitter](https://badges.gitter.im/vector_search/community.svg)](https://gitter.im/vector_search/community?utm_source=badge\u0026utm_medium=badge\u0026utm_campaign=pr-badge)\n\n## Overview\n\nVearch is a cloud-native distributed vector database for efficient similarity search of embedding vectors in your AI applications.\n\n## Key features\n\n- **Hybrid search**: Both vector search and scalar filtering.\n\n- **Performance**: Fast vector retrieval - search from millions of objects in milliseconds.\n\n- **Scalability \u0026 Reliability**: Replication and elastic scaling out.\n\n## Document\n\n### Restful APIs\n\n- [Tutorial](https://vearch.readthedocs.io/en/latest) | [参考文档](https://vearch.readthedocs.io/zh_CN/latest)\n\n### OpenAPIs\n\n- [Tutorial](https://vearch.github.io/tools#/)\n\n### SDK\n\n- **[Python SDK](sdk/python/README.md)**\n\n- **[Go SDK](sdk/go/README.md)**\n\n- **[Java SDK(under development)](sdk/java/README.md)**\n\n## Usage cases\n\n### Use Vearch as a memory backend\n\n- **[Langchain](sdk/integrations/langchain/README.md)**\n\n- **[LlamaIndex](sdk/integrations/llama-index/README.md)**\n\n- **[Langchaingo](sdk/integrations/langchaingo/vearch/README.md)**\n\n- **[LangChain4j](sdk/integrations/langchain4j/README.md)**\n\n### Real world Demos\n\n- **[VisualSearch](docs/Quickstart.md)**: Vearch can be leveraged to build a complete visual search system to index billions of images. The image retrieval plugin for object detection and feature extraction is also required.\n\n## Quick start\n\n**[Deploy vearch cluster on k8s](https://vearch.github.io/vearch-helm/)**\n\n**Add charts through the repo**\n\n```\n$ helm repo add vearch https://vearch.github.io/vearch-helm\n$ helm repo update \u0026\u0026 helm install my-release vearch/vearch\n```\n\n**Add charts from local**\n\n```\n$ git clone https://github.com/vearch/vearch-helm.git \u0026\u0026 cd vearch-helm\n$ helm install my-release ./charts -f ./charts/values.yaml\n```\n\n**Start by docker-compose**\n\nstandalone mode\n\n```\n$ cd cloud\n$ cp ../config/config.toml .\n$ docker-compose --profile standalone up -d\n```\n\ncluster mode\n\n```\n$ cd cloud\n$ cp ../config/config_cluster.toml .\n$ docker-compose --profile cluster up -d\n```\n\n**Deploy by docker**: Quickly start with vearch docker image, please see [DeployByDocker](docs/DeployByDocker.md)\n\n**Compile by source code**: Quickly compile the source codes, please see [SourceCompileDeployment](docs/SourceCompileDeployment.md)\n\n## Components\n\n**Vearch Architecture**\n\n![arc](assets/architecture.excalidraw.png)\n\n**Master**: Responsible for schema management, cluster-level metadata, and resource coordination.\n\n**Router**: Provides RESTful API: `upsert`, `delete`, `search` and `query`; request routing, and result merging.\n\n**PartitionServer (PS)**: Hosts document partitions with raft-based replication. Gamma is the core vector search engine implemented based on [faiss](https://github.com/facebookresearch/faiss). It provides the ability of storing, indexing and retrieving the vectors and scalars.\n\n## Reference\n\nReference to cite when you use Vearch in a research paper:\n\n```\n@misc{li2019design,\n      title={The Design and Implementation of a Real Time Visual Search System on JD E-commerce Platform},\n      author={Jie Li and Haifeng Liu and Chuanghua Gui and Jianyu Chen and Zhenyun Ni and Ning Wang},\n      year={2019},\n      eprint={1908.07389},\n      archivePrefix={arXiv},\n      primaryClass={cs.IR}\n}\n```\n\n## Community\n\nYou can report bugs or ask questions in the [issues page](https://github.com/vearch/vearch/issues) of the repository.\n\nFor public discussion of Vearch or for questions, you can also send email to vearch-maintainers@groups.io.\n\nOur slack : https://vearchworkspace.slack.com\n\n## Known Users\n\nWelcome to register the company name in this issue: https://github.com/vearch/vearch/issues/230 (in order of registration)\n\n![Users](assets/company_logos/all.jpg)\n\n## License\n\nLicensed under the Apache License, Version 2.0. For detail see [LICENSE and NOTICE](https://github.com/vearch/vearch/blob/master/LICENSE).\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjd-opensource%2Fvearch","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjd-opensource%2Fvearch","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjd-opensource%2Fvearch/lists"}