Client SDKs
Idiomatic, hand-written client libraries are available for seven languages.
Each wraps the same gRPC API, takes the same connection config (host, port,
api_key, optional TLS CA cert), and exposes every RPC — including the streaming
Find and Watch calls.
| Language | Install | Reference |
|---|---|---|
| Python | pip install filedbv2 | clients/python |
| JavaScript / TypeScript | npm install filedbv2 | clients/js |
| PHP | composer require srjn45/filedbv2 | clients/php |
| Java | com.srjn45:filedbv2-client (Maven Central) | clients/java |
| Ruby | gem install filedbv2 | clients/ruby |
| Rust | cargo add filedbv2 | clients/rust |
| C# / .NET | dotnet add package FileDBv2.Client | clients/csharp |
Example (Python)
Section titled “Example (Python)”from filedbv2 import Client
db = Client(host="localhost", port=5433, api_key="dev-key")db.insert("users", {"name": "alice", "age": 30})
for rec in db.find("users", {"field": "age", "op": "gt", "value": 18}): print(rec["data"])Generate your own
Section titled “Generate your own”Prefer to generate a client, or working in a language without a hand-written
SDK? The checked-in OpenAPI spec (docs/openapi/filedb.swagger.json) is
generated from the proto and covers every RPC. Feed it to
openapi-generator for any language.
See the API reference for details on the gRPC and REST surfaces.
Web admin UI
Section titled “Web admin UI”There’s also a browser-based collection and record manager under
clients/web/
(React + Vite), which talks to the REST gateway.