MemoryOS 0.2.0__tar.gz → 0.2.2__tar.gz

{memoryos-0.2.0 → memoryos-0.2.2}/PKG-INFO

@@ -1,33 +1,60 @@
 Metadata-Version: 2.3
 Name: MemoryOS
-Version: 0.2.0
+Version: 0.2.2
 Summary: Intelligence Begins with Memory
 License: Apache-2.0
-Keywords: memory,llm,language model,memoryOS,agent
+Keywords: memory,llm,language model,memoryOS,agent,kv cache,lora
 Author: MemTensor
-Author-email: lizy@memtensor.cn
-Requires-Python: >=3.10,<4.0
+Author-email: MemTensor@memtensor.cn
+Requires-Python: >=3.10
+Classifier: Intended Audience :: Developers
 Classifier: License :: OSI Approved :: Apache Software License
-Classifier: Programming Language :: Python :: 3
+Classifier: Natural Language :: English
+Classifier: Natural Language :: Chinese (Simplified)
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3 :: Only
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
-Requires-Dist: accelerate (>=1.7.0,<2.0.0)
-Requires-Dist: chonkie (>=1.0.7,<2.0.0)
+Classifier: Topic :: Software Development :: Libraries
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Provides-Extra: all
+Provides-Extra: mem-reader
+Provides-Extra: mem-scheduler
+Provides-Extra: tree-mem
+Requires-Dist: chonkie (>=1.0.7,<2.0.0) ; extra == "all"
+Requires-Dist: chonkie (>=1.0.7,<2.0.0) ; extra == "mem-reader"
 Requires-Dist: fastapi[all] (>=0.115.12,<0.116.0)
-Requires-Dist: markitdown[docx,pdf,pptx,xls,xlsx] (>=0.1.1,<0.2.0)
-Requires-Dist: neo4j (>=5.28.1,<6.0.0)
+Requires-Dist: fastmcp (>=2.10.5,<3.0.0)
+Requires-Dist: markitdown[docx,pdf,pptx,xls,xlsx] (>=0.1.1,<0.2.0) ; extra == "all"
+Requires-Dist: markitdown[docx,pdf,pptx,xls,xlsx] (>=0.1.1,<0.2.0) ; extra == "mem-reader"
+Requires-Dist: neo4j (>=5.28.1,<6.0.0) ; extra == "all"
+Requires-Dist: neo4j (>=5.28.1,<6.0.0) ; extra == "tree-mem"
 Requires-Dist: ollama (>=0.4.8,<0.5.0)
 Requires-Dist: openai (>=1.77.0,<2.0.0)
-Requires-Dist: qdrant-client (>=1.14.2,<2.0.0)
-Requires-Dist: redis (>=6.2.0,<7.0.0)
-Requires-Dist: schedule (>=1.2.2,<2.0.0)
-Requires-Dist: sentence-transformers (>=4.1.0,<5.0.0)
+Requires-Dist: pika (>=1.3.2,<2.0.0) ; extra == "all"
+Requires-Dist: pika (>=1.3.2,<2.0.0) ; extra == "mem-scheduler"
+Requires-Dist: python-dateutil (>=2.9.0.post0,<3.0.0)
+Requires-Dist: qdrant-client (>=1.14.2,<2.0.0) ; extra == "all"
+Requires-Dist: redis (>=6.2.0,<7.0.0) ; extra == "all"
+Requires-Dist: redis (>=6.2.0,<7.0.0) ; extra == "mem-scheduler"
+Requires-Dist: schedule (>=1.2.2,<2.0.0) ; extra == "all"
+Requires-Dist: schedule (>=1.2.2,<2.0.0) ; extra == "tree-mem"
+Requires-Dist: scikit-learn (>=1.7.0,<2.0.0)
+Requires-Dist: sentence-transformers (>=4.1.0,<5.0.0) ; extra == "all"
 Requires-Dist: sqlalchemy (>=2.0.41,<3.0.0)
 Requires-Dist: tenacity (>=9.1.2,<10.0.0)
+Requires-Dist: torch (>=2.7.1,<3.0.0) ; extra == "all"
 Requires-Dist: transformers (>=4.51.3,<5.0.0)
+Requires-Dist: volcengine-python-sdk (>=4.0.4,<5.0.0) ; extra == "all"
+Project-URL: Documentation, https://memos-docs.openmem.net/home/overview/
+Project-URL: Homepage, https://memos.openmem.net/
 Project-URL: Repository, https://github.com/MemTensor/MemOS
+Project-URL: changelog, https://github.com/MemTensor/MemOS/releases
+Project-URL: download, https://pypi.org/project/MemoryOS/#files
+Project-URL: issues, https://github.com/MemTensor/MemOS/issues
+Project-URL: releasenotes, https://github.com/MemTensor/MemOS/releases
 Description-Content-Type: text/markdown
 
 <div align="center">
@@ -49,6 +76,9 @@ Description-Content-Type: text/markdown
     <a href="https://pypi.org/project/MemoryOS">
       <img src="https://img.shields.io/pypi/pyversions/MemoryOS.svg" alt="Supported Python versions">
     </a>
+    <a href="https://pypi.org/project/MemoryOS">
+      <img src="https://img.shields.io/badge/Platform-Linux%20%7C%20macOS%20%7C%20Windows-lightgrey" alt="Supported Platforms">
+    </a>
     <a href="https://memos-docs.openmem.net/home/overview/">
       <img src="https://img.shields.io/badge/Documentation-view-blue.svg" alt="Documentation">
     </a>
@@ -170,34 +200,37 @@ For more detailed examples, please check out the [`examples`](./examples) direct
 
 ## 📦 Installation
 
-> [!WARNING]
-> MemOS is compatible with Linux, Windows, and macOS.
->
-> However, if you're using macOS, please note that there may be dependency issues that are difficult to resolve.
->
-> For example, compatibility with macOS 13 Ventura is currently challenging.
-
 ### Install via pip
 
 ```bash
 pip install MemoryOS
 ```
 
-### Development Install
+### Optional Dependencies
 
-To contribute to MemOS, clone the repository and install it in editable mode:
+MemOS provides several optional dependency groups for different features. You can install them based on your needs.
+
+| Feature               | Package Name              |
+| --------------------- | ------------------------- |
+| Tree Memory           | `MemoryOS[tree-mem]`      |
+| Memory Reader         | `MemoryOS[mem-reader]`    |
+| Memory Scheduler      | `MemoryOS[mem-scheduler]` |
+
+Example installation commands:
 
 ```bash
-git clone https://github.com/MemTensor/MemOS.git
-cd MemOS
-make install
+pip install MemoryOS[tree-mem]
+pip install MemoryOS[tree-mem,mem-reader]
+pip install MemoryOS[mem-scheduler]
+pip install MemoryOS[tree-mem,mem-reader,mem-scheduler]
 ```
 
