Areev Rust SDK

Rust client library for the Areev knowledge database.

Installation

[dependencies]
areev = "0.1"

For gRPC transport:

[dependencies]
areev = { version = "0.1", features = ["grpc"] }

Quick Start

use areev::Areev;

#[tokio::main]
async fn main() -> areev::Result<()> {
    let areev = Areev::from_env(); // reads AREEV_API_KEY, AREEV_URL from env

    areev.remember("John likes coffee").await?;

    let results = areev.recall("what does John like?").await?;
    for hit in &results.results {
        println!("{}: {:?}", hit.grain_type, hit.fields);
    }

    Ok(())
}

Configuration

The client reads from environment variables by default:

Or pass them explicitly:

let areev = Areev::new(
    Some("ar_..."),                // api_key
    Some("https://dub.areev.ai"), // url
    Some("my-memory"),            // memory_id
);

API

Low-Level Client

For advanced use cases (custom request objects, gRPC transport):

use areev::{HttpClient, AddRequest, GrainType};

let client = HttpClient::new("http://localhost:4009", "default", Some("api-key"));
let resp = client.add(&AddRequest {
    grain_type: GrainType::Belief,
    fields: serde_json::json!({"subject": "john", "relation": "likes", "object": "coffee"}),
    options: None,
}).await?;

Transports

License

BUSL-1.1