langchain-akasicdb 1.0.0

langchain-akasicdb package is an implementation of core LangChain abstraction for AkasicDB

langchain-akasicdb

langchain-akasicdb 는 LangChain 프레임워크에서 AkasicDB를 사용할 수 있게 해 주는 integration입니다.

Requirements

Environment Prerequisites (For Local Testing/Examples):

• PostgreSQL: A running PostgreSQL with the akasicdb extension enabled.
• OpenAI API Key: Required for running RAG examples.

Installation

pip install --extra-index-url https://test.pypi.org/simple/ "langchain-akasicdb"==0.6.0

Quick Start

from langchain_akasicdb import AkasicDBVector

vectorstore = AkasicDBVector(
    embedding=my_embedding,
    dimension=1536,
    db_url="postgresql+psycopg://user:pass@localhost:5432/mydb",
    collection_name="my_collection",
    new_table=True,
)

Backward Compatibility

The previous langchain_vectoron package is still available as a deprecation shim. Existing code using VectorOnVectorStore will continue to work but will emit a DeprecationWarning:

# Still works, but deprecated:
from langchain_vectoron import VectorOnVectorStore

# Migrate to:
from langchain_akasicdb import AkasicDBVector

Examples

Please see the Jupyter Notebook example.

[!NOTE] You need your own OpenAI API key to run the example.

Run tests

Prerequisite: Set up PostgreSQL Environment:

1. Ensure Extension is Active: Connect to your running PostgreSQL instance and execute the extension creation command.

   psql -h localhost -p 5432 -U postgres -d akasicdb
   
   -- Execute inside psql:
   CREATE EXTENSION IF NOT EXISTS akasicdb;
   \q
   

2. Set DB Environment Variables: Export connection parameters so tests and examples can connect to the database.

   export POSTGRES_HOST=localhost
   export POSTGRES_USER=postgres
   export POSTGRES_PASSWORD=akasicdb
   export POSTGRES_PORT=5432
   

Install dependencies for tests:

poetry install --with test

Run unit tests:

# run unit tests without network access
poetry run pytest --disable-socket --allow-unix-socket --asyncio-mode=auto tests/unit_tests

Run tests with coverage report:

poetry run pytest --cov=langchain_akasicdb --cov-report=term-missing

To generate an HTML report:

poetry run pytest --cov=langchain_akasicdb --cov-report=html