open-index/open-npm huggingface dataset:
npm package: @qdrant/js-client-grpc
Description: This repository contains the gRPC client for the [Qdrant](https://github.com/qdrant/qdrant) vector search engine.
Latest version: 1.17.0

# JavaScript Qdrant gRPC Client

This repository contains the gRPC client for the [Qdrant](https://github.com/qdrant/qdrant) vector search engine.

## Installation

```shell
npm install @qdrant/js-client-grpc
# or
yarn add @qdrant/js-client-grpc
# or
pnpm i @qdrant/js-client-grpc
```

## Usage

Run the Qdrant Docker container:

```shell
docker run -p 6334:6334 qdrant/qdrant
```

## Instantiate a client

```ts
import {QdrantClient} from '@qdrant/js-client-grpc';

const client = new QdrantClient({host: '127.0.0.1', port: 6334});
// or
const client = new QdrantClient({url: 'http://127.0.0.1:6334'});
```

## Make requests

Use an endpoint from `collections` API:

```ts
try {
    const result = await client.api('collections').list({});
    console.log('List of collections:', result.collections);
} catch (err) {
    console.error('Could not get collections:', err);
}
```

## Support

The gRPC implementation relies on the native node module `node:https`. For the time being, no JavaScript runtime other than Node / Deno are supported (though support for web may be added). Both Deno and Node support full-duplex, HTTP trailers and all the necessary bits for gRPC. Under the hood, the client uses [`connect-es`](https://github.com/bufbuild/connect-es/) to communicate with the server.

## Releases

Major and minor versions align with Qdrant's engine releases, whilst patch are reserved for fixes regarding the current minor release. Check out [RELEASE.md](../../RELEASE.md) for more info on release guidelines.

## Contributing

These are the most relevant scripts for development:

-   `pnpm build`: builds and bundles from TypeScript sources
-   `pnpm pre-check`: type-checks sources
-   `pnpm pre-commit`: same as pre-check, but for git hooks (husky)
-   `pnpm test`: run unit tests
-   `pnpm test:integration`: runs integration tests against a locally running Qdrant docker container
-   `pnpm codegen:grpc-typescript`: updates generated TS classes and types from the latest remote proto files
npm package: @qdrant/qdrant-js
Description: This package represents the JS SDK for the [Qdrant](https://github.com/qdrant/qdrant) vector search engine.
Latest version: 1.17.0

# Qdrant-JS: JavaScript Qdrant SDK

This package represents the JS SDK for the [Qdrant](https://github.com/qdrant/qdrant) vector search engine.

The next packages are re-exported from it:

-   [JS Client REST](../js-client-rest)
-   [JS Client gRPC](../js-client-grpc)

## Installation

```shell
pnpm i @qdrant/qdrant-js
# or
npm install @qdrant/qdrant-js
# or
yarn add @qdrant/qdrant-js
```

## Usage

The REST client is imported from the root path; the gRPC is imported from the `/grpc` subpath:

```js
import {QdrantClient} from '@qdrant/qdrant-js'; // REST client
```

```js
import {QdrantClient} from '@qdrant/qdrant-js/grpc'; // gRPC client
```

It is recommended to use the REST (OpenAPI-based) client initially, since REST tends to be easier to debug. Switch to gRPC when you're APIs are working for increase performance. Bear in mind that for small-size request, REST may be of equal if not more performance than gRPC. gRPC incurs a tiny conversion cost but goes easier on the wire, which makes a difference with big data chunks.

## Contributing

These are the most relevant scripts for development:

-   `pnpm build`: builds and bundles from TypeScript sources
-   `pnpm pre-check`: type-checks sources
-   `pnpm pre-commit`: same as pre-check, but for git hooks (husky)