Client Libraries

Client SDKs for Python, TypeScript, Rust and Go live in the open-source HeliosDB-SDKs repository. The Go module installs with go get; the Python, TypeScript and Rust SDKs are not yet published to PyPI, npm or crates.io, so you install them from source.

Python SDK

Client for Nano (branches and vector search; agent memory planned for Nano) and Lite (SQL and branches; vector and agent-memory endpoints planned), with LangChain and LlamaIndex integrations. Not on PyPI: install from source.

pip install "git+https://github.com/HeliosDatabase/HeliosDB-SDKs.git#subdirectory=sdks/python"
Nano Lite Full
GitHub →

TypeScript / JavaScript SDK

Typed client with a fluent query builder. Not on npm: clone the HeliosDB-SDKs repository, build sdks/typescript, then install the local package.

npm install ./HeliosDB-SDKs/sdks/typescript
Nano Lite Full
GitHub →

Rust SDK

HTTP client for remote HeliosDB servers, not on crates.io yet: build it from the HeliosDB-SDKs source. For embedded use, add the published heliosdb-nano crate instead.

git clone https://github.com/HeliosDatabase/HeliosDB-SDKs
Nano Lite Full
GitHub → heliosdb-nano (embedded) on crates.io →

Go SDK

REST client for Nano (branches, vector search, time travel; agent memory planned for Nano) and Lite (SQL and branches; vector and agent-memory endpoints planned), fetched straight from the HeliosDB-SDKs repository.

go get github.com/HeliosDatabase/HeliosDB-SDKs/sdks/go@latest
Nano Lite
GitHub →
Browse all SDKs & integrations → heliosdb-sdks on GitHub →

AI & ML Frameworks

Native integrations with the leading AI and machine learning frameworks. Use HeliosDB as your vector store, agent memory, and retrieval backend.

LangChain

Vector store integration, chat message history, and retrieval chains. Drop-in replacement for any LangChain-compatible vector store.

Nano Lite Full

LlamaIndex

Vector store index with metadata filtering, document retrieval, and hybrid search support for RAG pipelines.

Nano Lite Full

Microsoft AutoGen

Multi-agent framework integration with persistent tool state, shared memory, and conversation history storage.

Nano Lite Full
GitHub →

CrewAI

Agent crews with persistent memory, shared knowledge bases, and task result caching across crew executions.

Nano Lite Full

Model Context Protocol (MCP)

Code-Graph (hdb_code), Graph-RAG (WITH CONTEXT) and the native MCP server ship in HeliosDB Nano as build-from-source features; equivalents for Lite and Full are planned. Nano's MCP server answers over HTTP (POST /mcp, /mcp/ws, /mcp/sse); stdio clients use the HeliosDB CodeKB MCP binary, which embeds Nano.

Nano Lite · Planned Full · Planned
Code-Graph & Graph-RAG → CodeKB MCP →

Wire Protocol Compatibility

Every edition serves the PostgreSQL wire protocol and a REST API; Nano and Full add MySQL, and Full adds Oracle and Redis listeners and an HTTP gateway. On Nano, keep the HTTP and MySQL listeners on loopback (the default): API-key authentication for the HTTP API is planned, and a smaller listening surface is good practice anyway. Each badge carries the edition's status in the Release and Capability Matrix (Available, Available with limitations, In preview or Planned): the best result that HeliosDB's tests or its own production use show on any version of the edition, so no release is named. The statuses come from a draft of the matrix, which is informational until HeliosDB publishes a frozen version. Badges marked Planned are on the roadmap, not in a current release.

PostgreSQL

PostgreSQL wire protocol: psql, pgAdmin and PostgreSQL drivers and ORMs connect. Driver compatibility does not imply complete feature parity with PostgreSQL.

Nano · Available with limitations Lite · Available with limitations Full · Available with limitations

MySQL

MySQL wire protocol for MySQL clients and drivers, opt-in on Nano (--mysql) and Full (--enable-mysql); planned for Lite. Keep the listener on a trusted network: it does not verify passwords yet.

Nano · Available with limitations Lite · Planned Full · Available with limitations

Oracle

Oracle Net (TNS) listener in Full, tested with python-oracledb in thin mode for core DDL, DML and common queries; every statement commits as it runs, and Oracle-specific syntax and PL/SQL need rewriting.

