MemoryOS 0.0.1__tar.gz → 0.1.13__tar.gz

memoryos-0.1.13/PKG-INFO

@@ -0,0 +1,288 @@
+Metadata-Version: 2.3
+Name: MemoryOS
+Version: 0.1.13
+Summary: Intelligence Begins with Memory
+License: Apache-2.0
+Keywords: memory,llm,language model,memoryOS,agent
+Author: MemTensor
+Author-email: lizy@memtensor.cn
+Requires-Python: >=3.10,<4.0
+Classifier: License :: OSI Approved :: Apache Software 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
+Requires-Dist: accelerate (>=1.7.0,<2.0.0)
+Requires-Dist: chonkie (>=1.0.7,<2.0.0)
+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: 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: sentence-transformers (>=4.1.0,<5.0.0)
+Requires-Dist: sqlalchemy (>=2.0.41,<3.0.0)
+Requires-Dist: tenacity (>=9.1.2,<10.0.0)
+Requires-Dist: transformers (>=4.51.3,<5.0.0)
+Project-URL: Repository, https://github.com/MemTensor/MemOS
+Description-Content-Type: text/markdown
+
+<div align="center">
+  <a href="https://memos.openmem.net/">
+    <img src="docs/assets/banner_new.gif" alt="MemOS Banner">
+  </a>
+
+
+
+<h1 align="center">
+  <img src="docs/assets/memos_logo.png" alt="MemOS Logo" width="50"/> MemOS 1.0: 星河 (Stellar)  <img src="https://img.shields.io/badge/status-Preview-blue" alt="Preview Badge"/>
+</h1>
+
+  <p>
+    <a href="https://www.memtensor.com.cn/">
+      <img alt="Static Badge" src="https://img.shields.io/badge/Maintained_by-MemTensor-blue">
+    </a>
+    <a href="https://pypi.org/project/MemoryOS">
+      <img src="https://img.shields.io/pypi/v/MemoryOS?label=pypi%20package" alt="PyPI Version">
+    </a>
+    <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://memos.openmem.net/docs/home">
+      <img src="https://img.shields.io/badge/Documentation-view-blue.svg" alt="Documentation">
+    </a>
+    <a href="https://arxiv.org/abs/2507.03724">
+        <img src="https://img.shields.io/badge/arXiv-2507.03724-b31b1b.svg" alt="ArXiv Paper">
+    </a>
+    <a href="https://github.com/MemTensor/MemOS/discussions">
+      <img src="https://img.shields.io/badge/GitHub-Discussions-181717.svg?logo=github" alt="GitHub Discussions">
+    </a>
+    <a href="https://discord.gg/Txbx3gebZR">
+      <img src="https://img.shields.io/badge/Discord-join%20chat-7289DA.svg?logo=discord" alt="Discord">
+    </a>
+    <a href="docs/assets/qr_code.png">
+      <img src="https://img.shields.io/badge/WeChat-Group-07C160.svg?logo=wechat" alt="WeChat Group">
+    </a>
+    <a href="https://opensource.org/license/apache-2-0/">
+      <img src="https://img.shields.io/badge/License-Apache_2.0-green.svg?logo=apache" alt="License">
+    </a>
+  </p>
+</div>
+
+---
+
+  <a href="https://memos.openmem.net/">
+    <img src="docs/assets/sota_score.jpg" alt="SOTA SCORE">
+  </a>
+
+
+**MemOS** is an operating system for Large Language Models (LLMs) that enhances them with long-term memory capabilities. It allows LLMs to store, retrieve, and manage information, enabling more context-aware, consistent, and personalized interactions.
+
+- **Website**: <a href="https://memos.openmem.net/" target="_blank">https://memos.openmem.net/</a>
+- **Documentation**: <a href="https://memos.openmem.net/docs/home" target="_blank">https://memos.openmem.net/docs/home</a>
+- **API Reference**: <a href="https://memos.openmem.net/docs/api/info" target="_blank">https://memos.openmem.net/docs/api/info</a>
+- **Source Code**: <a href="https://github.com/MemTensor/MemOS" target="_blank">https://github.com/MemTensor/MemOS</a>
+
+## 📈 Performance Benchmark
+
+MemOS demonstrates significant improvements over baseline memory solutions in multiple reasoning tasks.
+
+| Model       | Avg. Score | Multi-Hop | Open Domain | Single-Hop | Temporal Reasoning |
+|-------------|------------|-----------|-------------|------------|---------------------|
+| **OpenAI**  | 0.5275     | 0.6028    | 0.3299      | 0.6183     | 0.2825              |
+| **MemOS**   | **0.7331** | **0.6430** | **0.5521**   | **0.7844** | **0.7321**          |
+| **Improvement** | **+38.98%** | **+6.67%** | **+67.35%** | **+26.86%** | **+159.15%**       |
+
+> 💡 **Temporal reasoning accuracy improved by 159% compared to the OpenAI baseline.**
+
+
+
+### Details of End-to-End Evaluation on LOCOMO
+
+> [!NOTE]
+> Comparison of LLM Judge Scores across five major tasks in the LOCOMO benchmark. Each bar shows the mean evaluation score judged by LLMs for a given method-task pair, with standard deviation as error bars. MemOS-0630 consistently outperforms baseline methods (LangMem, Zep, OpenAI, Mem0) across all task types, especially in multi-hop and temporal reasoning scenarios.
+
+<a href="https://memos.openmem.net/">
+  <img src="docs/assets/score_all_end2end.jpg" alt="END2END SCORE">
+</a>
+
+
+
+
+## ✨ Key Features
+
+- **🧠 Memory-Augmented Generation (MAG)**: Provides a unified API for memory operations, integrating with LLMs to enhance chat and reasoning with contextual memory retrieval.
+- **📦 Modular Memory Architecture (MemCube)**: A flexible and modular architecture that allows for easy integration and management of different memory types.
+- **💾 Multiple Memory Types**:
+    - **Textual Memory**: For storing and retrieving unstructured or structured text knowledge.
+    - **Activation Memory**: Caches key-value pairs (`KVCacheMemory`) to accelerate LLM inference and context reuse.
+    - **Parametric Memory**: Stores model adaptation parameters (e.g., LoRA weights).
+- **🔌 Extensible**: Easily extend and customize memory modules, data sources, and LLM integrations.
+
+## 🚀 Getting Started
+
+Here's a quick example of how to create a **`MemCube`**, load it from a directory, access its memories, and save it.
+
+```python
+from memos.mem_cube.general import GeneralMemCube
+
+# Initialize a MemCube from a local directory
+mem_cube = GeneralMemCube.init_from_dir("examples/data/mem_cube_2")
+
+# Access and print all memories
+print("--- Textual Memories ---")
+for item in mem_cube.text_mem.get_all():
+    print(item)
+
+print("\n--- Activation Memories ---")
+for item in mem_cube.act_mem.get_all():
+    print(item)
+
+# Save the MemCube to a new directory
+mem_cube.dump("tmp/mem_cube")
+```
+
+What about **`MOS`** (Memory Operating System)? It's a higher-level orchestration layer that manages multiple MemCubes and provides a unified API for memory operations. Here's a quick example of how to use MOS:
+
+```python
+from memos.configs.mem_os import MOSConfig
+from memos.mem_os.main import MOS
+
+
+# init MOS
+mos_config = MOSConfig.from_json_file("examples/data/config/simple_memos_config.json")
+memory = MOS(mos_config)
+
+# create user
+user_id = "b41a34d5-5cae-4b46-8c49-d03794d206f5"
+memory.create_user(user_id=user_id)
+
+# register cube for user
+memory.register_mem_cube("examples/data/mem_cube_2", user_id=user_id)
+
+# add memory for user
+memory.add(
+    messages=[
+        {"role": "user", "content": "I like playing football."},
+        {"role": "assistant", "content": "I like playing football too."},
+    ],
+    user_id=user_id,
+)
+
+# Later, when you want to retrieve memory for user
+retrieved_memories = memory.search(query="What do you like?", user_id=user_id)
+# output text_memories: I like playing football, act_memories, para_memories
+print(f"text_memories: {retrieved_memories['text_mem']}")
+```
+
+For more detailed examples, please check out the [`examples`](./examples) directory.
+
+## 📦 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
+
+To contribute to MemOS, clone the repository and install it in editable mode:
+
+```bash
+git clone https://github.com/MemTensor/MemOS.git
+cd MemOS
+make install
+```
+
+### Optional 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
+```
+
+#### Transformers Support
+
+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).
+
+## 💬 Community & Support
+
+Join our community to ask questions, share your projects, and connect with other developers.
+
+- **GitHub Issues**: Report bugs or request features in our <a href="https://github.com/MemTensor/MemOS/issues" target="_blank">GitHub Issues</a>.
+- **GitHub Pull Requests**: Contribute code improvements via <a href="https://github.com/MemTensor/MemOS/pulls" target="_blank">Pull Requests</a>.
+- **GitHub Discussions**: Participate in our <a href="https://github.com/MemTensor/MemOS/discussions" target="_blank">GitHub Discussions</a> to ask questions or share ideas.
+- **Discord**: Join our <a href="https://discord.gg/Txbx3gebZR" target="_blank">Discord Server</a>.
+- **WeChat**: Scan the QR code to join our WeChat group.
+
+<img src="docs/assets/qr_code.png" alt="QR Code" width="600">
+
+## 📜 Citation
+
+> [!NOTE]
+> We publicly released the Short Version on **May 28, 2025**, making it the earliest work to propose the concept of a Memory Operating System for LLMs.
+
+If you use MemOS in your research, we would appreciate citations to our papers.
+
+```bibtex
+
+@article{li2025memos_long,
+  title={MemOS: A Memory OS for AI System},
+  author={Li, Zhiyu and Song, Shichao and Xi, Chenyang and Wang, Hanyu and Tang, Chen and Niu, Simin and Chen, Ding and Yang, Jiawei and Li, Chunyu and Yu, Qingchen and Zhao, Jihao and Wang, Yezhaohui and Liu, Peng and Lin, Zehao and Wang, Pengyuan and Huo, Jiahao and Chen, Tianyi and Chen, Kai and Li, Kehang and Tao, Zhen and Ren, Junpeng and Lai, Huayi and Wu, Hao and Tang, Bo and Wang, Zhenren and Fan, Zhaoxin and Zhang, Ningyu and Zhang, Linfeng and Yan, Junchi and Yang, Mingchuan and Xu, Tong and Xu, Wei and Chen, Huajun and Wang, Haofeng and Yang, Hongkang and Zhang, Wentao and Xu, Zhi-Qin John and Chen, Siheng and Xiong, Feiyu},
+  journal={arXiv preprint arXiv:2507.03724},
+  year={2025},
+  url={https://arxiv.org/abs/2507.03724}
+}
+
+@article{li2025memos_short,
+  title={MemOS: An Operating System for Memory-Augmented Generation (MAG) in Large Language Models},
+  author={Li, Zhiyu and Song, Shichao and Wang, Hanyu and Niu, Simin and Chen, Ding and Yang, Jiawei and Xi, Chenyang and Lai, Huayi and Zhao, Jihao and Wang, Yezhaohui and others},
+  journal={arXiv preprint arXiv:2505.22101},
+  year={2025},
+  url={https://arxiv.org/abs/2505.22101}
+}
+
+@article{yang2024memory3,
+author = {Yang, Hongkang and Zehao, Lin and Wenjin, Wang and Wu, Hao and Zhiyu, Li and Tang, Bo and Wenqiang, Wei and Wang, Jinbo and Zeyun, Tang and Song, Shichao and Xi, Chenyang and Yu, Yu and Kai, Chen and Xiong, Feiyu and Tang, Linpeng and Weinan, E},
+title = {Memory$^3$: Language Modeling with Explicit Memory},
+journal = {Journal of Machine Learning},
+year = {2024},
+volume = {3},
+number = {3},
+pages = {300--346},
+issn = {2790-2048},
+doi = {https://doi.org/10.4208/jml.240708},
+url = {https://global-sci.com/article/91443/memory3-language-modeling-with-explicit-memory}
+}
+```
+
+## 🙌 Contributing
+
+We welcome contributions from the community! Please read our [contribution guidelines](https://memos.openmem.net/docs/contribution/overview) to get started.
+
+## 📄 License
+
+MemOS is licensed under the [Apache 2.0 License](./LICENSE).
+
+## 📰 News
+
+Stay up to date with the latest MemOS announcements, releases, and community highlights.
+
+- **2025-07-07** – 🎉 *MemOS 1.0 (Stellar) Preview Release*: A SOTA Memory OS for LLMs is now open-sourced.
+- **2025-07-04** – 🎉 *MemOS Paper Released*: [MemOS: A Memory OS for AI System](https://arxiv.org/abs/2507.03724) was published on arXiv.
+- **2025-05-28** – 🎉 *Short Paper Uploaded*: [MemOS: An Operating System for Memory-Augmented Generation (MAG) in Large Language Models](https://arxiv.org/abs/2505.22101) was published on arXiv.
+- **2024-07-04** – 🎉 *Memory3 Model Released at WAIC 2024*: The new memory-layered architecture model was unveiled at the 2024 World Artificial Intelligence Conference.
+- **2024-07-01** – 🎉 *Memory3 Paper Released*: [Memory3: Language Modeling with Explicit Memory](https://arxiv.org/abs/2407.01178) introduces the new approach to structured memory in LLMs.
+

memoryos-0.1.13/README.md

@@ -0,0 +1,256 @@
+<div align="center">
+  <a href="https://memos.openmem.net/">
+    <img src="docs/assets/banner_new.gif" alt="MemOS Banner">
+  </a>
+
+
+
+<h1 align="center">
+  <img src="docs/assets/memos_logo.png" alt="MemOS Logo" width="50"/> MemOS 1.0: 星河 (Stellar)  <img src="https://img.shields.io/badge/status-Preview-blue" alt="Preview Badge"/>
+</h1>
+
+  <p>
+    <a href="https://www.memtensor.com.cn/">
+      <img alt="Static Badge" src="https://img.shields.io/badge/Maintained_by-MemTensor-blue">
+    </a>
+    <a href="https://pypi.org/project/MemoryOS">
+      <img src="https://img.shields.io/pypi/v/MemoryOS?label=pypi%20package" alt="PyPI Version">
+    </a>
+    <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://memos.openmem.net/docs/home">
+      <img src="https://img.shields.io/badge/Documentation-view-blue.svg" alt="Documentation">
+    </a>
+    <a href="https://arxiv.org/abs/2507.03724">
+        <img src="https://img.shields.io/badge/arXiv-2507.03724-b31b1b.svg" alt="ArXiv Paper">
+    </a>
+    <a href="https://github.com/MemTensor/MemOS/discussions">
+      <img src="https://img.shields.io/badge/GitHub-Discussions-181717.svg?logo=github" alt="GitHub Discussions">
+    </a>
+    <a href="https://discord.gg/Txbx3gebZR">
+      <img src="https://img.shields.io/badge/Discord-join%20chat-7289DA.svg?logo=discord" alt="Discord">
+    </a>
+    <a href="docs/assets/qr_code.png">
+      <img src="https://img.shields.io/badge/WeChat-Group-07C160.svg?logo=wechat" alt="WeChat Group">
+    </a>
+    <a href="https://opensource.org/license/apache-2-0/">
+      <img src="https://img.shields.io/badge/License-Apache_2.0-green.svg?logo=apache" alt="License">
+    </a>
+  </p>
+</div>
+
+---
+
+  <a href="https://memos.openmem.net/">
+    <img src="docs/assets/sota_score.jpg" alt="SOTA SCORE">
+  </a>
+
+
+**MemOS** is an operating system for Large Language Models (LLMs) that enhances them with long-term memory capabilities. It allows LLMs to store, retrieve, and manage information, enabling more context-aware, consistent, and personalized interactions.
+
+- **Website**: <a href="https://memos.openmem.net/" target="_blank">https://memos.openmem.net/</a>
+- **Documentation**: <a href="https://memos.openmem.net/docs/home" target="_blank">https://memos.openmem.net/docs/home</a>
+- **API Reference**: <a href="https://memos.openmem.net/docs/api/info" target="_blank">https://memos.openmem.net/docs/api/info</a>
+- **Source Code**: <a href="https://github.com/MemTensor/MemOS" target="_blank">https://github.com/MemTensor/MemOS</a>
+
+## 📈 Performance Benchmark
+
+MemOS demonstrates significant improvements over baseline memory solutions in multiple reasoning tasks.
+
+| Model       | Avg. Score | Multi-Hop | Open Domain | Single-Hop | Temporal Reasoning |
+|-------------|------------|-----------|-------------|------------|---------------------|
+| **OpenAI**  | 0.5275     | 0.6028    | 0.3299      | 0.6183     | 0.2825              |
+| **MemOS**   | **0.7331** | **0.6430** | **0.5521**   | **0.7844** | **0.7321**          |
+| **Improvement** | **+38.98%** | **+6.67%** | **+67.35%** | **+26.86%** | **+159.15%**       |
+
+> 💡 **Temporal reasoning accuracy improved by 159% compared to the OpenAI baseline.**
+
+
+
+### Details of End-to-End Evaluation on LOCOMO
+
+> [!NOTE]
+> Comparison of LLM Judge Scores across five major tasks in the LOCOMO benchmark. Each bar shows the mean evaluation score judged by LLMs for a given method-task pair, with standard deviation as error bars. MemOS-0630 consistently outperforms baseline methods (LangMem, Zep, OpenAI, Mem0) across all task types, especially in multi-hop and temporal reasoning scenarios.
+
+<a href="https://memos.openmem.net/">
+  <img src="docs/assets/score_all_end2end.jpg" alt="END2END SCORE">
+</a>
+
+
+
+
+## ✨ Key Features
+
+- **🧠 Memory-Augmented Generation (MAG)**: Provides a unified API for memory operations, integrating with LLMs to enhance chat and reasoning with contextual memory retrieval.
+- **📦 Modular Memory Architecture (MemCube)**: A flexible and modular architecture that allows for easy integration and management of different memory types.
+- **💾 Multiple Memory Types**:
+    - **Textual Memory**: For storing and retrieving unstructured or structured text knowledge.
+    - **Activation Memory**: Caches key-value pairs (`KVCacheMemory`) to accelerate LLM inference and context reuse.
+    - **Parametric Memory**: Stores model adaptation parameters (e.g., LoRA weights).
+- **🔌 Extensible**: Easily extend and customize memory modules, data sources, and LLM integrations.
+
+## 🚀 Getting Started
+
+Here's a quick example of how to create a **`MemCube`**, load it from a directory, access its memories, and save it.
+
+```python
+from memos.mem_cube.general import GeneralMemCube
+
+# Initialize a MemCube from a local directory
+mem_cube = GeneralMemCube.init_from_dir("examples/data/mem_cube_2")
+
+# Access and print all memories
+print("--- Textual Memories ---")
+for item in mem_cube.text_mem.get_all():
+    print(item)
+
+print("\n--- Activation Memories ---")
+for item in mem_cube.act_mem.get_all():
+    print(item)
+
+# Save the MemCube to a new directory
+mem_cube.dump("tmp/mem_cube")
+```
+
+What about **`MOS`** (Memory Operating System)? It's a higher-level orchestration layer that manages multiple MemCubes and provides a unified API for memory operations. Here's a quick example of how to use MOS:
+
+```python
+from memos.configs.mem_os import MOSConfig
+from memos.mem_os.main import MOS
+
+
+# init MOS
+mos_config = MOSConfig.from_json_file("examples/data/config/simple_memos_config.json")
+memory = MOS(mos_config)
+
+# create user
+user_id = "b41a34d5-5cae-4b46-8c49-d03794d206f5"
+memory.create_user(user_id=user_id)
+
+# register cube for user
+memory.register_mem_cube("examples/data/mem_cube_2", user_id=user_id)
+
+# add memory for user
+memory.add(
+    messages=[
+        {"role": "user", "content": "I like playing football."},
+        {"role": "assistant", "content": "I like playing football too."},
+    ],
+    user_id=user_id,
+)
+
+# Later, when you want to retrieve memory for user
+retrieved_memories = memory.search(query="What do you like?", user_id=user_id)
+# output text_memories: I like playing football, act_memories, para_memories
+print(f"text_memories: {retrieved_memories['text_mem']}")
+```
+
+For more detailed examples, please check out the [`examples`](./examples) directory.
+
+## 📦 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
+
+To contribute to MemOS, clone the repository and install it in editable mode:
+
+```bash
+git clone https://github.com/MemTensor/MemOS.git
+cd MemOS
+make install
+```
+
+### Optional 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
+```
+
+#### Transformers Support
+
+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).
+
+## 💬 Community & Support
+
+Join our community to ask questions, share your projects, and connect with other developers.
+
+- **GitHub Issues**: Report bugs or request features in our <a href="https://github.com/MemTensor/MemOS/issues" target="_blank">GitHub Issues</a>.
+- **GitHub Pull Requests**: Contribute code improvements via <a href="https://github.com/MemTensor/MemOS/pulls" target="_blank">Pull Requests</a>.
+- **GitHub Discussions**: Participate in our <a href="https://github.com/MemTensor/MemOS/discussions" target="_blank">GitHub Discussions</a> to ask questions or share ideas.
+- **Discord**: Join our <a href="https://discord.gg/Txbx3gebZR" target="_blank">Discord Server</a>.
+- **WeChat**: Scan the QR code to join our WeChat group.
+
+<img src="docs/assets/qr_code.png" alt="QR Code" width="600">
+
+## 📜 Citation
+
+> [!NOTE]
+> We publicly released the Short Version on **May 28, 2025**, making it the earliest work to propose the concept of a Memory Operating System for LLMs.
+
+If you use MemOS in your research, we would appreciate citations to our papers.
+
+```bibtex
+
+@article{li2025memos_long,
+  title={MemOS: A Memory OS for AI System},
+  author={Li, Zhiyu and Song, Shichao and Xi, Chenyang and Wang, Hanyu and Tang, Chen and Niu, Simin and Chen, Ding and Yang, Jiawei and Li, Chunyu and Yu, Qingchen and Zhao, Jihao and Wang, Yezhaohui and Liu, Peng and Lin, Zehao and Wang, Pengyuan and Huo, Jiahao and Chen, Tianyi and Chen, Kai and Li, Kehang and Tao, Zhen and Ren, Junpeng and Lai, Huayi and Wu, Hao and Tang, Bo and Wang, Zhenren and Fan, Zhaoxin and Zhang, Ningyu and Zhang, Linfeng and Yan, Junchi and Yang, Mingchuan and Xu, Tong and Xu, Wei and Chen, Huajun and Wang, Haofeng and Yang, Hongkang and Zhang, Wentao and Xu, Zhi-Qin John and Chen, Siheng and Xiong, Feiyu},
+  journal={arXiv preprint arXiv:2507.03724},
+  year={2025},
+  url={https://arxiv.org/abs/2507.03724}
+}
+
+@article{li2025memos_short,
+  title={MemOS: An Operating System for Memory-Augmented Generation (MAG) in Large Language Models},
+  author={Li, Zhiyu and Song, Shichao and Wang, Hanyu and Niu, Simin and Chen, Ding and Yang, Jiawei and Xi, Chenyang and Lai, Huayi and Zhao, Jihao and Wang, Yezhaohui and others},
+  journal={arXiv preprint arXiv:2505.22101},
+  year={2025},
+  url={https://arxiv.org/abs/2505.22101}
+}
+
+@article{yang2024memory3,
+author = {Yang, Hongkang and Zehao, Lin and Wenjin, Wang and Wu, Hao and Zhiyu, Li and Tang, Bo and Wenqiang, Wei and Wang, Jinbo and Zeyun, Tang and Song, Shichao and Xi, Chenyang and Yu, Yu and Kai, Chen and Xiong, Feiyu and Tang, Linpeng and Weinan, E},
+title = {Memory$^3$: Language Modeling with Explicit Memory},
+journal = {Journal of Machine Learning},
+year = {2024},
+volume = {3},
+number = {3},
+pages = {300--346},
+issn = {2790-2048},
+doi = {https://doi.org/10.4208/jml.240708},
+url = {https://global-sci.com/article/91443/memory3-language-modeling-with-explicit-memory}
+}
+```
+
+## 🙌 Contributing
+
+We welcome contributions from the community! Please read our [contribution guidelines](https://memos.openmem.net/docs/contribution/overview) to get started.
+
+## 📄 License
+
+MemOS is licensed under the [Apache 2.0 License](./LICENSE).
+
+## 📰 News
+
+Stay up to date with the latest MemOS announcements, releases, and community highlights.
+
+- **2025-07-07** – 🎉 *MemOS 1.0 (Stellar) Preview Release*: A SOTA Memory OS for LLMs is now open-sourced.
+- **2025-07-04** – 🎉 *MemOS Paper Released*: [MemOS: A Memory OS for AI System](https://arxiv.org/abs/2507.03724) was published on arXiv.
+- **2025-05-28** – 🎉 *Short Paper Uploaded*: [MemOS: An Operating System for Memory-Augmented Generation (MAG) in Large Language Models](https://arxiv.org/abs/2505.22101) was published on arXiv.
+- **2024-07-04** – 🎉 *Memory3 Model Released at WAIC 2024*: The new memory-layered architecture model was unveiled at the 2024 World Artificial Intelligence Conference.
+- **2024-07-01** – 🎉 *Memory3 Paper Released*: [Memory3: Language Modeling with Explicit Memory](https://arxiv.org/abs/2407.01178) introduces the new approach to structured memory in LLMs.

{memoryos-0.0.1 → memoryos-0.1.13}/pyproject.toml

@@ -2,10 +2,10 @@
 
 [tool.poetry]
 name = "MemoryOS"
-version = "0.0.1"
-description = "Empowering language models with memory."
+version = "0.1.13"
+description = "Intelligence Begins with Memory"
 license = "Apache-2.0"
-authors = ["MemoryTensor <lizy@memtensor.cn>"]
+authors = ["MemTensor <lizy@memtensor.cn>"]
 readme = "README.md"
 repository = "https://github.com/MemTensor/MemOS"
 keywords = ["memory", "llm", "language model", "memoryOS", "agent"]
@@ -13,15 +13,48 @@ packages = [{include = "memos", from = "src"}]
 
 [tool.poetry.dependencies]
 python = "^3.10"
-pytest = "^8.3.5"
-pre-commit = "^4.2.0"
-ruff = "^0.11.8"
 openai = "^1.77.0"
 ollama = "^0.4.8"
 qdrant-client = "^1.14.2"
 transformers = "^4.51.3"
 markitdown = {extras = ["docx", "pdf", "pptx", "xls", "xlsx"], version = "^0.1.1"}
 chonkie = "^1.0.7"
+tenacity = "^9.1.2"
+neo4j = "^5.28.1"
+accelerate = "^1.7.0"
+fastapi = {extras = ["all"], version = "^0.115.12"}
+sentence-transformers = "^4.1.0"
+sqlalchemy = "^2.0.41"
+redis = "^6.2.0"
+
+[tool.poetry.group.dev]
+optional = false
+
+[tool.poetry.group.dev.dependencies]
+pre-commit = "^4.2.0"
+ruff = "^0.11.8"
+
+[tool.poetry.group.test]
+optional = false
+
+[tool.poetry.group.test.dependencies]
+pytest = "^8.3.5"
+pytest-asyncio = "^0.23.5"
+
+[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"
@@ -39,7 +72,11 @@ build-backend = "poetry.core.masonry.api"
 # Testing related
 
 [tool.pytest.ini_options]
+asyncio_mode = "auto"
 pythonpath = "src"
+filterwarnings = [
+    "ignore::DeprecationWarning:qdrant_client.*",
+]
 
 
 # Linting related

memoryos-0.1.13/src/memos/__init__.py

@@ -0,0 +1,20 @@
+__version__ = "0.1.13"
+
+from memos.configs.mem_cube import GeneralMemCubeConfig
+from memos.configs.mem_os import MOSConfig
+from memos.configs.mem_scheduler import SchedulerConfigFactory
+from memos.mem_cube.general import GeneralMemCube
+from memos.mem_os.main import MOS
+from memos.mem_scheduler.general_scheduler import GeneralScheduler
+from memos.mem_scheduler.scheduler_factory import SchedulerFactory
+
+
+__all__ = [
+    "MOS",
+    "GeneralMemCube",
+    "GeneralMemCubeConfig",
+    "GeneralScheduler",
+    "MOSConfig",
+    "SchedulerConfigFactory",
+    "SchedulerFactory",
+]