Skip to content

Configuration

Grafeo can be configured for different use cases, from small embedded applications to high-performance server deployments.

Database Modes

In-Memory Mode

For temporary data or maximum performance:

import grafeo

# In-memory database (default)
db = grafeo.GrafeoDB()

use grafeo::GrafeoDB;

let db = GrafeoDB::new_in_memory();

Data Persistence

In-memory databases do not persist data. All data is lost when the database is closed.

Persistent Mode

For durable storage:

import grafeo

# Persistent database
db = grafeo.GrafeoDB(path="my_graph.db")

use grafeo::GrafeoDB;

let db = GrafeoDB::open("my_graph.db")?;

Configuration Options

Python and Node.js constructors

The Python and Node.js constructors accept only path and cdc parameters. Advanced configuration options (memory_limit, threads, read_only, etc.) are only available in the Rust API via the Config builder.

Memory Limit (Rust only)

Control the maximum memory usage:

use grafeo::{GrafeoDB, Config};

let config = Config::builder()
    .memory_limit(4 * 1024 * 1024 * 1024)  // 4 GB
    .build()?;

let db = GrafeoDB::with_config(config)?;

Thread Pool Size (Rust only)

Configure parallelism:

use grafeo::{GrafeoDB, Config};

let config = Config::builder()
    .threads(8)
    .build()?;

let db = GrafeoDB::with_config(config)?;

Default Thread Count

By default, Grafeo uses the number of available CPU cores.

Configuration Reference

Option Type Default Availability Description
path string None All (Rust, Python, Node.js) Database file path (None for in-memory)
cdc bool false All (Rust, Python, Node.js) Enable change data capture
memory_limit int System RAM Rust only (Config builder) Maximum memory usage in bytes
threads int CPU cores Rust only (Config builder) Number of worker threads
read_only bool false Rust only (Config builder) Open database in read-only mode

Environment Variables

Grafeo can also be configured via environment variables:

Variable Description
GRAFEO_MEMORY_LIMIT Maximum memory in bytes
GRAFEO_THREADS Number of worker threads
GRAFEO_LOG_LEVEL Logging level (error, warn, info, debug, trace)

Performance Tuning (Rust)

Advanced tuning is available via the Rust Config builder. Python and Node.js users get sensible defaults automatically.

For High-Throughput Workloads

use grafeo::{GrafeoDB, Config};

let config = Config::builder()
    .path("high_throughput.db")
    .memory_limit(8 * 1024 * 1024 * 1024)  // 8 GB
    .threads(16)
    .build()?;

let db = GrafeoDB::with_config(config)?;

For Low-Memory Environments

use grafeo::{GrafeoDB, Config};

let config = Config::builder()
    .path("embedded.db")
    .memory_limit(256 * 1024 * 1024)  // 256 MB
    .threads(2)
    .build()?;

let db = GrafeoDB::with_config(config)?;

For Read-Heavy Workloads

use grafeo::{GrafeoDB, Config};

// Multiple read replicas can be opened read-only
let config = Config::builder()
    .path("replica.db")
    .read_only(true)
    .build()?;

let db = GrafeoDB::with_config(config)?;

Next Steps