Full · Available with limitations

Redis

RESP2 listener in Full for redis-cli and Redis client libraries; it implements a subset of the Redis commands. The Transaction Durability Commitment does not cover it, because it excludes in-memory key-value stores.

Full · In preview

MongoDB

MongoDB wire compatibility for Full is planned: reading and writing HeliosDB tables from mongosh, Compass and MongoDB drivers. Store documents as JSONB and query them over PostgreSQL today.

Full · Planned

Cassandra

CQL compatibility for Full is planned: reading and writing HeliosDB tables from Cassandra drivers and cqlsh. Use the PostgreSQL interface today.

Full · Planned

SQL Server

TDS compatibility for SQL Server clients is planned for Full. Use the PostgreSQL interface today.

Full · Planned

GraphQL

A GraphQL API for Lite and Full is planned. Today HeliosProxy includes an optional GraphQL gateway (flat top-level selections) that you enable in its configuration.

Lite · Planned Full · Planned

HTTP / REST

RESTful API with OpenAPI spec generation. Query, insert, and manage data over HTTP.

Nano Lite Full

Platform Integrations

Deploy, manage, and connect HeliosDB with the tools and platforms your team already uses.

VS Code Extension

SQL intellisense, inline query runner, schema explorer, and result visualization directly in your editor.

Nano Lite Full
GitHub →

Docker

A container image is published at ghcr.io/heliosdatabase/heliosdb-nano (tags v4.41.1 and latest); it contains the default-feature build, for amd64 and arm64. HeliosProxy is at ghcr.io/heliosdatabase/hdb-heliosdb-proxy. Lite and Full images are provided to licensed customers by HeliosDB sales.

Nano Lite Full

Kubernetes

Helm charts and Kubernetes operators for automated deployment, scaling, and lifecycle management.

Lite Full

Retool

Native database connector for building internal tools. Query HeliosDB directly from Retool dashboards and apps.

Lite Full
GitHub →

Zapier

Workflow automation with triggers on data changes, new rows, and query results. Connect to 5,000+ apps.

Lite Full
GitHub →

n8n

Open-source workflow automation with HeliosDB nodes for reading, writing, and triggering on database events.

Lite Full
GitHub →

AI-Powered Add-ons

Extend your HeliosDB deployment with intelligent support and autonomous database administration.

AI Support

AI-powered knowledge assistant trained on HeliosDB documentation. Instant answers with ready-to-run SQL. Free on Cloud, API key for on-prem.

Learn more →

AI-DBA Agent

Autonomous database administration with proactive monitoring, self-healing, anomaly detection, and performance optimization. For Lite and Full.

Learn more →

Agent Memory API

HeliosDB Full's HTTP gateway (default port 8443) includes an Agent Memory API for AI applications that need persistent conversation context: create sessions, store messages, search them and summarize long conversations over REST. An agent-memory REST API for HeliosDB Nano is planned (the current /v1/agents/memory routes are not functional yet); with Nano today, keep messages and their embeddings in a table and query them over the PostgreSQL wire (see the agent memory example). An agent-memory, vector-store and document-ingest REST API for Lite is planned.

  • Session management — Create, list, read and delete sessions with a title, model, system prompt and metadata.
  • Message history — Add messages in batches and list them; each session keeps its most recent messages (100 by default).
  • Summarization — Summarize the most recent messages with the configured chat model.
  • Memory search — Hybrid BM25 and vector search over a session's messages, next to the vector stores and document search on the same gateway.
Agent Memory
# Create a session (HeliosDB Full)
POST /api/v1/agents/memory
{"title": "support-bot",
 "metadata": {"user_id": "user-123"}}

# Add messages
POST /api/v1/agents/memory/:id/messages/batch
{"messages": [{"role": "user",
  "content": "How do I reset my password?"}]}

# List the session's messages
GET  /api/v1/agents/memory/:id/messages

# Search the session's messages
POST /api/v1/agents/memory/:id/search
{"query": "password reset", "top_k": 5}

# Summarize the most recent messages
POST /api/v1/agents/memory/:id/summarize
{"max_messages": 40}

Ready to Integrate?

Get started with HeliosDB and connect it to your stack in minutes.