Skip to main content


You can use a local NucliaDB instance or use Nuclia Cloud.

When using a local instance, you need a Nuclia Understanding API key, so your texts are properly vectorized and indexed. You can get a key by creating a free account at, and then create a NUA key.

%pip install --upgrade --quiet  langchain nuclia

Usage with

from langchain_community.vectorstores.nucliadb import NucliaDB


ndb = NucliaDB(knowledge_box="YOUR_KB_ID", local=False, api_key=API_KEY)

API Reference:

Usage with a local instance

Note: By default backend is set to http://localhost:8080.

from langchain_community.vectorstores.nucliadb import NucliaDB

ndb = NucliaDB(knowledge_box="YOUR_KB_ID", local=True, backend="http://my-local-server")

API Reference:

Add and delete texts to your Knowledge Box

ids = ndb.add_texts(["This is a new test", "This is a second test"])

Search in your Knowledge Box

results = ndb.similarity_search("Who was inspired by Ada Lovelace?")

Help us out by providing feedback on this documentation page: