The agent engineering platform.
Python agentsaiai-agentsanthropicchatgptdeepagentsenterpriseframeworkgeminigenerative-ailangchainlanggraphllmmultiagentopen-sourceopenaipydanticpythonragtypescript
docs(docs): Add RecallIO.AI as a memory provider (#32331)
RecallIO4f71c35eb0be
diff --git a/docs/docs/integrations/memory/recallio_memory.ipynb b/docs/docs/integrations/memory/recallio_memory.ipynbnew file mode 100644index 0000000000..3ecb7718eb--- /dev/null+++ b/docs/docs/integrations/memory/recallio_memory.ipynb@@ -0,0 +1,215 @@+{+ "cells": [+ {+ "cell_type": "markdown",+ "metadata": {},+ "source": [+ "# RecallioMemory + LangChain Integration Demo\n",+ "A minimal notebook to show drop-in usage of RecallioMemory in LangChain (with scoped writes and recall)."+ ]+ },+ {+ "cell_type": "code",+ "execution_count": null,+ "metadata": {},+ "outputs": [],+ "source": [+ "%pip install recallio langchain langchain-recallio openai"+ ]+ },+ {+ "cell_type": "markdown",+ "metadata": {},+ "source": [+ "## Setup: API Keys & Imports"+ ]+ },+ {+ "cell_type": "code",+ "execution_count": null,+ "metadata": {},+ "outputs": [],+ "source": [+ "from langchain_recallio.memory import RecallioMemory\n",+ "from langchain_openai import ChatOpenAI\n",+ "from langchain.prompts import ChatPromptTemplate\n",+ "import os\n",+ "\n",+ "# Set your keys here or use environment variables\n",+ "RECALLIO_API_KEY = os.getenv(\"RECALLIO_API_KEY\", \"YOUR_RECALLIO_API_KEY\")\n",+ "OPENAI_API_KEY = os.getenv(\"OPENAI_API_KEY\", \"YOUR_OPENAI_API_KEY\")"+ ]+ },+ {+ "cell_type": "markdown",+ "metadata": {},+ "source": [+ "## Initialize RecallioMemory"+ ]+ },+ {+ "cell_type": "code",+ "execution_count": null,+ "metadata": {},+ "outputs": [],+ "source": [+ "memory = RecallioMemory(\n",+ " project_id=\"project_abc\",\n",+ " api_key=RECALLIO_API_KEY,\n",+ " session_id=\"demo-session-001\",\n",+ " user_id=\"demo-user-42\",\n",+ " default_tags=[\"test\", \"langchain\"],\n",+ " return_messages=True,\n",+ ")"+ ]+ },+ {+ "cell_type": "markdown",+ "metadata": {},+ "source": [+ "## Build a LangChain ConversationChain with RecallioMemory"+ ]+ },+ {+ "cell_type": "code",+ "execution_count": null,+ "metadata": {},+ "outputs": [],+ "source": [+ "# You can swap in any supported LLM here\n",+ "llm = ChatOpenAI(api_key=OPENAI_API_KEY, temperature=0)\n",+ "prompt = ChatPromptTemplate.from_messages(\n",+ " [\n",+ " (\n",+ " \"system\",\n",+ " \"The following is a friendly conversation between a human and an AI. \"\n",+ " \"The AI is talkative and provides lots of specific details from its context. \"\n",+ " \"If the AI does not know the answer to a question, it truthfully says it does not know.\",\n",+ " ),\n",+ " (\"placeholder\", \"{history}\"), # RecallioMemory will fill this slot\n",+ " (\"human\", \"{input}\"),\n",+ " ]\n",+ ")\n",+ "\n",+ "# LCEL chain that returns an AIMessage\n",+ "base_chain = prompt | llm\n",+ "\n",+ "\n",+ "# Create a stateful chain using RecallioMemory\n",+ "def chat_with_memory(user_input: str):\n",+ " # Load conversation history from memory\n",+ " memory_vars = memory.load_memory_variables({\"input\": user_input})\n",+ "\n",+ " # Run the chain with history and user input\n",+ " response = base_chain.invoke(\n",+ " {\"input\": user_input, \"history\": memory_vars.get(\"history\", \"\")}\n",+ " )\n",+ "\n",+ " # Save the conversation to memory\n",+ " memory.save_context({\"input\": user_input}, {\"output\": response.content})\n",+ "\n",+ " return response"+ ]+ },+ {+ "cell_type": "markdown",+ "metadata": {},+ "source": [+ "## Example: Chat with Memory"+ ]+ },+ {+ "cell_type": "code",+ "execution_count": null,+ "metadata": {},+ "outputs": [+ {+ "name": "stdout",+ "output_type": "stream",+ "text": [+ "Bot: Hello Guillaume! It's nice to meet you. How can I assist you today?\n"+ ]+ }+ ],+ "source": [+ "# First user message – note the AI remembers the name\n",+ "resp1 = chat_with_memory(\"Hi! My name is Guillaume. Remember that.\")\n",+ "print(\"Bot:\", resp1.content)"+ ]+ },+ {+ "cell_type": "code",+ "execution_count": null,+ "metadata": {},+ "outputs": [+ {+ "name": "stdout",+ "output_type": "stream",+ "text": [+ "Bot: Your name is Guillaume.\n"+ ]+ }+ ],+ "source": [+ "# Second user message – AI should recall the name from memory\n",+ "resp2 = chat_with_memory(\"What is my name?\")\n",+ "print(\"Bot:\", resp2.content)"+ ]+ },+ {+ "cell_type": "markdown",+ "metadata": {},+ "source": [+ "## See What Is Stored in Recallio\n",+ "This is for debugging/demo only; in production, you wouldn't do this on every run."+ ]+ },+ {+ "cell_type": "code",+ "execution_count": null,+ "metadata": {},+ "outputs": [+ {+ "name": "stdout",+ "output_type": "stream",+ "text": [+ "Current memory variables: {'history': [HumanMessage(content='Name is Guillaume', additional_kwargs={}, response_metadata={})]}\n"+ ]+ }+ ],+ "source": [+ "print(\"Current memory variables:\", memory.load_memory_variables({}))"+ ]+ },+ {+ "cell_type": "markdown",+ "metadata": {},+ "source": [+ "## Clear Memory (Optional Cleanup - Requires Manager level Key)"+ ]+ },+ {+ "cell_type": "code",+ "execution_count": null,+ "metadata": {},+ "outputs": [],+ "source": [+ "# memory.clear()\n",+ "# print(\"Memory cleared.\")"+ ]+ }+ ],+ "metadata": {+ "kernelspec": {+ "display_name": "Python 3",+ "language": "python",+ "name": "python3"+ },+ "language_info": {+ "name": "python",+ "version": "3.10"+ }+ },+ "nbformat": 4,+ "nbformat_minor": 2+}diff --git a/docs/docs/integrations/providers/recallio.ipynb b/docs/docs/integrations/providers/recallio.ipynbnew file mode 100644index 0000000000..375663b181--- /dev/null+++ b/docs/docs/integrations/providers/recallio.ipynb@@ -0,0 +1,31 @@+{+ "cells": [+ {+ "cell_type": "markdown",+ "metadata": {},+ "source": [+ "# Recallio\n",+ "\n",+ "[Recallio](https://recallio.ai/) is a powerfull API allowing to store, index, and retrieve application “memories” with built-in fact extraction, dynamic summaries, reranked recall, and a full knowledge-graph layer.\n",+ "\n",+ "\n",+ "## Installation\n",+ "\n",+ "```bash\n",+ "pip install langchain-recallio\n",+ "```\n",+ "\n",+ "```python\n",+ "from langchain_recallio.memory import RecallioMemory\n",+ "```"+ ]+ }+ ],+ "metadata": {+ "language_info": {+ "name": "python"+ }+ },+ "nbformat": 4,+ "nbformat_minor": 2+}diff --git a/libs/packages.yml b/libs/packages.ymlindex 312d9efae6..49eff9d7b5 100644--- a/libs/packages.yml+++ b/libs/packages.yml@@ -700,6 +700,9 @@ packages:- name: langchain-tensorlakepath: .repo: tensorlakeai/langchain-tensorlake+- name: langchain-recallio+ path: .+ repo: recallio/langchain-recalliodownloads: 781downloads_updated_at: '2025-08-10T21:38:36.795416+00:00'- name: langchain-gradientdiff --git a/uv.lock b/uv.lockindex 28ffabb41d..273d066802 100644--- a/uv.lock+++ b/uv.lock@@ -2814,7 +2814,7 @@ typing = [][[package]]name = "langchain-openai"-version = "0.3.29"+version = "0.3.30"source = { editable = "libs/partners/openai" }dependencies = [{ name = "langchain-core" },@@ -2825,14 +2825,14 @@ dependencies = [[package.metadata]requires-dist = [{ name = "langchain-core", editable = "libs/core" },- { name = "openai", specifier = ">=1.86.0,<2.0.0" },+ { name = "openai", specifier = ">=1.99.9,<2.0.0" },{ name = "tiktoken", specifier = ">=0.7,<1" },][package.metadata.requires-dev]codespell = [{ name = "codespell", specifier = ">=2.2.0,<3.0.0" }]dev = [{ name = "langchain-core", editable = "libs/core" }]-lint = [{ name = "ruff", specifier = ">=0.12.2,<0.13" }]+lint = [{ name = "ruff", specifier = ">=0.12.8,<0.13" }]test = [{ name = "freezegun", specifier = ">=1.2.2,<2.0.0" },{ name = "langchain-core", editable = "libs/core" },@@ -2858,7 +2858,7 @@ test-integration = []typing = [{ name = "langchain-core", editable = "libs/core" },- { name = "mypy", specifier = ">=1.10,<2.0" },+ { name = "mypy", specifier = ">=1.17.1,<2.0" },{ name = "types-tqdm", specifier = ">=4.66.0.5,<5.0.0.0" },]@@ -2922,7 +2922,7 @@ test-integration = []typing = [{ name = "lxml-stubs", specifier = ">=0.5.1,<1.0.0" },- { name = "mypy", specifier = ">=1.15,<2.0" },+ { name = "mypy", specifier = ">=1.17.1,<1.18" },{ name = "tiktoken", specifier = ">=0.8.0,<1.0.0" },{ name = "types-requests", specifier = ">=2.31.0.20240218,<3.0.0.0" },]@@ -3971,7 +3971,7 @@ wheels = [[[package]]name = "openai"-version = "1.88.0"+version = "1.99.9"source = { registry = "https://pypi.org/simple" }dependencies = [{ name = "anyio" },@@ -3983,9 +3983,9 @@ dependencies = [{ name = "tqdm" },{ name = "typing-extensions" },]-sdist = { url = "https://files.pythonhosted.org/packages/5a/ea/bbeef604d1fe0f7e9111745bb8a81362973a95713b28855beb9a9832ab12/openai-1.88.0.tar.gz", hash = "sha256:122d35e42998255cf1fc84560f6ee49a844e65c054cd05d3e42fda506b832bb1", size = 470963, upload-time = "2025-06-17T05:04:45.856Z" }+sdist = { url = "https://files.pythonhosted.org/packages/8a/d2/ef89c6f3f36b13b06e271d3cc984ddd2f62508a0972c1cbcc8485a6644ff/openai-1.99.9.tar.gz", hash = "sha256:f2082d155b1ad22e83247c3de3958eb4255b20ccf4a1de2e6681b6957b554e92", size = 506992, upload-time = "2025-08-12T02:31:10.054Z" }wheels = [- { url = "https://files.pythonhosted.org/packages/f4/03/ef68d77a38dd383cbed7fc898857d394d5a8b0520a35f054e7fe05dc3ac1/openai-1.88.0-py3-none-any.whl", hash = "sha256:7edd7826b3b83f5846562a6f310f040c79576278bf8e3687b30ba05bb5dff978", size = 734293, upload-time = "2025-06-17T05:04:43.858Z" },+ { url = "https://files.pythonhosted.org/packages/e8/fb/df274ca10698ee77b07bff952f302ea627cc12dac6b85289485dd77db6de/openai-1.99.9-py3-none-any.whl", hash = "sha256:9dbcdb425553bae1ac5d947147bebbd630d91bbfc7788394d4c4f3a35682ab3a", size = 786816, upload-time = "2025-08-12T02:31:08.34Z" },][[package]]