Language clients

Lucenia maintains official client libraries that wrap the REST API with idiomatic, language-specific types and helpers. Use these clients to connect to Lucenia from your applications without hand-rolling HTTP requests.

Supported clients

Language	Package	Install from	Status
Python	lucenia-py	PyPI	Available
JavaScript / Node.js	@lucenia/client	npm	Available
Java	io.lucenia.client:lucenia-java	Maven Central	Available
Go	lucenia-go	—	Not yet publicly downloadable

Each client tracks the Lucenia server version it targets — 0.12.x of the client matches Lucenia 0.12.x of the engine.

The Go module is not yet served from a public repository, so go get cannot resolve it from outside the Lucenia organization. Until it is published, use the OpenSearch Go client against your Lucenia cluster, or one of the three clients above.

Command-line client

For interactive use, scripting, and operations, Lucenia also ships a command-line client:

• Command-line client (CLI) (lucenia) — a kubectl-style binary that wraps the Go client and replaces ad-hoc curl usage.

OpenSearch client compatibility

Because Lucenia exposes the same REST API surface as OpenSearch 2.14.0, OpenSearch language clients will continue to work for the operations they already support. This is the practical route for languages Lucenia does not yet ship a client for — Ruby, PHP, .NET, Rust, Hadoop — and for Go until the module above is published.

warning

While Lucenia shares core APIs with OpenSearch and Elasticsearch, mixing client and cluster versions across distributions carries a real risk of subtle behavioral differences and unexpected results. As Lucenia, OpenSearch, and Elasticsearch continue to diverge, that risk increases. We strongly recommend using the official Lucenia clients listed above for Lucenia clusters.