Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/henomis/qdrant-go
Unofficial Go client for Qdrant vector search engine
https://github.com/henomis/qdrant-go
ai database go qdrant vector
Last synced: 13 days ago
JSON representation
Unofficial Go client for Qdrant vector search engine
- Host: GitHub
- URL: https://github.com/henomis/qdrant-go
- Owner: henomis
- License: mit
- Created: 2023-06-16T09:37:58.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2023-11-25T21:03:05.000Z (12 months ago)
- Last Synced: 2024-06-21T19:59:34.354Z (5 months ago)
- Topics: ai, database, go, qdrant, vector
- Language: Go
- Homepage: https://simonevellei.com
- Size: 57.6 KB
- Stars: 3
- Watchers: 1
- Forks: 3
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Unofficial Go client for Qdrant vector search engine
[](https://godoc.org/github.com/henomis/qdrant-go) [](https://goreportcard.com/report/github.com/henomis/qdrant-go) [](https://github.com/henomis/qdrant-go/releases)
This is [Qdrant](https://qdrant.tech/)'s **unofficial** Go client, designed to enable you to use Qdrant's services easily from your own applications.
## Qdrant
[Qdrant](https://qdrant.tech/) is a vector database that allows you to build high-performance vector search applications.
## API support
### collections
- ✅ list
- ✅ create
- ✅ collect info
- ✅ update
- ✅ delete
- ❌ update aliases
- ✅ create index
- ✅ delete index
- ❌ cluster info
- ❌ update cluster setup
- ❌ list aliases
- ❌ recover from uploaded snapshot
- ❌ recover from snapshot
- ❌ create snapshot
- ❌ delete snapshot
- ❌ download snapshot
### points
- ✅ get point
- ✅ get points
- ✅ upsert points
- ✅ delete points
- ✅ update vectors
- ✅ delete vectors
- ❌ set payload
- ❌ overwrite payload
- ❌ delete payload
- ❌ clear payload
- ❌ scroll payload
- ✅ search points
- ❌ search batch points
- ❌ search point groups
- ❌ recommend points
- ❌ recommend batch points
- ❌ recommend point groups
- ❌ count points
### cluster
- ❌ cluster status info
- ❌ tries to recover current peer Raft state
- ❌ remove peer
- ❌ collection cluster info
- ❌ update collection cluster setup
### snapshots
- ❌ recover from uploaded snapshot
- ❌ recover from snapshot
- ❌ list collection snapshots
- ❌ create collection snapshot
- ❌ delete collection snapshot
- ❌ download collection snapshot
- ❌ list storage snapshots
- ❌ create storage snapshot
- ❌ delete storage snapshot
- ❌ download storage snapshot
### service
- ❌ collect telemetry data
- ❌ collect Prometheus metrics data
- ❌ set lock options
- ❌ get lock options
## Getting started
### Installation
You can load qdrant-go into your project by using:
```
go get github.com/henomis/qdrant-go
```
### Run Qdrant
You can run Qdrant using Docker:
```shell
docker run -p 6333:6333 --name qdrant --rm -v $(pwd)/config.yaml:/qdrant/config/production.yaml qdrant/qdrant
```
config.yaml file:
```yaml
service:
api_key: secret-api-key
```
Please refer to the [official documentation](https://qdrant.tech/) for more information about Qdrant.
### Configuration
The only thing you need to start using Qdrant's APIs is the API key. Copy and paste it in the corresponding place in the code, select the API and the parameters you want to use, and that's it.
### Usage
Please refer to the [examples folder](examples/cmd/) to see how to use the SDK.
Here below a simple usage example:
```go
package main
import (
"context"
"fmt"
qdrantgo "github.com/henomis/qdrant-go"
"github.com/henomis/qdrant-go/request"
"github.com/henomis/qdrant-go/response"
)
func main() {
client := qdrantgo.New("http://localhost:6333", "secret-api-key")
onDisk := true
resp := &response.CollectionCreate{}
err := client.CollectionCreate(
context.Background(),
&request.CollectionCreate{
CollectionName: "test",
Vectors: request.VectorsParams{
Size: 4,
Distance: request.DistanceCosine,
OnDisk: &onDisk,
},
},
resp,
)
if err != nil {
panic(err)
}
fmt.Printf("resp: %#v\n", resp)
}
```
## Who uses qdrant-go?
- [LinGoose](https://github.com/henomis/lingoose) Go framework for building awesome LLM apps