Metadata-Version: 2.3
Name: langchain-dolphindb
Version: 0.0.1
Summary: Langchain integration for DolphinDB Vector Store
Author: DolphinDB, Inc.
Author-email: it@dolphindb.com
Requires-Python: >=3.9
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Requires-Dist: dolphindb (>=3.0)
Requires-Dist: langchain-core (>=0.3,<0.4.0)
Requires-Dist: numpy (>=1.19.5,<2.0.0)
Requires-Dist: pandas (>=1.0.0)
Requires-Dist: pydantic-settings (>=2.4.0,<3.0.0)
Description-Content-Type: text/markdown

# langchain-dolphindb

`langchain-dolphindb` integrates DolphinDB's high-performance database capabilities 
into LangChain's vector store ecosystem, enabling efficient storage, retrieval, 
and semantic search of vector data.

## Installation

**Required version**: DolphinDB 3.00.0 or higher & dolphindb 3.0.0 or higher

Install the langchain-dolphindb with the following pip command:

```bash
pip install -U langchain-dolphindb
```

## Manage Vectorstore

### Connect to vector store

Configure DolphinDBConfig to connect to DolphinDB and create the vector store 
if it doesn’t exist.

The following example uses `DeterministicFakeEmbedding` as the embeddings.

```python
from langchain_community.embeddings import DeterministicFakeEmbedding
from langchain_dolphindb import DolphinDBConfig, DolphinDBVectorStore

embeddings = DeterministicFakeEmbedding(size=4096)

config = DolphinDBConfig(
    host="localhost", port=8848, username="admin", password="123456"
)

vector_store = DolphinDBVectorStore(embedding=embeddings, config=config)
```

### Delete vector store

You can use `DolphinDBVectorStore.conn` to control the connection to the vector store 
and delete it with `DolphinDBVectorStore.conn.drop_database` method.

```python
vector_store.conn.drop_database()
```

### Add items to vector store

You can add items to a vector store by using the `DolphinDBVectorStore.add_documents` method.

```python
from langchain_core.documents import Document

docs = [
    Document(
        page_content="there are cats in the pond",
        metadata={"id": 1, "location": "pond", "topic": "animals"},
    ),
    Document(
        page_content="ducks are also found in the pond",
        metadata={"id": 2, "location": "pond", "topic": "animals"},
    ),
    Document(
        page_content="fresh apples are available at the market",
        metadata={"id": 3, "location": "market", "topic": "food"},
    ),
    Document(
        page_content="the market also sells fresh oranges",
        metadata={"id": 4, "location": "market", "topic": "food"},
    ),
    Document(
        page_content="the new art exhibit is fascinating",
        metadata={"id": 5, "location": "museum", "topic": "art"},
    ),
    Document(
        page_content="a sculpture exhibit is also at the museum",
        metadata={"id": 6, "location": "museum", "topic": "art"},
    ),
    Document(
        page_content="a new coffee shop opened on Main Street",
        metadata={"id": 7, "location": "Main Street", "topic": "food"},
    ),
    Document(
        page_content="the book club meets at the library",
        metadata={"id": 8, "location": "library", "topic": "reading"},
    ),
    Document(
        page_content="the library hosts a weekly story time for kids",
        metadata={"id": 9, "location": "library", "topic": "reading"},
    ),
    Document(
        page_content="a cooking class for beginners is offered at the community center",
        metadata={"id": 10, "location": "community center", "topic": "classes"},
    ),
]

vector_store.add_documents(docs, ids=[doc.metadata["id"] for doc in docs])
```

### Delete items from vector store

You can delete items from a vector store by using the `DolphinDBVectorStore.delete` method.

```python
vector_store.delete(ids=["3"])
```

## Query vector store

Once your vector store has been created and the relevant documents
have been added you will most likely wish to query it during the running
of your chain or agent.

### Query directly

You can use [jsonExtract](https://docs.dolphindb.cn/en/Functions/j/JsonExtract.html) function 
to extract metadata columns.

```python
results = vector_store.similarity_search(
    "kitty", k=10, where_str="""jsonExtract(metadata, "id", "int") in [1,5,2,9]"""
)
for doc in results:
    print(f"* {doc.page_content} [{doc.metadata}]")
```

### Query by turning into retriever

You can also transform the vector store into a retriever.

```python
retriever = vector_store.as_retriever(search_type="similarity", search_kwargs={"k": 1})
results = retriever.invoke("kitty")
for doc in results:
    print(f"* {doc.page_content} [{doc.metadata}]")
```
