langchain-goodmem 0.1.0__tar.gz

langchain_goodmem-0.1.0/.github/workflows/release.yml

@@ -0,0 +1,50 @@
+name: Release to PyPI
+
+on:
+  push:
+    tags:
+      - "v*"
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+jobs:
+  build:
+    name: Build distribution
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v3
+        with:
+          python-version: "3.10"
+
+      - name: Build sdist + wheel
+        run: uv build
+
+      - name: Upload artifacts
+        uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+  publish:
+    name: Publish to PyPI
+    needs: build
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/p/langchain-goodmem
+    permissions:
+      id-token: write
+    steps:
+      - name: Download artifacts
+        uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+      - name: Publish to PyPI via Trusted Publishing
+        uses: pypa/gh-action-pypi-publish@release/v1

langchain_goodmem-0.1.0/.gitignore

@@ -0,0 +1,36 @@
+# Build artifacts
+dist/
+build/
+*.egg-info/
+*.egg
+
+# Python bytecode
+__pycache__/
+*.py[cod]
+*$py.class
+
+# Virtual environments
+.venv/
+venv/
+env/
+
+# Tooling caches
+.mypy_cache/
+.pytest_cache/
+.ruff_cache/
+.tox/
+.coverage
+.coverage.*
+htmlcov/
+coverage.xml
+
+# Editor / OS
+.idea/
+.vscode/
+.DS_Store
+*.swp
+*~
+
+# Environment files
+.env
+.env.local

langchain_goodmem-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 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_goodmem-0.1.0/Makefile

@@ -0,0 +1,59 @@
+.PHONY: all format lint type test tests integration_tests help
+
+# Default target executed when no arguments are given to make.
+all: help
+
+.EXPORT_ALL_VARIABLES:
+UV_FROZEN = true
+
+# Define a variable for the test file path.
+TEST_FILE ?= tests/unit_tests/
+
+integration_test integration_tests: TEST_FILE=tests/integration_tests/
+
+test tests:
+	uv run --group test pytest --disable-socket --allow-unix-socket $(TEST_FILE)
+
+integration_test integration_tests:
+	uv run --group test pytest $(TEST_FILE)
+
+test_watch:
+	uv run --group test ptw --snapshot-update --now . -- -vv $(TEST_FILE)
+
+######################
+# LINTING AND FORMATTING
+######################
+
+# Define a variable for Python and notebook files.
+PYTHON_FILES=.
+MYPY_CACHE=.mypy_cache
+lint format: PYTHON_FILES=.
+lint_diff format_diff: PYTHON_FILES=$(shell git diff --name-only --diff-filter=d main | grep -E '\.py$$|\.ipynb$$')
+lint_package: PYTHON_FILES=langchain_goodmem
+lint_tests: PYTHON_FILES=tests
+lint_tests: MYPY_CACHE=.mypy_cache_test
+
+lint lint_diff lint_package lint_tests:
+	[ "$(PYTHON_FILES)" = "" ] || uv run --all-groups ruff check $(PYTHON_FILES)
+	[ "$(PYTHON_FILES)" = "" ] || uv run --all-groups ruff format $(PYTHON_FILES) --diff
+	[ "$(PYTHON_FILES)" = "" ] || mkdir -p $(MYPY_CACHE) && uv run --all-groups mypy $(PYTHON_FILES) --cache-dir $(MYPY_CACHE)
+
+type:
+	mkdir -p $(MYPY_CACHE) && uv run --all-groups mypy $(PYTHON_FILES) --cache-dir $(MYPY_CACHE)
+
+format format_diff:
+	[ "$(PYTHON_FILES)" = "" ] || uv run --all-groups ruff format $(PYTHON_FILES)
+	[ "$(PYTHON_FILES)" = "" ] || uv run --all-groups ruff check --fix $(PYTHON_FILES)
+
+######################
+# HELP
+######################
+
+help:
+	@echo '----'
+	@echo 'format                       - run code formatters'
+	@echo 'lint                         - run linters'
+	@echo 'type                         - run type checking'
+	@echo 'test                         - run unit tests'
+	@echo 'tests                        - run unit tests'
+	@echo 'test TEST_FILE=<test_file>   - run all tests in file'

langchain_goodmem-0.1.0/PKG-INFO