-### Optional Dependencies
+### External Dependencies
 
 #### Ollama Support
 
 To use MemOS with [Ollama](https://ollama.com/), first install the Ollama CLI:
+
 ```bash
 curl -fsSL https://ollama.com/install.sh | sh
 ```
@@ -206,6 +239,14 @@ curl -fsSL https://ollama.com/install.sh | sh
 
 To use functionalities based on the `transformers` library, ensure you have [PyTorch](https://pytorch.org/get-started/locally/) installed (CUDA version recommended for GPU acceleration).
 
+#### Download Examples
+
+To download example code, data and configurations, run the following command:
+
+```bash
+memos download_examples
+```
+
 ## 💬 Community & Support
 
 Join our community to ask questions, share your projects, and connect with other developers.

{memoryos-0.2.0 → memoryos-0.2.2}/README.md

@@ -17,6 +17,9 @@
     <a href="https://pypi.org/project/MemoryOS">
       <img src="https://img.shields.io/pypi/pyversions/MemoryOS.svg" alt="Supported Python versions">
     </a>
+    <a href="https://pypi.org/project/MemoryOS">
+      <img src="https://img.shields.io/badge/Platform-Linux%20%7C%20macOS%20%7C%20Windows-lightgrey" alt="Supported Platforms">
+    </a>
     <a href="https://memos-docs.openmem.net/home/overview/">
       <img src="https://img.shields.io/badge/Documentation-view-blue.svg" alt="Documentation">
     </a>
@@ -138,34 +141,37 @@ For more detailed examples, please check out the [`examples`](./examples) direct
 
 ## 📦 Installation
 
-> [!WARNING]
-> MemOS is compatible with Linux, Windows, and macOS.
->
-> However, if you're using macOS, please note that there may be dependency issues that are difficult to resolve.
->
-> For example, compatibility with macOS 13 Ventura is currently challenging.
-
 ### Install via pip
 
 ```bash
 pip install MemoryOS
 ```
 
-### Development Install
+### Optional Dependencies
 
-To contribute to MemOS, clone the repository and install it in editable mode:
+MemOS provides several optional dependency groups for different features. You can install them based on your needs.
+
+| Feature               | Package Name              |
+| --------------------- | ------------------------- |
+| Tree Memory           | `MemoryOS[tree-mem]`      |
+| Memory Reader         | `MemoryOS[mem-reader]`    |
+| Memory Scheduler      | `MemoryOS[mem-scheduler]` |
+
+Example installation commands:
 
 ```bash
-git clone https://github.com/MemTensor/MemOS.git
-cd MemOS
-make install
+pip install MemoryOS[tree-mem]
+pip install MemoryOS[tree-mem,mem-reader]
+pip install MemoryOS[mem-scheduler]
+pip install MemoryOS[tree-mem,mem-reader,mem-scheduler]
 ```
 
-### Optional Dependencies
+### External Dependencies
 
 #### Ollama Support
 
 To use MemOS with [Ollama](https://ollama.com/), first install the Ollama CLI:
+
 ```bash
 curl -fsSL https://ollama.com/install.sh | sh
 ```
@@ -174,6 +180,14 @@ curl -fsSL https://ollama.com/install.sh | sh
 
 To use functionalities based on the `transformers` library, ensure you have [PyTorch](https://pytorch.org/get-started/locally/) installed (CUDA version recommended for GPU acceleration).
 
+#### Download Examples
+
+To download example code, data and configurations, run the following command:
+
+```bash
+memos download_examples
+```
+
 ## 💬 Community & Support
 
 Join our community to ask questions, share your projects, and connect with other developers.

memoryos-0.2.2/pyproject.toml

@@ -0,0 +1,206 @@
+[project]
+##############################################################################
+# Here define the project metadata and dependencies for the MemoryOS package.
+##############################################################################
+
+name = "MemoryOS"
+version = "0.2.2"
+description = "Intelligence Begins with Memory"
+license = {text = "Apache-2.0"}
+readme = "README.md"
+requires-python = ">=3.10"
+authors = [
+    {name = "MemTensor", email = "MemTensor@memtensor.cn"}
+]
+keywords = [
+    "memory",
+    "llm",
+    "language model",
+    "memoryOS",
+    "agent",
+    "kv cache",
+    "lora",
+]
+classifiers = [
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: Apache Software License",
+    "Natural Language :: English",
+    "Natural Language :: Chinese (Simplified)",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3 :: Only",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Software Development :: Libraries",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+]
+dependencies = [
+    "openai (>=1.77.0,<2.0.0)",
+    "ollama (>=0.4.8,<0.5.0)",
+    "transformers (>=4.51.3,<5.0.0)",
+    "tenacity (>=9.1.2,<10.0.0)",  # Error handling and retrying library
+    "fastapi[all] (>=0.115.12,<0.116.0)",  # Web framework for building APIs
+    "sqlalchemy (>=2.0.41,<3.0.0)",  # SQL toolkit
+    "scikit-learn (>=1.7.0,<2.0.0)",  # Machine learning
+    "fastmcp (>=2.10.5,<3.0.0)",
+    "python-dateutil (>=2.9.0.post0,<3.0.0)",
+]
+
+[project.urls]
+homepage = "https://memos.openmem.net/"
+repository = "https://github.com/MemTensor/MemOS"
+download = "https://pypi.org/project/MemoryOS/#files"
+changelog = "https://github.com/MemTensor/MemOS/releases"
+releasenotes = "https://github.com/MemTensor/MemOS/releases"
+documentation = "https://memos-docs.openmem.net/home/overview/"
+issues = "https://github.com/MemTensor/MemOS/issues"
+
+[project.scripts]
+memos = "memos.cli:main"
+
+[project.optional-dependencies]
+# These are optional dependencies for various features of MemoryOS.
+# Developers install: `poetry install --extras <feature>`. e.g., `poetry install --extras general-mem`
+# Users install: `pip install MemoryOS[<feature>]`. e.g., `pip install MemoryOS[general-mem]`
+
+# TreeTextualMemory
+tree-mem = [
+    "neo4j (>=5.28.1,<6.0.0)",  # Graph database
+    "schedule (>=1.2.2,<2.0.0)",  # Task scheduling
+]
+
+# MemScheduler
+mem-scheduler = [
+    "redis (>=6.2.0,<7.0.0)",  # Key-value store
+    "pika (>=1.3.2,<2.0.0)",  # RabbitMQ client
+]
+
+# MemReader
+mem-reader = [
+    "chonkie (>=1.0.7,<2.0.0)",  # Sentence chunking library
+    "markitdown[docx,pdf,pptx,xls,xlsx] (>=0.1.1,<0.2.0)",  # Markdown parser for various file formats
+]
+
+# All optional dependencies
+# Allow users to install with `pip install MemoryOS[all]`
+all = [
+    # Exist in the above optional groups
+    "neo4j (>=5.28.1,<6.0.0)",
+    "schedule (>=1.2.2,<2.0.0)",
+    "redis (>=6.2.0,<7.0.0)",
+    "pika (>=1.3.2,<2.0.0)",
+    "chonkie (>=1.0.7,<2.0.0)",
+    "markitdown[docx,pdf,pptx,xls,xlsx] (>=0.1.1,<0.2.0)",
+
+    # NOT exist in the above optional groups
+    # Because they are either huge-size dependencies or infrequently used dependencies.
+    # We kindof don't want users to install them.
+    "torch (>=2.7.1,<3.0.0)",
+    "sentence-transformers (>=4.1.0,<5.0.0)",
+    "qdrant-client (>=1.14.2,<2.0.0)",
+    "volcengine-python-sdk (>=4.0.4,<5.0.0)",
+
+    # Uncategorized dependencies
+]
+
+
+[build-system]
+##############################################################################
+# Python package build system requirements.
+##############################################################################
+
+requires = ["poetry-core"]
+build-backend = "poetry.core.masonry.api"
+
+
+[tool.poetry]
+##############################################################################
+# Here mainly define dependencies for development, testing, and evaluation.
+# These dependencies will NOT be included in the MemoryOS package itself.
+# They will be installed when you run `poetry install --with dev,test,eval`.
+#
+# More about version specifiers (e.g. "^0.1.0" or ">=0.1.0,<0.2.0"):
+# https://python-poetry.org/docs/dependency-specification#caret-requirements
+##############################################################################
+
+packages = [{include = "memos", from = "src"}]
+requires-poetry = ">=2.0"
+dependencies = { "python" = ">=3.10,<4.0" }
+
+[tool.poetry.group.dev]
+optional = true
+
+[tool.poetry.group.dev.dependencies]
+pre-commit = "^4.2.0"
+
+
+[tool.poetry.group.test]
+optional = true
+
+[tool.poetry.group.test.dependencies]
+pytest = "^8.3.5"
+pytest-asyncio = "^0.23.5"
+ruff = "^0.11.8"
+
+[tool.poetry.group.eval]
+optional = true
+
+[tool.poetry.group.eval.dependencies]
+dotenv = "^0.9.9"
+mem0ai = "^0.1.109"
+zep-cloud = "^2.15.0"
+rouge-score = "^0.1.2"
+nltk = "^3.9.1"
+bert-score = "^0.3.13"
+scipy = "^1.10.1"
+python-dotenv = "^1.1.1"
+langgraph = "^0.5.1"
+langmem = "^0.0.27"
+
+[[tool.poetry.source]]
+name = "mirrors"
+url = "https://mirrors.tuna.tsinghua.edu.cn/pypi/web/simple/"
+priority = "supplemental"
+
+
+[tool.pytest.ini_options]
+##############################################################################
+# PyTest settings for running tests/
+##############################################################################
+
+asyncio_mode = "auto"
+pythonpath = "src"
+filterwarnings = [
+    "ignore::DeprecationWarning:qdrant_client.*",
+]
+
+
+[tool.ruff]
+##############################################################################
+# Ruff is a fast Python linter and formatter.
+##############################################################################
+
+fix = true
+line-length = 100
+target-version = "py310"
+lint.extend-select = [
+    "B",   # flake8-bugbear
+    "C4",  # flake8-comprehensions
+    "ERA", # flake8-eradicate/eradicate
+    "I",   # isort
+    "N",   # pep8-naming
+    "PIE", # flake8-pie
+    "PGH", # pygrep
+    "RUF", # ruff checks
+    "SIM", # flake8-simplify
+    "TC", # flake8-type-checking
+    "TID", # flake8-tidy-imports
+    "UP",  # pyupgrade
+]
+lint.ignore = [
+    "RUF001", # ambiguous-unicode-character-string
+    "PGH003", # blanket-type-ignore
+]
+lint.isort.lines-between-types = 1
+lint.isort.lines-after-imports = 2

{memoryos-0.2.0 → memoryos-0.2.2}/src/memos/__init__.py

@@ -1,4 +1,4 @@
-__version__ = "0.2.0"
+__version__ = "0.2.2"
 
 from memos.configs.mem_cube import GeneralMemCubeConfig
 from memos.configs.mem_os import MOSConfig