Skip to main content

Storage Backends, Feature Flags & Configuration

This reference covers Cargo feature flags, connector configuration structs, ConnectorCapabilities, middleware defaults, and local Docker infrastructure settings.

Cargo feature matrix​

muninn-aether-adapters (crates/aether-adapters/Cargo.toml)​

Default features are empty (default = []). InMemoryBackend and middleware wrappers (Batcher, Timeout, Resilient, Traced) compile with no feature flags.

FeatureEnablesDependenciesContract integration test
sqlitekv::sqlite::{SqliteConfig, SqliteRecordStore}rusqlite (bundled)driver_sqlite
rediskv::redis::{RedisConfig, RedisKeyLayout, RedisRecordStore}redis (tokio-comp, connection-manager)driver_redis
qdrantstorage::qdrant::{QdrantConfig, QdrantVectorStore}reqwest (json, rustls)driver_qdrant
pgvectorstorage::pgvector::{PgVectorConfig, PgVectorStore}sqlx (postgres, runtime-tokio, tls-rustls), pgvectordriver_pgvector
chromastorage::chroma::{ChromaConfig, ChromaVectorStore}reqwest (json, rustls)driver_chroma
turbopufferstorage::turbopuffer::{TurbopufferConfig, TurbopufferVectorStore}reqwest (json, rustls)driver_turbopuffer
neo4jstorage::neo4j::{Neo4jConfig, Neo4jGraphStore}reqwest (json, rustls)driver_neo4j
contract-suitecontract::{record_store, record_store_concurrent_idempotency, vector_store, graph_store}NoneUsed by all driver_* tests

muninn-aether-sdk (crates/aether-sdk/Cargo.toml)​

FeatureEnablesDependencies
oteltelemetry::{init_otel, LogFormat, OtelConfig, TelemetryGuard} and otel_demo exampleopentelemetry, opentelemetry_sdk, opentelemetry-otlp, opentelemetry-appender-tracing, tracing-opentelemetry, tracing-subscriber
live-dockerEnables sqlite, redis, qdrant, chroma, pgvector, neo4j for tests/live_docker.rsmuninn-aether-adapters driver features

Backend configurations and constructors​

StoreTraitConfig struct and fieldsConstructors and helper methods
InMemoryBackendRecordStore, VectorStore, GraphStoreNoneInMemoryBackend::new(), fail_next(FaultPoint, usize), has_vector(&ProjectId, MemoryId)
SqliteRecordStoreRecordStoreSqliteConfig { path: String }SqliteConfig::in_memory(), SqliteConfig::from_path(path), SqliteRecordStore::open(cfg)
RedisRecordStoreRecordStoreRedisConfig { url: SecretString, key_prefix: String }RedisConfig::new(url, prefix), validate(), key_layout(), RedisRecordStore::connect(cfg)
QdrantVectorStoreVectorStoreQdrantConfig { base_url: String, api_key: Option<SecretString>, collection_prefix: String }QdrantConfig::default() (http://localhost:6333, "aether"), QdrantVectorStore::new(cfg)
PgVectorStoreVectorStorePgVectorConfig { database_url: SecretString, table_name: String, max_connections: u32 }PgVectorConfig::validate(), connect(cfg), connect_lazy(cfg), from_pool(pool, table)
ChromaVectorStoreVectorStoreChromaConfig { base_url: String, tenant: String, database: String, auth_token: Option<SecretString>, collection_prefix: String }ChromaConfig::default() (http://localhost:8000, "default_tenant", "default_database", "aether"), ChromaVectorStore::new(cfg)
TurbopufferVectorStoreVectorStoreTurbopufferConfig { base_url: String, api_key: SecretString, namespace_prefix: String }TurbopufferVectorStore::new(cfg)
Neo4jGraphStoreGraphStoreNeo4jConfig { base_url: String, database: String, username: String, password: SecretString }Neo4jGraphStore::new(cfg), Neo4jGraphStore::with_client(cfg, reqwest_client)

ConnectorCapabilities and describe() behavior​

Connector (name())max_batch_sizesupports_temporalsupports_filter_exprCross-restart VectorStore::describe
in_memory1024truetrueIn-memory only
sqlite512falsefalsen/a (RecordStore)
redis256falsefalsen/a (RecordStore)
qdrant256falsetruePersisted on collection config
pgvector1000falsetruePersisted in <table_name>_specs
chroma1000falsetruePersisted in collection metadata (_aether_dimensions, hnsw:space)
turbopuffer1000falsetrueProcess-cached after initialize
neo4j1000truefalsen/a (GraphStore)

Middleware and OpenTelemetry (otel)​

MemoryManager::builder wraps stores in Batcher (vector only), Timeout, Resilient, and Traced.

WrapperTypeDefaults in MemoryManager::builder
Batcher<T>Vector batch chunkerSplits upsert_batch by capabilities().max_batch_size.max(1)
Timeout<T>Tail-latency guard10s, mapping elapsed timeouts to AetherError::Transient
Resilient<T>Retry decoratorRetryPolicy { max_retries: 3, base_delay: 50ms } with jittered full jitter
Traced<T>OpenTelemetry span emitterEnabled (with_connector_tracing(true)), emitting connector_op spans

OtelConfig::from_env(service_name) reads two standard environment variables:

  • OTEL_EXPORTER_OTLP_ENDPOINT (OTLP gRPC exporter endpoint, defaulting to http://localhost:4317 in Tonic).
  • RUST_LOG (subscriber filter, falling back to info).
  • LogFormat options are Pretty (default), Json, and None. otlp_logs defaults to true.

Local Docker Compose stack (infra/ and scripts/dev-infra.sh)​

./scripts/dev-infra.sh accepts up, down, status, reset, and init-sqlite. It loads .env if present and invokes infra/docker-compose.yml.

Compose serviceImageContainer nameHost port(s)Container port(s).env.example variables
postgrespgvector/pgvector:pg17aether-postgres154325432AETHER_POSTGRES_USER (aether), AETHER_POSTGRES_PASSWORD (aether_dev), AETHER_POSTGRES_DB (aether), AETHER_POSTGRES_PORT (15432), AETHER_POSTGRES_URL
qdrantqdrant/qdrant:latestaether-qdrant16333, 163346333, 6334AETHER_QDRANT_HTTP_PORT (16333), AETHER_QDRANT_GRPC_PORT (16334), AETHER_QDRANT_URL, AETHER_QDRANT_GRPC_URL
neo4jneo4j:5-communityaether-neo4j17474, 176877474, 7687AETHER_NEO4J_USER (neo4j), AETHER_NEO4J_PASSWORD (aether_dev), AETHER_NEO4J_HTTP_PORT (17474), AETHER_NEO4J_BOLT_PORT (17687), AETHER_NEO4J_URI
valkeyvalkey/valkey:8-alpineaether-valkey163796379AETHER_VALKEY_PORT (16379), AETHER_VALKEY_URL
SQLite (host file)Local sqlite3n/an/an/aAETHER_SQLITE_PATH (.aether/dev.db)

PostgreSQL startup executes infra/postgres/init/01-pgvector.sql (CREATE EXTENSION IF NOT EXISTS vector;).