@@ -0,0 +1,134 @@
+Metadata-Version: 2.4
+Name: langchain-goodmem
+Version: 0.1.0
+Summary: LangChain integration for GoodMem: long-term agent memory with semantic storage and retrieval.
+Project-URL: Homepage, https://github.com/PAIR-Systems-Inc/goodmem-langchain
+Project-URL: Repository, https://github.com/PAIR-Systems-Inc/goodmem-langchain
+Project-URL: Documentation, https://goodmem.ai/docs
+Project-URL: Issues, https://github.com/PAIR-Systems-Inc/goodmem-langchain/issues
+License-Expression: MIT
+License-File: LICENSE
+Keywords: agents,goodmem,langchain,llm,memory,semantic-search,vector-search
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Typing :: Typed
+Requires-Python: <4.0.0,>=3.10.0
+Requires-Dist: httpx<1.0.0,>=0.27.0
+Requires-Dist: langchain-core<2.0.0,>=1.0.0
+Requires-Dist: pydantic<3.0.0,>=2.7.4
+Description-Content-Type: text/markdown
+
+# langchain-goodmem
+
+[![PyPI](https://img.shields.io/pypi/v/langchain-goodmem.svg)](https://pypi.org/project/langchain-goodmem/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
+
+LangChain integration for [GoodMem](https://goodmem.ai) — long-term agent memory with semantic storage and retrieval.
+
+GoodMem is a memory layer for AI agents that handles embedding, vector search, reranking, and LLM-powered answering server-side. This package exposes GoodMem operations as LangChain `BaseTool`s that can be wired into any LangChain agent or chain.
+
+## Installation
+
+```bash
+pip install langchain-goodmem
+```
+
+Requires Python 3.10+.
+
+## Tools
+
+| Tool | Description |
+|---|---|
+| `GoodMemListEmbedders` | List available embedder models |
+| `GoodMemListSpaces` | List all spaces in your account |
+| `GoodMemGetSpace` | Fetch a single space by ID |
+| `GoodMemCreateSpace` | Create a new space or reuse an existing one |
+| `GoodMemUpdateSpace` | Update name / public-read / labels on a space |
+| `GoodMemDeleteSpace` | Delete a space (cascades to its memories) |
+| `GoodMemCreateMemory` | Store text or files as memories |
+| `GoodMemListMemories` | Paginate memories within a space |
+| `GoodMemRetrieveMemories` | Semantic search with optional reranker / LLM summary |
+| `GoodMemGetMemory` | Fetch a specific memory by ID |
+| `GoodMemDeleteMemory` | Permanently delete a memory |
+
+## Quick start
+
+```python
+from langchain_goodmem import (
+    GoodMemCreateSpace,
+    GoodMemCreateMemory,
+    GoodMemRetrieveMemories,
+)
+
+goodmem_kwargs = {
+    "goodmem_base_url": "http://localhost:8080",
+    "goodmem_api_key": "your-api-key",
+}
+
+tools = [
+    GoodMemCreateSpace(**goodmem_kwargs),
+    GoodMemCreateMemory(**goodmem_kwargs),
+    GoodMemRetrieveMemories(**goodmem_kwargs),
+]
+```
+
+## Use with a LangChain agent
+
+```python
+from langchain.chat_models import init_chat_model
+from langchain.agents import create_agent
+
+llm = init_chat_model("openai:gpt-4o")
+agent = create_agent(llm, tools)
+
+response = agent.invoke({"messages": [{"role": "user", "content": "Save this fact and recall it later."}]})
+```
+
+## Retrieve with reranking and LLM summary
+
+`GoodMemRetrieveMemories` exposes the full server-side post-processor. Set any of these fields to enable reranking, threshold filtering, chronological re-sort, or an LLM-generated `abstractReply` summary:
+
+```python
+result = retrieve.invoke({
+    "query": "Which framework develops applications with language models?",
+    "space_ids": "space-uuid-1,space-uuid-2",
+    "max_results": 5,
+    "reranker_id": "reranker-uuid",
+    "llm_id": "llm-uuid",
+    "llm_temperature": 0.2,
+    "relevance_threshold": 0.1,
+    "chronological_resort": False,
+})
+```
+
+Leave them all unset for plain semantic search.
+
+## Environment variables
+
+| Variable | Description |
+|---|---|
+| `GOODMEM_BASE_URL` | Base URL of the GoodMem API server |
+| `GOODMEM_API_KEY` | API key for authentication |
+| `GOODMEM_VERIFY_SSL` | Set to `false` to skip TLS verification for self-signed dev certs (default: `true`) |
+
+## Examples
+
+A live end-to-end smoke test exercising every tool and every post-processor knob is in [examples/live_smoke_test.py](examples/live_smoke_test.py).
+
+```bash
+export GOODMEM_BASE_URL=https://localhost:8080
+export GOODMEM_API_KEY=...
+export GOODMEM_VERIFY_SSL=false
+python examples/live_smoke_test.py
+```
+
+## License
+
+MIT — see [LICENSE](LICENSE).

langchain_goodmem-0.1.0/README.md

@@ -0,0 +1,107 @@
+# langchain-goodmem
+
+[![PyPI](https://img.shields.io/pypi/v/langchain-goodmem.svg)](https://pypi.org/project/langchain-goodmem/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
+
+LangChain integration for [GoodMem](https://goodmem.ai) — long-term agent memory with semantic storage and retrieval.
+
+GoodMem is a memory layer for AI agents that handles embedding, vector search, reranking, and LLM-powered answering server-side. This package exposes GoodMem operations as LangChain `BaseTool`s that can be wired into any LangChain agent or chain.
+
+## Installation
+
+```bash
+pip install langchain-goodmem
+```
+
+Requires Python 3.10+.
+
+## Tools
+
+| Tool | Description |
+|---|---|
+| `GoodMemListEmbedders` | List available embedder models |
+| `GoodMemListSpaces` | List all spaces in your account |
+| `GoodMemGetSpace` | Fetch a single space by ID |
+| `GoodMemCreateSpace` | Create a new space or reuse an existing one |
+| `GoodMemUpdateSpace` | Update name / public-read / labels on a space |
+| `GoodMemDeleteSpace` | Delete a space (cascades to its memories) |
+| `GoodMemCreateMemory` | Store text or files as memories |
+| `GoodMemListMemories` | Paginate memories within a space |
+| `GoodMemRetrieveMemories` | Semantic search with optional reranker / LLM summary |
+| `GoodMemGetMemory` | Fetch a specific memory by ID |
+| `GoodMemDeleteMemory` | Permanently delete a memory |
+
+## Quick start
+
+```python
+from langchain_goodmem import (
+    GoodMemCreateSpace,
+    GoodMemCreateMemory,
+    GoodMemRetrieveMemories,
+)
+
+goodmem_kwargs = {
+    "goodmem_base_url": "http://localhost:8080",
+    "goodmem_api_key": "your-api-key",
+}
+
+tools = [
+    GoodMemCreateSpace(**goodmem_kwargs),
+    GoodMemCreateMemory(**goodmem_kwargs),
+    GoodMemRetrieveMemories(**goodmem_kwargs),
+]
+```
+
+## Use with a LangChain agent
+
+```python
+from langchain.chat_models import init_chat_model
+from langchain.agents import create_agent
+
+llm = init_chat_model("openai:gpt-4o")
+agent = create_agent(llm, tools)
+
+response = agent.invoke({"messages": [{"role": "user", "content": "Save this fact and recall it later."}]})
+```
+
+## Retrieve with reranking and LLM summary
+
+`GoodMemRetrieveMemories` exposes the full server-side post-processor. Set any of these fields to enable reranking, threshold filtering, chronological re-sort, or an LLM-generated `abstractReply` summary:
+
+```python
+result = retrieve.invoke({
+    "query": "Which framework develops applications with language models?",
+    "space_ids": "space-uuid-1,space-uuid-2",
+    "max_results": 5,
+    "reranker_id": "reranker-uuid",
+    "llm_id": "llm-uuid",
+    "llm_temperature": 0.2,
+    "relevance_threshold": 0.1,
+    "chronological_resort": False,
+})
+```
+
+Leave them all unset for plain semantic search.
+
+## Environment variables
+
+| Variable | Description |
+|---|---|
+| `GOODMEM_BASE_URL` | Base URL of the GoodMem API server |
+| `GOODMEM_API_KEY` | API key for authentication |
+| `GOODMEM_VERIFY_SSL` | Set to `false` to skip TLS verification for self-signed dev certs (default: `true`) |
+
+## Examples
+
+A live end-to-end smoke test exercising every tool and every post-processor knob is in [examples/live_smoke_test.py](examples/live_smoke_test.py).
+
+```bash
+export GOODMEM_BASE_URL=https://localhost:8080
+export GOODMEM_API_KEY=...
+export GOODMEM_VERIFY_SSL=false
+python examples/live_smoke_test.py
+```
+
+## License
+
+MIT — see [LICENSE](LICENSE).