Note

Legacy Version

Langchain 0.3.x compatible version of this package is maintained in the 0.3.x branch:

https://github.com/SAP/langchainjs-integration-for-sap-hana-cloud/tree/0.3.x

langchainjs-integration-for-sap-hana-cloud

About this project

Integrates LangChain.js with SAP HANA Cloud to make use of vector search, knowledge graph, and further in-database capabilities as part of LLM-driven applications.

Requirements and Setup

Prerequisites

• NodeJS Enviroment: Since this package uses components from Langchain, please ensure you have a compliant NodeJS environment installed from here
• Peer Dependencies Installed: This package requries these versions langchain, @langchain/classic and @langchain/core to be installed.

npm install @langchain/core@latest @langchain/classic@latest langchain@latest

• SAP HANA Cloud: Access to a running SAP HANA Cloud instance.

Installation

Install the LangChain SAP HANA Cloud integration package using npm:

npm install @sap/hana-langchain

Vectorstore

SAP HANA Cloud Vector Engine is a vector store fully integrated into the SAP HANA Cloud database.

See a usage example.

import { HanaDB } from "@sap/hana-langchain";

Self Query Retriever

SAP HANA Cloud Vector Engine also provides a Self Query Retriever implementation using the HanaTranslator Class.

See a usage example.

import { HanaTranslator } from "@sap/hana-langchain";

Graph

SAP HANA Cloud Knowledge Graph Engine provides support to utilise knowledge graphs through the HanaRdfGraph Class.

See a usage example.

import { HanaRdfGraph } from "@sap/hana-langchain";

Chains

A SparqlQAChain is also provided which can be used with HanaRdfGraph for SPARQL-QA tasks.

See a usage example.

import { HanaSparqlQAChain } from "@sap/hana-langchain";

Agents

A HanaSparqlQAAgent can generate and execute SPARQL queries iteratively over HanaRdfGraph, including ontology retrieval and self-correction.

See a usage example.

import { HanaSparqlQAAgent } from "@sap/hana-langchain";

Documentation

Please refer to the examples in examples/ to know more about the different components available in the package.

Support, Feedback, Contributing

This project is open to feature requests/suggestions, bug reports etc. via GitHub issues. Contribution and feedback are encouraged and always welcome. For more information about how to contribute, the project structure, as well as additional contribution information, see our Contribution Guidelines.

Security / Disclosure

If you find any bug that may be a security problem, please follow our instructions at in our security policy on how to report it. Please do not create GitHub issues for security-related doubts or problems.

Code of Conduct

We as members, contributors, and leaders pledge to make participation in our community a harassment-free experience for everyone. By participating in this project, you agree to abide by its Code of Conduct at all times.

Licensing

Copyright 2025 SAP SE or an SAP affiliate company and langchainjs-integration-for-sap-hana-cloud contributors. Please see our LICENSE for copyright and license information. Detailed information including third-party components and their licensing/copyright information is available via the REUSE tool.