Skip to content

docs: add HippoDid persistent character memory integration#3453

Open
snowmanjy wants to merge 14 commits intolangchain-ai:mainfrom
SameThoughts:docs/add-hippodid-memory-integration
Open

docs: add HippoDid persistent character memory integration#3453
snowmanjy wants to merge 14 commits intolangchain-ai:mainfrom
SameThoughts:docs/add-hippodid-memory-integration

Conversation

@snowmanjy
Copy link
Copy Markdown

Summary

Adds documentation for the langchain-hippodid integration — persistent, structured character memory for LangChain agents.

This is a docs-only PR. No code changes to langchain-core or langchain-community. The langchain-hippodid package is already published on PyPI (v0.1.0).

What is HippoDid?

HippoDid provides character-scoped cloud memory for AI agents. Each user/customer gets their own character with categorized, searchable memory that persists across sessions and frameworks.

Classes provided

  • HippoDidChatMessageHistory — extends BaseChatMessageHistory, stores messages in HippoDid cloud
  • HippoDidMemory — convenience wrapper with get_history() factory for RunnableWithMessageHistory

Changes

  1. src/oss/integrations/providers/hippodid.mdx — Provider overview page with installation, capabilities, and links
  2. src/oss/python/integrations/chat_message_histories/hippodid.mdx — Component page with usage examples:
    • Basic chat message history (add/retrieve/clear)
    • Semantic search and context assembly
    • Multi-user pattern (external_id)
    • RunnableWithMessageHistory (LCEL) integration
    • Memory modes comparison table
  3. packages.yml — Added langchain-hippodid to package registry
  4. src/oss/python/integrations/providers/all_providers.mdx — Added HippoDid card in alphabetical order

AI disclosure

This PR was authored with assistance from Claude Code (AI agent).

@github-actions github-actions bot added langchain For docs changes to LangChain oss python For content related to the Python version of LangChain projects external User is not a member of langchain-ai labels Apr 6, 2026
@github-actions
Copy link
Copy Markdown
Contributor

github-actions bot commented Apr 6, 2026

❌ Import check failed

This PR contains imports from langchain_core that should be imported from langchain instead.

Detailed issues
Analyzing diff for import issues...
 Found 3 import issues:

File: src/oss/python/integrations/chat_message_histories/hippodid.mdx
Line: 84
Issue: Import from langchain.messages instead of langchain_core.messages
Current:   from langchain_core.messages import AIMessage, HumanMessage
Suggested: from langchain.messages import AIMessage, HumanMessage
--------------------------------------------------------------------------------
File: src/oss/python/integrations/chat_message_histories/hippodid.mdx
Line: 130
Issue: Import from langchain.messages instead of langchain_core.messages
Current:   from langchain_core.messages import HumanMessage
Suggested: from langchain.messages import HumanMessage
--------------------------------------------------------------------------------
File: src/oss/python/integrations/chat_message_histories/hippodid.mdx
Line: 207
Issue: Import from langchain.messages instead of langchain_core.messages
Current:   from langchain_core.messages import HumanMessage, SystemMessage
Suggested: from langchain.messages import HumanMessage, SystemMessage
--------------------------------------------------------------------------------

 Found 3 import issues that need to be fixed.

Why this is a problem

The langchain package re-exports many modules and classes from langchain_core. When possible, imports should use langchain instead of langchain_core for:

  • Better user experience (single import source)
  • Consistency across documentation
  • Reduced cognitive load for users

How to fix

Replace the imports as suggested above. For example:

  • from langchain_core.messages import HumanMessage
  • from langchain.messages import HumanMessage

🤖 Automated check

This check is based on the latest analysis of langchain re-exports from langchain_core.

Yang Jing and others added 4 commits April 6, 2026 14:12
Add integration docs for langchain-hippodid package (PyPI: v0.1.0).

- Provider page at oss/integrations/providers/hippodid.mdx
- Chat message history page at oss/python/integrations/chat_message_histories/hippodid.mdx
- Add langchain-hippodid to packages.yml registry
- Add HippoDid card to all_providers.mdx index

HippoDidChatMessageHistory implements BaseChatMessageHistory with
persistent cloud-backed character memory, semantic search, and
context assembly. HippoDidMemory provides RunnableWithMessageHistory
compatibility.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Update code examples to use `from langchain.messages` instead of
`from langchain_core.messages` per CI import check requirements.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
The partner_pkg_table.py build script checks for provider pages in
src/oss/python/integrations/providers/, not src/oss/integrations/providers/.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
…rt in langchain)

langchain_core.prompts and langchain_core.runnables.history are the
canonical import paths — langchain does not re-export these modules.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@snowmanjy snowmanjy force-pushed the docs/add-hippodid-memory-integration branch from 40398e1 to 7e69509 Compare April 6, 2026 21:12
@snowmanjy
Copy link
Copy Markdown
Author

Adding the standard PR checklist that was missing from the original description:

Checklist

  • I have read the contributing guidelines, including the language policy
  • I have tested my changes locally using docs dev
  • All code examples have been tested and work correctly
  • I have used root relative paths for internal links
  • I have updated navigation in src/docs.json if needed

Notes:

  • Code examples validated against langchain-hippodid==0.1.0 and hippodid==0.2.0 (both on PyPI). All HippoDidChatMessageHistory and HippoDidMemory methods tested with langchain==1.2.15 and langchain-core==1.2.26.
  • docs dev not run locally — relying on CI preview for visual validation.
  • src/docs.json was not modified in this PR. Happy to add the navigation entry if reviewers confirm the new integration page (src/oss/python/integrations/chat_message_histories/hippodid.mdx) needs to be registered there for sidebar discoverability — please advise.

snowmanjy and others added 5 commits April 8, 2026 09:32
@snowmanjy
Copy link
Copy Markdown
Author

Mason Daugherty (@mdrxy) Can you please take a look? Thanks!

snowmanjy and others added 3 commits April 17, 2026 22:14
Keep updated oracle download count from upstream (64000) while
preserving the langchain-hippodid entry from this branch.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

external User is not a member of langchain-ai langchain For docs changes to LangChain oss python For content related to the Python version of LangChain projects

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant