inferadb 0.1.5

Official Rust SDK for InferaDB
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82

# Installation & Configuration

## Basic Installation

Add inferadb to your `Cargo.toml`:

```toml
[dependencies]
inferadb = "0.1"
```

This includes both gRPC and REST transports with pure-Rust TLS.

## Feature Flags

| Feature      | Default | Description                            |
| ------------ | ------- | -------------------------------------- |
| `grpc`       | Yes     | gRPC transport (faster, streaming)     |
| `rest`       | Yes     | REST transport (broader compatibility) |
| `rustls`     | Yes     | Pure-Rust TLS                          |
| `native-tls` | No      | System TLS (OpenSSL/Schannel)          |
| `tracing`    | No      | OpenTelemetry integration              |
| `blocking`   | No      | Sync/blocking API wrapper              |
| `derive`     | No      | Proc macros for type-safe schemas      |
| `wasm`       | No      | Browser/WASM support (REST only)       |

## Optimized Builds

### REST Only (Smaller Binary)

```toml
[dependencies]
inferadb = { version = "0.1", default-features = false, features = ["rest", "rustls"] }
```

### gRPC Only (Lower Latency)

```toml
[dependencies]
inferadb = { version = "0.1", default-features = false, features = ["grpc", "rustls"] }
```

### With Tracing

```toml
[dependencies]
inferadb = { version = "0.1", features = ["tracing"] }
```

## TLS Options

### Pure-Rust TLS (Default)

Uses `rustls` with Mozilla's root certificates. No system dependencies.

### Native TLS

Uses the system TLS library (OpenSSL on Linux, Secure Transport on macOS, Schannel on Windows):

```toml
[dependencies]
inferadb = { version = "0.1", default-features = false, features = ["grpc", "rest", "native-tls"] }
```

## Minimum Supported Rust Version

The MSRV is **1.88.0**. We target approximately two releases behind stable.

- MSRV increases are documented in the [CHANGELOG](../../CHANGELOG.md)
- The `rust-version` field in `Cargo.toml` enforces this at build time
- Earlier compiler versions are not guaranteed to work

## WASM / Browser Support

For browser environments, use REST-only with the `wasm` feature:

```toml
[dependencies]
inferadb = { version = "0.1", default-features = false, features = ["rest", "wasm"] }
```

Note: gRPC is not supported in WASM environments.