# arc-vector-rust

Rust client for arc vector search engine.

## Installation

```bash
cargo add arc-vector-rust
```
Or add the following line to your Cargo.toml:

```bash
arc-vector-rust = "1.4.0"
```
Package is available in [crates.io](https://crates.io/crates/arc-vector-rust)

## Dependencies

The client uses gRPC via the [Tonic](https://github.com/hyperium/tonic) library.

To change anything in the protocol buffer definitions, you need the `protoc` Protocol Buffers compiler, along with Protocol Buffers resource files.

Refer to the [Tonic installation guide](https://github.com/hyperium/tonic#dependencies) for more details.

## Usage

Run ArcVector with enabled gRPC interface:

```bash
# With env variable
docker run -p 6333:6333 -p 6334:6334 \
    -e ARC_VECTOR__SERVICE__GRPC_PORT="6334" \
    arc_vector/arc_vector
```

Or by updating the configuration file:

```yaml
service:
  grpc_port: 6334
```

More info about gRPC in [documentation](https://qdrant.tech/documentation/quick-start/).

### Making requests

Add necessary dependencies:

```bash
cargo arc-vector-rust anyhow tonic tokio --features tokio/rt-multi-thread
```

Add search example from [`examples/search.rs`](./examples/search.rs) to your `src/main.rs`:
Or run the example from this project directly:
```bash
cargo run --example search
```