langchain-xache 0.1.0__tar.gz

langchain_xache-0.1.0/PKG-INFO

@@ -0,0 +1,199 @@
+Metadata-Version: 2.4
+Name: langchain-xache
+Version: 0.1.0
+Summary: LangChain integration for Xache Protocol - verifiable AI agent memory
+Author-email: Xache Protocol <dev@xache.xyz>
+License: MIT
+Project-URL: Homepage, https://xache.xyz
+Project-URL: Documentation, https://docs.xache.xyz
+Project-URL: Repository, https://github.com/oliveskin/xache
+Keywords: langchain,ai,agents,memory,blockchain,receipts,reputation,erc8004,x402
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+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
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+Requires-Dist: xache>=0.1.0
+Requires-Dist: langchain>=0.1.0
+Requires-Dist: pydantic>=2.0.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.21.0; extra == "dev"
+Requires-Dist: black>=23.0.0; extra == "dev"
+Requires-Dist: isort>=5.12.0; extra == "dev"
+
+# langchain-xache
+
+LangChain integration for [Xache Protocol](https://xache.xyz) - verifiable AI agent memory with cryptographic receipts, collective intelligence, and portable ERC-8004 reputation.
+
+## Installation
+
+```bash
+pip install langchain-xache
+```
+
+## Quick Start
+
+### One-Line Memory Replacement
+
+```python
+# Before (standard LangChain)
+from langchain.memory import ConversationBufferMemory
+memory = ConversationBufferMemory()
+
+# After (with Xache - one line change!)
+from xache_langchain import XacheMemory
+memory = XacheMemory(
+    wallet_address="0x...",
+    private_key="0x..."
+)
+
+# Everything else stays the same
+agent = initialize_agent(tools, llm, memory=memory)
+```
+
+## Features
+
+### Memory Storage
+Persistent memory that survives across sessions with cryptographic receipts:
+
+```python
+from xache_langchain import XacheMemory
+
+memory = XacheMemory(
+    wallet_address="0xYourWallet",
+    private_key="0xYourPrivateKey",
+    api_url="https://api.xache.xyz",  # optional
+    chain="base"  # or "solana"
+)
+```
+
+### Retrieval (RAG)
+Semantic search for retrieval-augmented generation:
+
+```python
+from xache_langchain import XacheRetriever
+from langchain.chains import RetrievalQA
+
+retriever = XacheRetriever(
+    wallet_address="0x...",
+    private_key="0x...",
+    k=5  # number of documents
+)
+
+qa = RetrievalQA.from_chain_type(llm=llm, retriever=retriever)
+```
+
+### Collective Intelligence
+Query and contribute to shared knowledge:
+
+```python
+from xache_langchain import XacheCollectiveContributeTool, XacheCollectiveQueryTool
+
+# Add to your agent's tools
+contribute = XacheCollectiveContributeTool(
+    wallet_address="0x...",
+    private_key="0x..."
+)
+
+query = XacheCollectiveQueryTool(
+    wallet_address="0x...",
+    private_key="0x..."
+)
+
+tools = [contribute, query, ...]
+```
+
+### Memory Extraction
+Auto-extract memories from conversations:
+
+```python
+from xache_langchain import XacheExtractor
+
+extractor = XacheExtractor(
+    wallet_address="0x...",
+    private_key="0x...",
+    mode="xache-managed"  # or "api-key" with your LLM key
+)
+
+result = extractor.extract(
+    trace="User asked about quantum computing...",
+    auto_store=True  # automatically store extracted memories
+)
+
+print(f"Extracted {len(result.memories)} memories")
+```
+
+### Reputation
+Check and verify agent reputation:
+
+```python
+from xache_langchain import XacheReputationTool, XacheReputationChecker
+
+# As a tool for your agent
+rep_tool = XacheReputationTool(
+    wallet_address="0x...",
+    private_key="0x..."
+)
+
+# Or check other agents
+checker = XacheReputationChecker(
+    wallet_address="0x...",
+    private_key="0x..."
+)
+
+other_rep = checker.check("did:agent:evm:0xOtherAgent...")
+if other_rep.score >= 0.5:
+    print("Agent is trustworthy")
+```
+
+## Chat History
+
+For more control over message history:
+
+```python
+from xache_langchain import XacheChatMessageHistory
+from langchain.memory import ConversationBufferMemory
+
+history = XacheChatMessageHistory(
+    wallet_address="0x...",
+    private_key="0x...",
+    session_id="unique-session-id"
+)
+
+memory = ConversationBufferMemory(chat_memory=history)
+```
+
+## Pricing
+
+All operations use x402 micropayments (auto-handled):
+
+| Operation | Price |
+|-----------|-------|
+| Memory Store | $0.002 |
+| Memory Retrieve | $0.003 |
+| Collective Contribute | $0.002 |
+| Collective Query | $0.011 |
+| Extraction (managed) | $0.011 |
+
+## ERC-8004 Portable Reputation
+
+Xache supports [ERC-8004](https://eips.ethereum.org/EIPS/eip-8004) for portable, on-chain reputation. Enable it to make your agent's reputation verifiable across platforms.
+
+## Resources
+
+- [Documentation](https://docs.xache.xyz)
+- [API Reference](https://docs.xache.xyz/api)
+- [GitHub](https://github.com/oliveskin/xache)
+- [Discord](https://discord.gg/xache)
+
+## License
+
+MIT

langchain_xache-0.1.0/README.md

@@ -0,0 +1,168 @@
+# langchain-xache
+
+LangChain integration for [Xache Protocol](https://xache.xyz) - verifiable AI agent memory with cryptographic receipts, collective intelligence, and portable ERC-8004 reputation.
+
+## Installation
+
+```bash
+pip install langchain-xache
+```
+
+## Quick Start
+
+### One-Line Memory Replacement
+
+```python
+# Before (standard LangChain)
+from langchain.memory import ConversationBufferMemory
+memory = ConversationBufferMemory()
+
+# After (with Xache - one line change!)
+from xache_langchain import XacheMemory
+memory = XacheMemory(
+    wallet_address="0x...",
+    private_key="0x..."
+)
+
+# Everything else stays the same
+agent = initialize_agent(tools, llm, memory=memory)
+```
+
+## Features
+
+### Memory Storage
+Persistent memory that survives across sessions with cryptographic receipts:
+
+```python
+from xache_langchain import XacheMemory
+
+memory = XacheMemory(
+    wallet_address="0xYourWallet",
+    private_key="0xYourPrivateKey",
+    api_url="https://api.xache.xyz",  # optional
+    chain="base"  # or "solana"
+)
+```
+
+### Retrieval (RAG)
+Semantic search for retrieval-augmented generation:
+
+```python
+from xache_langchain import XacheRetriever
+from langchain.chains import RetrievalQA
+
+retriever = XacheRetriever(
+    wallet_address="0x...",
+    private_key="0x...",
+    k=5  # number of documents
+)
+
+qa = RetrievalQA.from_chain_type(llm=llm, retriever=retriever)
+```
+
+### Collective Intelligence
+Query and contribute to shared knowledge:
+
+```python
+from xache_langchain import XacheCollectiveContributeTool, XacheCollectiveQueryTool
+
+# Add to your agent's tools
+contribute = XacheCollectiveContributeTool(
+    wallet_address="0x...",
+    private_key="0x..."
+)
+
+query = XacheCollectiveQueryTool(
+    wallet_address="0x...",
+    private_key="0x..."
+)
+
+tools = [contribute, query, ...]
+```
+
+### Memory Extraction
+Auto-extract memories from conversations:
+
+```python
+from xache_langchain import XacheExtractor
+
+extractor = XacheExtractor(
+    wallet_address="0x...",
+    private_key="0x...",
+    mode="xache-managed"  # or "api-key" with your LLM key
+)
+
+result = extractor.extract(
+    trace="User asked about quantum computing...",
+    auto_store=True  # automatically store extracted memories
+)
+
+print(f"Extracted {len(result.memories)} memories")
+```
+
+### Reputation
+Check and verify agent reputation:
+
+```python
+from xache_langchain import XacheReputationTool, XacheReputationChecker
+
+# As a tool for your agent
+rep_tool = XacheReputationTool(
+    wallet_address="0x...",
+    private_key="0x..."
+)
+
+# Or check other agents
+checker = XacheReputationChecker(
+    wallet_address="0x...",
+    private_key="0x..."
+)
+
+other_rep = checker.check("did:agent:evm:0xOtherAgent...")
+if other_rep.score >= 0.5:
+    print("Agent is trustworthy")
+```
+
+## Chat History
+
+For more control over message history:
+
+```python
+from xache_langchain import XacheChatMessageHistory
+from langchain.memory import ConversationBufferMemory
+
+history = XacheChatMessageHistory(
+    wallet_address="0x...",
+    private_key="0x...",
+    session_id="unique-session-id"
+)
+
+memory = ConversationBufferMemory(chat_memory=history)
+```
+
+## Pricing
+
+All operations use x402 micropayments (auto-handled):
+
+| Operation | Price |
+|-----------|-------|
+| Memory Store | $0.002 |
+| Memory Retrieve | $0.003 |
+| Collective Contribute | $0.002 |
+| Collective Query | $0.011 |
+| Extraction (managed) | $0.011 |
+
+## ERC-8004 Portable Reputation
+
+Xache supports [ERC-8004](https://eips.ethereum.org/EIPS/eip-8004) for portable, on-chain reputation. Enable it to make your agent's reputation verifiable across platforms.
+
+## Resources
+
+- [Documentation](https://docs.xache.xyz)
+- [API Reference](https://docs.xache.xyz/api)
+- [GitHub](https://github.com/oliveskin/xache)
+- [Discord](https://discord.gg/xache)
+
+## License
+
+MIT

langchain_xache-0.1.0/langchain_xache.egg-info/PKG-INFO

@@ -0,0 +1,199 @@
+Metadata-Version: 2.4
+Name: langchain-xache
+Version: 0.1.0
+Summary: LangChain integration for Xache Protocol - verifiable AI agent memory
+Author-email: Xache Protocol <dev@xache.xyz>
+License: MIT
+Project-URL: Homepage, https://xache.xyz
+Project-URL: Documentation, https://docs.xache.xyz
+Project-URL: Repository, https://github.com/oliveskin/xache
+Keywords: langchain,ai,agents,memory,blockchain,receipts,reputation,erc8004,x402
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+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
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+Requires-Dist: xache>=0.1.0
+Requires-Dist: langchain>=0.1.0
+Requires-Dist: pydantic>=2.0.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.21.0; extra == "dev"
+Requires-Dist: black>=23.0.0; extra == "dev"
+Requires-Dist: isort>=5.12.0; extra == "dev"
+
+# langchain-xache
+
+LangChain integration for [Xache Protocol](https://xache.xyz) - verifiable AI agent memory with cryptographic receipts, collective intelligence, and portable ERC-8004 reputation.
+
+## Installation
+
+```bash
+pip install langchain-xache
+```
+
+## Quick Start
+
+### One-Line Memory Replacement
+
+```python
+# Before (standard LangChain)
+from langchain.memory import ConversationBufferMemory
+memory = ConversationBufferMemory()
+
+# After (with Xache - one line change!)
+from xache_langchain import XacheMemory
+memory = XacheMemory(
+    wallet_address="0x...",
+    private_key="0x..."
+)
+
+# Everything else stays the same
+agent = initialize_agent(tools, llm, memory=memory)
+```
+
+## Features
+
+### Memory Storage
+Persistent memory that survives across sessions with cryptographic receipts:
+
+```python
+from xache_langchain import XacheMemory
+
+memory = XacheMemory(
+    wallet_address="0xYourWallet",
+    private_key="0xYourPrivateKey",
+    api_url="https://api.xache.xyz",  # optional
+    chain="base"  # or "solana"
+)
+```
+
+### Retrieval (RAG)
+Semantic search for retrieval-augmented generation:
+
+```python
+from xache_langchain import XacheRetriever
+from langchain.chains import RetrievalQA
+
+retriever = XacheRetriever(
+    wallet_address="0x...",
+    private_key="0x...",
+    k=5  # number of documents
+)
+
+qa = RetrievalQA.from_chain_type(llm=llm, retriever=retriever)
+```
+
+### Collective Intelligence
+Query and contribute to shared knowledge:
+
+```python
+from xache_langchain import XacheCollectiveContributeTool, XacheCollectiveQueryTool
+
+# Add to your agent's tools
+contribute = XacheCollectiveContributeTool(
+    wallet_address="0x...",
+    private_key="0x..."
+)
+
+query = XacheCollectiveQueryTool(
+    wallet_address="0x...",
+    private_key="0x..."
+)
+
+tools = [contribute, query, ...]
+```
+
+### Memory Extraction
+Auto-extract memories from conversations:
+
+```python
+from xache_langchain import XacheExtractor
+
+extractor = XacheExtractor(
+    wallet_address="0x...",
+    private_key="0x...",
+    mode="xache-managed"  # or "api-key" with your LLM key
+)
+
+result = extractor.extract(
+    trace="User asked about quantum computing...",
+    auto_store=True  # automatically store extracted memories
+)
+
+print(f"Extracted {len(result.memories)} memories")
+```
+
+### Reputation
+Check and verify agent reputation:
+
+```python
+from xache_langchain import XacheReputationTool, XacheReputationChecker
+
+# As a tool for your agent
+rep_tool = XacheReputationTool(
+    wallet_address="0x...",
+    private_key="0x..."
+)
+
+# Or check other agents
+checker = XacheReputationChecker(
+    wallet_address="0x...",
+    private_key="0x..."
+)
+
+other_rep = checker.check("did:agent:evm:0xOtherAgent...")
+if other_rep.score >= 0.5:
+    print("Agent is trustworthy")
+```
+
+## Chat History
+
+For more control over message history:
+
+```python
+from xache_langchain import XacheChatMessageHistory
+from langchain.memory import ConversationBufferMemory
+
+history = XacheChatMessageHistory(
+    wallet_address="0x...",
+    private_key="0x...",
+    session_id="unique-session-id"
+)
+
+memory = ConversationBufferMemory(chat_memory=history)
+```
+
+## Pricing
+
+All operations use x402 micropayments (auto-handled):
+
+| Operation | Price |
+|-----------|-------|
+| Memory Store | $0.002 |
+| Memory Retrieve | $0.003 |
+| Collective Contribute | $0.002 |
+| Collective Query | $0.011 |
+| Extraction (managed) | $0.011 |
+
+## ERC-8004 Portable Reputation
+
+Xache supports [ERC-8004](https://eips.ethereum.org/EIPS/eip-8004) for portable, on-chain reputation. Enable it to make your agent's reputation verifiable across platforms.
+
+## Resources
+
+- [Documentation](https://docs.xache.xyz)
+- [API Reference](https://docs.xache.xyz/api)
+- [GitHub](https://github.com/oliveskin/xache)
+- [Discord](https://discord.gg/xache)
+
+## License
+
+MIT

langchain_xache-0.1.0/langchain_xache.egg-info/SOURCES.txt

@@ -0,0 +1,15 @@
+README.md
+pyproject.toml
+langchain_xache.egg-info/PKG-INFO
+langchain_xache.egg-info/SOURCES.txt
+langchain_xache.egg-info/dependency_links.txt
+langchain_xache.egg-info/requires.txt
+langchain_xache.egg-info/top_level.txt
+xache_langchain/__init__.py
+xache_langchain/_async_utils.py
+xache_langchain/chat_history.py
+xache_langchain/collective.py
+xache_langchain/extraction.py
+xache_langchain/memory.py
+xache_langchain/reputation.py
+xache_langchain/retriever.py

langchain_xache-0.1.0/langchain_xache.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

langchain_xache-0.1.0/langchain_xache.egg-info/requires.txt

@@ -0,0 +1,9 @@
+xache>=0.1.0
+langchain>=0.1.0
+pydantic>=2.0.0
+
+[dev]
+pytest>=7.0.0
+pytest-asyncio>=0.21.0
+black>=23.0.0
+isort>=5.12.0

langchain_xache-0.1.0/langchain_xache.egg-info/top_level.txt

@@ -0,0 +1 @@
+xache_langchain

langchain_xache-0.1.0/pyproject.toml

@@ -0,0 +1,67 @@
+[build-system]
+requires = ["setuptools>=61.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "langchain-xache"
+version = "0.1.0"
+description = "LangChain integration for Xache Protocol - verifiable AI agent memory"
+readme = "README.md"
+license = {text = "MIT"}
+requires-python = ">=3.9"
+authors = [
+    {name = "Xache Protocol", email = "dev@xache.xyz"}
+]
+keywords = [
+    "langchain",
+    "ai",
+    "agents",
+    "memory",
+    "blockchain",
+    "receipts",
+    "reputation",
+    "erc8004",
+    "x402",
+]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Scientific/Engineering :: Artificial Intelligence",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+]
+dependencies = [
+    "xache>=0.1.0",
+    "langchain>=0.1.0",
+    "pydantic>=2.0.0",
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=7.0.0",
+    "pytest-asyncio>=0.21.0",
+    "black>=23.0.0",
+    "isort>=5.12.0",
+]
+
+[project.urls]
+Homepage = "https://xache.xyz"
+Documentation = "https://docs.xache.xyz"
+Repository = "https://github.com/oliveskin/xache"
+
+[tool.setuptools.packages.find]
+where = ["."]
+include = ["xache_langchain*"]
+
+[tool.black]
+line-length = 88
+target-version = ['py39', 'py310', 'py311', 'py312']
+
+[tool.isort]
+profile = "black"
+line_length = 88

langchain_xache-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+