OpenFS Adapters

OpenFS Adapters

Adapters implement the IFileSystem interface so any storage backend works with OpenFS agents, tools, and servers.

adapter-sqlite

Local

Bun:sqlite + FTS5 full-text search. Best for development and single-machine deployments. Fastest read/write.

adapter-wasm (in-browser)

Browser

sql.js SQLite compiled to WASM. Runs entirely in browser or any JS runtime with zero native dependencies.

adapter-s3

Cloud

S3/MinIO object storage. Each file is an S3 object. Text search via $contains. Perfect for large document collections.

adapter-chroma

Vector

Chroma vector DB. Semantic similarity search via embeddings. Best for AI agents that need concept-based retrieval.

adapter-postgres

Remote

PostgreSQL with full-text search. Production-grade, multi-user, ACID compliant. Scales to millions of documents.

adapter-turso

Cloud

Turso (libSQL) edge database. SQLite-compatible, globally distributed. Great for edge/serverless deployments.

adapter-mysql

Remote

MySQL/MariaDB adapter. FULLTEXT search support. Familiar to most backend teams.

Switching Adapters

// Same agent code, any backend
const fs = await createSqliteFs({ path: "./data.db" });
// or:
const fs = await createChromaFs({ url: "http://localhost:8000" });
// or:
const fs = await createAgentFs({ writable: true }); // WASM