t0ken-memoryx 1.0.0__tar.gz

t0ken_memoryx-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 MemoryX
+
+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.

t0ken_memoryx-1.0.0/PKG-INFO

@@ -0,0 +1,115 @@
+Metadata-Version: 2.4
+Name: t0ken-memoryx
+Version: 1.0.0
+Summary: MemoryX Python SDK - 让 AI Agents 轻松拥有持久记忆
+Home-page: https://t0ken.ai
+Author: MemoryX Team
+Author-email: MemoryX Team <support@t0ken.ai>
+License: MIT
+Project-URL: Homepage, https://t0ken.ai
+Project-URL: Documentation, https://docs.t0ken.ai
+Project-URL: Repository, https://github.com/CensorKo/MemoryX
+Project-URL: Issues, https://github.com/CensorKo/MemoryX/issues
+Keywords: memory,ai,agent,llm,cognitive,memoryx
+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.7
+Classifier: Programming Language :: Python :: 3.8
+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 :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: author
+Dynamic: home-page
+Dynamic: license-file
+Dynamic: requires-python
+
+# MemoryX Python SDK
+
+让 AI Agents 轻松拥有持久记忆
+
+## 快速开始
+
+```python
+from memoryx import connect_memory
+
+# 自动注册并连接
+memory = connect_memory()
+
+# 存储记忆
+memory.add("用户喜欢深色模式")
+
+# 搜索记忆
+results = memory.search("用户偏好")
+```
+
+## 功能特性
+
+- 🔧 **自动注册** - Agent 自动注册，无需手动配置
+- 💾 **永久存储** - 记忆永久保存到向量数据库
+- 🔍 **智能搜索** - 基于语义的相似度搜索
+- 🏷️ **认知分类** - 自动分类为情景/语义/程序/情感/反思记忆
+- 🔒 **隐私安全** - 机器隔离，验证码认领机制
+
+## 完整示例
+
+```python
+from memoryx import connect_memory
+
+# 连接记忆系统
+memory = connect_memory()
+
+# 存储不同类型的记忆
+memory.add(
+    content="用户是Python开发者",
+    category="semantic"  # 语义记忆
+)
+
+memory.add(
+    content="用户昨天去了北京",
+    category="episodic"  # 情景记忆
+)
+
+# 列出所有记忆
+memories = memory.list(limit=10)
+
+# 搜索相关记忆
+results = memory.search("用户职业")
+for item in results["data"]["data"]:
+    print(f"- {item['content']}")
+
+# 删除记忆
+memory.delete("memory_id_here")
+
+# 获取认领验证码
+code = memory.get_claim_code()
+print(f"认领验证码: {code}")
+```
+
+## 安装
+
+```bash
+pip install memoryx
+```
+
+## 认领机器
+
+Agent 注册后，访问 [t0ken.ai/agent-register](http://t0ken.ai/agent-register) 输入验证码认领这台机器。
+
+## 文档
+
+详细文档请访问: https://docs.t0ken.ai
+
+## 开源
+
+MemoryX 是开源项目，欢迎贡献代码！
+
+- GitHub: https://github.com/CensorKo/MemoryX
+- 许可证: MIT

t0ken_memoryx-1.0.0/README.md

@@ -0,0 +1,82 @@
+# MemoryX Python SDK
+
+让 AI Agents 轻松拥有持久记忆
+
+## 快速开始
+
+```python
+from memoryx import connect_memory
+
+# 自动注册并连接
+memory = connect_memory()
+
+# 存储记忆
+memory.add("用户喜欢深色模式")
+
+# 搜索记忆
+results = memory.search("用户偏好")
+```
+
+## 功能特性
+
+- 🔧 **自动注册** - Agent 自动注册，无需手动配置
+- 💾 **永久存储** - 记忆永久保存到向量数据库
+- 🔍 **智能搜索** - 基于语义的相似度搜索
+- 🏷️ **认知分类** - 自动分类为情景/语义/程序/情感/反思记忆
+- 🔒 **隐私安全** - 机器隔离，验证码认领机制
+
+## 完整示例
+
+```python
+from memoryx import connect_memory
+
+# 连接记忆系统
+memory = connect_memory()
+
+# 存储不同类型的记忆
+memory.add(
+    content="用户是Python开发者",
+    category="semantic"  # 语义记忆
+)
+
+memory.add(
+    content="用户昨天去了北京",
+    category="episodic"  # 情景记忆
+)
+
+# 列出所有记忆
+memories = memory.list(limit=10)
+
+# 搜索相关记忆
+results = memory.search("用户职业")
+for item in results["data"]["data"]:
+    print(f"- {item['content']}")
+
+# 删除记忆
+memory.delete("memory_id_here")
+
+# 获取认领验证码
+code = memory.get_claim_code()
+print(f"认领验证码: {code}")
+```
+
+## 安装
+
+```bash
+pip install memoryx
+```
+
+## 认领机器
+
+Agent 注册后，访问 [t0ken.ai/agent-register](http://t0ken.ai/agent-register) 输入验证码认领这台机器。
+
+## 文档
+
+详细文档请访问: https://docs.t0ken.ai
+
+## 开源
+
+MemoryX 是开源项目，欢迎贡献代码！
+
+- GitHub: https://github.com/CensorKo/MemoryX
+- 许可证: MIT

t0ken_memoryx-1.0.0/memoryx/__init__.py

@@ -0,0 +1,11 @@
+"""
+MemoryX Python SDK
+让 AI Agents 轻松拥有持久记忆
+"""
+
+__version__ = "1.0.0"
+__author__ = "MemoryX Team"
+
+from .client import MemoryXClient, connect_memory
+
+__all__ = ["MemoryXClient", "connect_memory"]

t0ken_memoryx-1.0.0/memoryx/client.py

@@ -0,0 +1,298 @@
+"""
+MemoryX Client - 核心客户端
+"""
+
+import json
+import hashlib
+import platform
+import socket
+import uuid
+from typing import Optional, List, Dict, Any
+from urllib.request import Request, urlopen
+from urllib.error import HTTPError
+
+
+class MemoryXClient:
+    """MemoryX 记忆客户端"""
+    
+    DEFAULT_BASE_URL = "http://t0ken.ai/api"
+    
+    def __init__(self, api_key: Optional[str] = None, base_url: Optional[str] = None):
+        """
+        初始化 MemoryX 客户端
+        
+        Args:
+            api_key: API Key（如果已有）
+            base_url: API 基础 URL
+        """
+        self.api_key = api_key
+        self.base_url = base_url or self.DEFAULT_BASE_URL
+        self.machine_fingerprint = self._generate_fingerprint()
+        
+    def _generate_fingerprint(self) -> str:
+        """生成机器指纹"""
+        # 基于硬件信息生成唯一标识
+        machine_info = {
+            "hostname": socket.gethostname(),
+            "platform": platform.system(),
+            "machine": platform.machine(),
+            "processor": platform.processor() or "unknown",
+            "mac": hex(uuid.getnode()),
+        }
+        fingerprint_str = json.dumps(machine_info, sort_keys=True)
+        return hashlib.sha256(fingerprint_str.encode()).hexdigest()[:32]
+    
+    def _request(self, method: str, endpoint: str, data: Optional[dict] = None) -> dict:
+        """发送 HTTP 请求"""
+        url = f"{self.base_url}{endpoint}"
+        headers = {
+            "Content-Type": "application/json",
+            "User-Agent": f"memoryx-python/1.0.0"
+        }
+        
+        if self.api_key:
+            headers["X-API-Key"] = self.api_key
+            
+        req = Request(
+            url,
+            data=json.dumps(data).encode() if data else None,
+            headers=headers,
+            method=method
+        )
+        
+        try:
+            with urlopen(req, timeout=30) as response:
+                return json.loads(response.read().decode())
+        except HTTPError as e:
+            error_body = e.read().decode()
+            try:
+                error_data = json.loads(error_body)
+                raise MemoryXError(error_data.get("message", f"HTTP {e.code}"))
+            except json.JSONDecodeError:
+                raise MemoryXError(f"HTTP {e.code}: {error_body}")
+        except Exception as e:
+            raise MemoryXError(f"Request failed: {str(e)}")
+    
+    def auto_register(self) -> dict:
+        """
+        自动注册机器账户
+        
+        Returns:
+            注册结果，包含 api_key, user_id 等
+        """
+        data = {
+            "machine_fingerprint": self.machine_fingerprint,
+            "platform": platform.system().lower(),
+            "hostname": socket.gethostname()
+        }
+        
+        result = self._request("POST", "/agents/auto-register", data)
+        
+        if result.get("success"):
+            self.api_key = result["data"]["api_key"]
+            # 保存配置
+            self._save_config()
+            
+        return result
+    
+    def _save_config(self):
+        """保存配置到本地文件"""
+        import os
+        config_dir = os.path.expanduser("~/.memoryx")
+        os.makedirs(config_dir, exist_ok=True)
+        
+        config = {
+            "api_key": self.api_key,
+            "machine_fingerprint": self.machine_fingerprint,
+            "base_url": self.base_url
+        }
+        
+        with open(os.path.join(config_dir, "config.json"), "w") as f:
+            json.dump(config, f)
+    
+    def _load_config(self) -> bool:
+        """从本地文件加载配置"""
+        import os
+        config_path = os.path.expanduser("~/.memoryx/config.json")
+        
+        if not os.path.exists(config_path):
+            return False
+            
+        try:
+            with open(config_path, "r") as f:
+                config = json.load(f)
+            
+            # 验证机器指纹
+            if config.get("machine_fingerprint") == self.machine_fingerprint:
+                self.api_key = config.get("api_key")
+                self.base_url = config.get("base_url", self.DEFAULT_BASE_URL)
+                return True
+        except Exception:
+            pass
+            
+        return False
+    
+    def add(self, content: str, category: str = "semantic", 
+            project_id: str = "default", metadata: Optional[dict] = None) -> dict:
+        """
+        存储记忆
+        
+        Args:
+            content: 记忆内容
+            category: 认知分类 (episodic/semantic/procedural/emotional/reflective)
+            project_id: 项目 ID
+            metadata: 额外元数据
+            
+        Returns:
+            存储结果
+        """
+        if not self.api_key:
+            raise MemoryXError("Not registered. Call auto_register() first.")
+            
+        data = {
+            "content": content,
+            "category": category,
+            "project_id": project_id,
+            "metadata": metadata or {}
+        }
+        
+        return self._request("POST", "/memories", data)
+    
+    def list(self, project_id: Optional[str] = None, 
+             limit: int = 100, offset: int = 0) -> dict:
+        """
+        列出记忆
+        
+        Args:
+            project_id: 项目 ID 过滤
+            limit: 返回数量限制
+            offset: 分页偏移
+            
+        Returns:
+            记忆列表
+        """
+        if not self.api_key:
+            raise MemoryXError("Not registered. Call auto_register() first.")
+            
+        params = f"?limit={limit}&offset={offset}"
+        if project_id:
+            params += f"&project_id={project_id}"
+            
+        return self._request("GET", f"/memories{params}")
+    
+    def search(self, query: str, project_id: Optional[str] = None,
+               limit: int = 10) -> dict:
+        """
+        搜索记忆
+        
+        Args:
+            query: 搜索关键词
+            project_id: 项目 ID 过滤
+            limit: 返回数量限制
+            
+        Returns:
+            搜索结果
+        """
+        if not self.api_key:
+            raise MemoryXError("Not registered. Call auto_register() first.")
+            
+        data = {
+            "query": query,
+            "limit": limit
+        }
+        
+        if project_id:
+            data["project_id"] = project_id
+            
+        return self._request("POST", "/memories/search", data)
+    
+    def delete(self, memory_id: str) -> dict:
+        """
+        删除记忆
+        
+        Args:
+            memory_id: 记忆 ID
+            
+        Returns:
+            删除结果
+        """
+        if not self.api_key:
+            raise MemoryXError("Not registered. Call auto_register() first.")
+            
+        return self._request("DELETE", f"/memories/{memory_id}")
+    
+    def get_claim_code(self) -> str:
+        """
+        获取认领验证码
+        
+        Returns:
+            6 位验证码
+        """
+        if not self.api_key:
+            raise MemoryXError("Not registered. Call auto_register() first.")
+            
+        # 这里需要调用 claim/init 接口
+        # 由于需要邮箱，我们先返回一个提示
+        result = self._request("POST", "/agents/claim/init", {
+            "machine_fingerprint": self.machine_fingerprint,
+            "email": "pending@example.com"  # 占位，实际需要用户提供
+        })
+        
+        if result.get("success"):
+            return result["data"]["verification_code"]
+        
+        raise MemoryXError("Failed to get claim code")
+    
+    def get_stats(self) -> dict:
+        """获取机器统计信息"""
+        if not self.api_key:
+            raise MemoryXError("Not registered. Call auto_register() first.")
+            
+        return self._request("GET", f"/agents/machine-stats?machine_fingerprint={self.machine_fingerprint}")
+
+
+class MemoryXError(Exception):
+    """MemoryX 错误"""
+    pass
+
+
+def connect_memory(base_url: Optional[str] = None) -> MemoryXClient:
+    """
+    快速连接记忆系统
+    
+    自动检测本地配置，如果没有则自动注册
+    
+    Args:
+        base_url: API 基础 URL（可选）
+        
+    Returns:
+        MemoryXClient 实例
+        
+    Example:
+        >>> from memoryx import connect_memory
+        >>> memory = connect_memory()
+        >>> memory.add("用户喜欢深色模式")
+        >>> results = memory.search("用户偏好")
+    """
+    client = MemoryXClient(base_url=base_url)
+    
+    # 尝试加载已有配置
+    if client._load_config():
+        print("✅ 已连接到 MemoryX 记忆系统")
+        return client
+    
+    # 自动注册
+    print("🔄 首次使用，自动注册中...")
+    result = client.auto_register()
+    
+    if result.get("success"):
+        data = result["data"]
+        print(f"✅ 注册成功！")
+        print(f"   Agent ID: {data['user_id']}")
+        print(f"   API Key: {data['api_key'][:20]}...")
+        print(f"\n💡 请访问 http://t0ken.ai/agent-register 认领这台机器")
+        print(f"   或询问我：\"我的认领验证码是多少？\"")
+    else:
+        raise MemoryXError(f"Registration failed: {result.get('message')}")
+    
+    return client

t0ken_memoryx-1.0.0/pyproject.toml

@@ -0,0 +1,39 @@
+[build-system]
+requires = ["setuptools>=45", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "t0ken-memoryx"
+version = "1.0.0"
+description = "MemoryX Python SDK - 让 AI Agents 轻松拥有持久记忆"
+readme = "README.md"
+requires-python = ">=3.7"
+license = {text = "MIT"}
+authors = [
+    {name = "MemoryX Team", email = "support@t0ken.ai"}
+]
+keywords = ["memory", "ai", "agent", "llm", "cognitive", "memoryx"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.7",
+    "Programming Language :: Python :: 3.8",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+    "Topic :: Scientific/Engineering :: Artificial Intelligence",
+]
+
+[project.urls]
+Homepage = "https://t0ken.ai"
+Documentation = "https://docs.t0ken.ai"
+Repository = "https://github.com/CensorKo/MemoryX"
+Issues = "https://github.com/CensorKo/MemoryX/issues"
+
+[tool.setuptools.packages.find]
+where = ["."]
+include = ["memoryx*"]

t0ken_memoryx-1.0.0/setup.cfg

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

t0ken_memoryx-1.0.0/setup.py

@@ -0,0 +1,28 @@
+from setuptools import setup, find_packages
+
+setup(
+    name="t0ken-memoryx",
+    version="1.0.0",
+    description="MemoryX Python SDK - 让 AI Agents 轻松拥有持久记忆",
+    long_description=open("README.md").read(),
+    long_description_content_type="text/markdown",
+    author="MemoryX Team",
+    author_email="support@t0ken.ai",
+    url="https://t0ken.ai",
+    packages=find_packages(),
+    python_requires=">=3.7",
+    classifiers=[
+        "Development Status :: 4 - Beta",
+        "Intended Audience :: Developers",
+        "License :: OSI Approved :: MIT License",
+        "Programming Language :: Python :: 3",
+        "Programming Language :: Python :: 3.7",
+        "Programming Language :: Python :: 3.8",
+        "Programming Language :: Python :: 3.9",
+        "Programming Language :: Python :: 3.10",
+        "Programming Language :: Python :: 3.11",
+        "Programming Language :: Python :: 3.12",
+    ],
+    keywords="memory ai agent llm cognitive memoryx",
+    license="MIT",
+)

t0ken_memoryx-1.0.0/t0ken_memoryx.egg-info/PKG-INFO

@@ -0,0 +1,115 @@
+Metadata-Version: 2.4
+Name: t0ken-memoryx
+Version: 1.0.0
+Summary: MemoryX Python SDK - 让 AI Agents 轻松拥有持久记忆
+Home-page: https://t0ken.ai
+Author: MemoryX Team
+Author-email: MemoryX Team <support@t0ken.ai>
+License: MIT
+Project-URL: Homepage, https://t0ken.ai
+Project-URL: Documentation, https://docs.t0ken.ai
+Project-URL: Repository, https://github.com/CensorKo/MemoryX
+Project-URL: Issues, https://github.com/CensorKo/MemoryX/issues
+Keywords: memory,ai,agent,llm,cognitive,memoryx
+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.7
+Classifier: Programming Language :: Python :: 3.8
+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 :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: author
+Dynamic: home-page
+Dynamic: license-file
+Dynamic: requires-python
+
+# MemoryX Python SDK
+
+让 AI Agents 轻松拥有持久记忆
+
+## 快速开始
+
+```python
+from memoryx import connect_memory
+
+# 自动注册并连接
+memory = connect_memory()
+
+# 存储记忆
+memory.add("用户喜欢深色模式")
+
+# 搜索记忆
+results = memory.search("用户偏好")
+```
+
+## 功能特性
+
+- 🔧 **自动注册** - Agent 自动注册，无需手动配置
+- 💾 **永久存储** - 记忆永久保存到向量数据库
+- 🔍 **智能搜索** - 基于语义的相似度搜索
+- 🏷️ **认知分类** - 自动分类为情景/语义/程序/情感/反思记忆
+- 🔒 **隐私安全** - 机器隔离，验证码认领机制
+
+## 完整示例
+
+```python
+from memoryx import connect_memory
+
+# 连接记忆系统
+memory = connect_memory()
+
+# 存储不同类型的记忆
+memory.add(
+    content="用户是Python开发者",
+    category="semantic"  # 语义记忆
+)
+
+memory.add(
+    content="用户昨天去了北京",
+    category="episodic"  # 情景记忆
+)
+
+# 列出所有记忆
+memories = memory.list(limit=10)
+
+# 搜索相关记忆
+results = memory.search("用户职业")
+for item in results["data"]["data"]:
+    print(f"- {item['content']}")
+
+# 删除记忆
+memory.delete("memory_id_here")
+
+# 获取认领验证码
+code = memory.get_claim_code()
+print(f"认领验证码: {code}")
+```
+
+## 安装
+
+```bash
+pip install memoryx
+```
+
+## 认领机器
+
+Agent 注册后，访问 [t0ken.ai/agent-register](http://t0ken.ai/agent-register) 输入验证码认领这台机器。
+
+## 文档
+
+详细文档请访问: https://docs.t0ken.ai
+
+## 开源
+
+MemoryX 是开源项目，欢迎贡献代码！
+
+- GitHub: https://github.com/CensorKo/MemoryX
+- 许可证: MIT

t0ken_memoryx-1.0.0/t0ken_memoryx.egg-info/SOURCES.txt

@@ -0,0 +1,10 @@
+LICENSE
+README.md
+pyproject.toml
+setup.py
+memoryx/__init__.py
+memoryx/client.py
+t0ken_memoryx.egg-info/PKG-INFO
+t0ken_memoryx.egg-info/SOURCES.txt
+t0ken_memoryx.egg-info/dependency_links.txt
+t0ken_memoryx.egg-info/top_level.txt

t0ken_memoryx-1.0.0/t0ken_memoryx.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

t0ken_memoryx-1.0.0/t0ken_memoryx.egg-info/top_level.txt

@@ -0,0 +1 @@
+memoryx