langchain-postgres 0.0.1__py3-none-any.whl

langchain_postgres-0.0.1.dist-info/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 LangChain, Inc.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

langchain_postgres-0.0.1.dist-info/METADATA

@@ -0,0 +1,187 @@
+Metadata-Version: 2.1
+Name: langchain-postgres
+Version: 0.0.1
+Summary: An integration package connecting Postgres and LangChain
+Home-page: https://github.com/langchain-ai/langchain-postgres
+License: MIT
+Requires-Python: >=3.9,<4.0
+Classifier: License :: OSI Approved :: MIT License
+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
+Requires-Dist: langchain-core (>=0.1,<0.2)
+Requires-Dist: langgraph (>=0.0.32,<0.0.33)
+Requires-Dist: numpy (>=1.26.4,<2.0.0)
+Requires-Dist: pgvector (>=0.2.5,<0.3.0)
+Requires-Dist: psycopg (>=3.1.18,<4.0.0)
+Requires-Dist: psycopg-pool (>=3.2.1,<4.0.0)
+Requires-Dist: sqlalchemy (>=2.0.29,<3.0.0)
+Project-URL: Repository, https://github.com/langchain-ai/langchain-postgres
+Description-Content-Type: text/markdown
+
+# langchain-postgres
+
+The `langchain-postgres` package implementations of core LangChain abstractions using `Postgres`.
+
+The package is released under the MIT license. 
+
+Feel free to use the abstraction as provided or else modify them / extend them as appropriate for your own application.
+
+## Requirements
+
+The package currently only supports the [psycogp3](https://www.psycopg.org/psycopg3/) driver.
+
+## Installation
+
+```bash
+pip install -U langchain-postgres
+```
+
+## Usage
+
+### PostgresSaver (LangGraph Checkpointer) 
+
+The LangGraph checkpointer can be used to add memory to your LangGraph application.
+
+`PostgresSaver` is an implementation of the checkpointer saver using
+Postgres as the backend.
+
+Currently, only the psycopg3 driver is supported.
+
+Sync usage:
+
+```python 
+from psycopg_pool import ConnectionPool
+from langchain_postgres import (
+    PostgresSaver, PickleCheckpointSerializer
+)
+
+pool = ConnectionPool(
+    # Example configuration
+    conninfo="postgresql://langchain:langchain@localhost:6024/langchain",
+    max_size=20,
+)
+
+PostgresSaver.create_tables(pool)
+
+checkpointer = PostgresSaver(
+    serializer=PickleCheckpointSerializer(),
+    sync_connection=pool,
+)
+
+# Set up the langgraph workflow with the checkpointer
+workflow = ... # Fill in with your workflow
+app = workflow.compile(checkpointer=checkpointer)
+
+# Use with the sync methods of `app` (e.g., `app.stream())
+
+pool.close() # Remember to close the connection pool.
+```
+
+Async usage:
+
+```python
+from psycopg_pool import AsyncConnectionPool
+from langchain_postgres import (
+    PostgresSaver, PickleCheckpointSerializer
+)
+
+pool = AsyncConnectionPool(
+    # Example configuration
+    conninfo="postgresql://langchain:langchain@localhost:6024/langchain",
+    max_size=20,
+)
+
+# Create the tables in postgres (only needs to be done once)
+await PostgresSaver.acreate_tables(pool)
+
+checkpointer = PostgresSaver(
+    serializer=PickleCheckpointSerializer(),
+    async_connection=pool,
+)
+
+# Set up the langgraph workflow with the checkpointer
+workflow = ... # Fill in with your workflow
+app = workflow.compile(checkpointer=checkpointer)
+
+# Use with the async methods of `app` (e.g., `app.astream()`)
+
+await pool.close() # Remember to close the connection pool.
+```
+
+#### Testing
+
+If testing with the postgres checkpointer it may be useful to both create and
+drop the tables before and after the tests.
+
+```python
+from psycopg_pool import ConnectionPool
+from langchain_postgres import (
+    PostgresSaver 
+)
+with ConnectionPool(
+    # Example configuration
+    conninfo="postgresql://langchain:langchain@localhost:6024/langchain",
+    max_size=20,
+) as conn:
+    PostgresSaver.create_tables(conn)
+    PostgresSaver.drop_tables(conn)
+    # Run your unit tests with langgraph
+```
+
+
+### ChatMessageHistory
+
+The chat message history abstraction helps to persist chat message history 
+in a postgres table.
+
+PostgresChatMessageHistory is parameterized using a `table_name` and a `session_id`.
+
+The `table_name` is the name of the table in the database where 
+the chat messages will be stored.
+
+The `session_id` is a unique identifier for the chat session. It can be assigned
+by the caller using `uuid.uuid4()`.
+
+```python
+import uuid
+
+from langchain_core.messages import SystemMessage, AIMessage, HumanMessage
+from langchain_postgres import PostgresChatMessageHistory
+import psycopg
+
+# Establish a synchronous connection to the database
+# (or use psycopg.AsyncConnection for async)
+conn_info = ... # Fill in with your connection info
+sync_connection = psycopg.connect(conn_info)
+
+# Create the table schema (only needs to be done once)
+table_name = "chat_history"
+PostgresChatMessageHistory.create_tables(sync_connection, table_name)
+
+session_id = str(uuid.uuid4())
+
+# Initialize the chat history manager
+chat_history = PostgresChatMessageHistory(
+    table_name,
+    session_id,
+    sync_connection=sync_connection
+)
+
+# Add messages to the chat history
+chat_history.add_messages([
+    SystemMessage(content="Meow"),
+    AIMessage(content="woof"),
+    HumanMessage(content="bark"),
+])
+
+print(chat_history.messages)
+```
+
+
+### Vectorstore
+
+See example for the [PGVector vectorstore here](https://github.com/langchain-ai/langchain-postgres/blob/main/examples/vectorstore.ipynb)
+

langchain_postgres-0.0.1.dist-info/RECORD

@@ -0,0 +1,10 @@
+langchain_postgres/__init__.py,sha256=IMtNMHfY5cWhBuJ8M8diGlOD51L_4Dd741nYa_FeLsY,621
+langchain_postgres/_utils.py,sha256=Johm50HEgA4qScLDaSDIfJfF3DygjA5KTBtNeVcD63I,2914
+langchain_postgres/chat_message_histories.py,sha256=gh6hjBlrJ5GSo5kePQdh3VhiUYoWWdP37GXtZ1e25a4,14033
+langchain_postgres/checkpoint.py,sha256=B0c03jyQcS0bAaNPljWEG3IuhlelIF2z3vSXWATi9-4,23519
+langchain_postgres/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+langchain_postgres/vectorstores.py,sha256=u0mMWep6HSp5r0uNkoSE1VS22c0x8AfvKBj5UVjByJQ,49908
+langchain_postgres-0.0.1.dist-info/LICENSE,sha256=2btS8uNUDWD_UNjw9ba6ZJt_00aUjEw9CGyK-xIHY8c,1072
+langchain_postgres-0.0.1.dist-info/METADATA,sha256=9jY1xiz_lVgDnpTRNLOa7Dp-xUHh8iiw1xtqosNzbUc,5186
+langchain_postgres-0.0.1.dist-info/WHEEL,sha256=FMvqSimYX_P7y0a7UY-_Mc83r5zkBZsCYPm7Lr0Bsq4,88
+langchain_postgres-0.0.1.dist-info/RECORD,,

langchain_postgres-0.0.1.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: poetry-core 1.8.1
+Root-Is-Purelib: true
+Tag: py3-none-any