MemoryOS 0.1.12__tar.gz → 0.2.0__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Potentially problematic release.


This version of MemoryOS might be problematic. Click here for more details.

Files changed (129) hide show
  1. {memoryos-0.1.12 → memoryos-0.2.0}/PKG-INFO +51 -31
  2. {memoryos-0.1.12 → memoryos-0.2.0}/README.md +49 -30
  3. {memoryos-0.1.12 → memoryos-0.2.0}/pyproject.toml +6 -1
  4. {memoryos-0.1.12 → memoryos-0.2.0}/src/memos/__init__.py +1 -1
  5. memoryos-0.2.0/src/memos/configs/internet_retriever.py +81 -0
  6. {memoryos-0.1.12 → memoryos-0.2.0}/src/memos/configs/llm.py +1 -0
  7. {memoryos-0.1.12 → memoryos-0.2.0}/src/memos/configs/mem_os.py +4 -0
  8. {memoryos-0.1.12 → memoryos-0.2.0}/src/memos/configs/mem_reader.py +4 -0
  9. {memoryos-0.1.12 → memoryos-0.2.0}/src/memos/configs/memory.py +11 -1
  10. memoryos-0.2.0/src/memos/graph_dbs/item.py +46 -0
  11. {memoryos-0.1.12 → memoryos-0.2.0}/src/memos/graph_dbs/neo4j.py +72 -5
  12. {memoryos-0.1.12 → memoryos-0.2.0}/src/memos/llms/openai.py +1 -0
  13. memoryos-0.2.0/src/memos/mem_os/main.py +503 -0
  14. {memoryos-0.1.12 → memoryos-0.2.0}/src/memos/mem_reader/simple_struct.py +11 -6
  15. {memoryos-0.1.12 → memoryos-0.2.0}/src/memos/mem_user/user_manager.py +10 -0
  16. {memoryos-0.1.12 → memoryos-0.2.0}/src/memos/memories/textual/item.py +3 -1
  17. {memoryos-0.1.12 → memoryos-0.2.0}/src/memos/memories/textual/tree.py +39 -3
  18. memoryos-0.2.0/src/memos/memories/textual/tree_text_memory/organize/conflict.py +196 -0
  19. {memoryos-0.1.12 → memoryos-0.2.0}/src/memos/memories/textual/tree_text_memory/organize/manager.py +49 -8
  20. memoryos-0.2.0/src/memos/memories/textual/tree_text_memory/organize/redundancy.py +212 -0
  21. memoryos-0.2.0/src/memos/memories/textual/tree_text_memory/organize/relation_reason_detector.py +235 -0
  22. memoryos-0.2.0/src/memos/memories/textual/tree_text_memory/organize/reorganizer.py +584 -0
  23. memoryos-0.2.0/src/memos/memories/textual/tree_text_memory/retrieve/internet_retriever.py +263 -0
  24. memoryos-0.2.0/src/memos/memories/textual/tree_text_memory/retrieve/internet_retriever_factory.py +89 -0
  25. {memoryos-0.1.12 → memoryos-0.2.0}/src/memos/memories/textual/tree_text_memory/retrieve/reasoner.py +1 -4
  26. {memoryos-0.1.12 → memoryos-0.2.0}/src/memos/memories/textual/tree_text_memory/retrieve/searcher.py +46 -4
  27. {memoryos-0.1.12 → memoryos-0.2.0}/src/memos/memories/textual/tree_text_memory/retrieve/task_goal_parser.py +3 -3
  28. memoryos-0.2.0/src/memos/memories/textual/tree_text_memory/retrieve/xinyusearch.py +335 -0
  29. {memoryos-0.1.12 → memoryos-0.2.0}/src/memos/templates/mem_reader_prompts.py +42 -15
  30. memoryos-0.2.0/src/memos/templates/mos_prompts.py +63 -0
  31. memoryos-0.2.0/src/memos/templates/tree_reorganize_prompts.py +168 -0
  32. memoryos-0.1.12/src/memos/mem_os/main.py +0 -12
  33. {memoryos-0.1.12 → memoryos-0.2.0}/LICENSE +0 -0
  34. {memoryos-0.1.12 → memoryos-0.2.0}/src/memos/api/start_api.py +0 -0
  35. {memoryos-0.1.12 → memoryos-0.2.0}/src/memos/chunkers/__init__.py +0 -0
  36. {memoryos-0.1.12 → memoryos-0.2.0}/src/memos/chunkers/base.py +0 -0
  37. {memoryos-0.1.12 → memoryos-0.2.0}/src/memos/chunkers/factory.py +0 -0
  38. {memoryos-0.1.12 → memoryos-0.2.0}/src/memos/chunkers/sentence_chunker.py +0 -0
  39. {memoryos-0.1.12 → memoryos-0.2.0}/src/memos/configs/__init__.py +0 -0
  40. {memoryos-0.1.12 → memoryos-0.2.0}/src/memos/configs/base.py +0 -0
  41. {memoryos-0.1.12 → memoryos-0.2.0}/src/memos/configs/chunker.py +0 -0
  42. {memoryos-0.1.12 → memoryos-0.2.0}/src/memos/configs/embedder.py +0 -0
  43. {memoryos-0.1.12 → memoryos-0.2.0}/src/memos/configs/graph_db.py +0 -0
  44. {memoryos-0.1.12 → memoryos-0.2.0}/src/memos/configs/mem_chat.py +0 -0
  45. {memoryos-0.1.12 → memoryos-0.2.0}/src/memos/configs/mem_cube.py +0 -0
  46. {memoryos-0.1.12 → memoryos-0.2.0}/src/memos/configs/mem_scheduler.py +0 -0
  47. {memoryos-0.1.12 → memoryos-0.2.0}/src/memos/configs/parser.py +0 -0
  48. {memoryos-0.1.12 → memoryos-0.2.0}/src/memos/configs/utils.py +0 -0
  49. {memoryos-0.1.12 → memoryos-0.2.0}/src/memos/configs/vec_db.py +0 -0
  50. {memoryos-0.1.12 → memoryos-0.2.0}/src/memos/deprecation.py +0 -0
  51. {memoryos-0.1.12 → memoryos-0.2.0}/src/memos/embedders/__init__.py +0 -0
  52. {memoryos-0.1.12 → memoryos-0.2.0}/src/memos/embedders/base.py +0 -0
  53. {memoryos-0.1.12 → memoryos-0.2.0}/src/memos/embedders/factory.py +0 -0
  54. {memoryos-0.1.12 → memoryos-0.2.0}/src/memos/embedders/ollama.py +0 -0
  55. {memoryos-0.1.12 → memoryos-0.2.0}/src/memos/embedders/sentence_transformer.py +0 -0
  56. {memoryos-0.1.12 → memoryos-0.2.0}/src/memos/exceptions.py +0 -0
  57. {memoryos-0.1.12 → memoryos-0.2.0}/src/memos/graph_dbs/__init__.py +0 -0
  58. {memoryos-0.1.12 → memoryos-0.2.0}/src/memos/graph_dbs/base.py +0 -0
  59. {memoryos-0.1.12 → memoryos-0.2.0}/src/memos/graph_dbs/factory.py +0 -0
  60. {memoryos-0.1.12 → memoryos-0.2.0}/src/memos/hello_world.py +0 -0
  61. {memoryos-0.1.12 → memoryos-0.2.0}/src/memos/llms/__init__.py +0 -0
  62. {memoryos-0.1.12 → memoryos-0.2.0}/src/memos/llms/base.py +0 -0
  63. {memoryos-0.1.12 → memoryos-0.2.0}/src/memos/llms/factory.py +0 -0
  64. {memoryos-0.1.12 → memoryos-0.2.0}/src/memos/llms/hf.py +0 -0
  65. {memoryos-0.1.12 → memoryos-0.2.0}/src/memos/llms/ollama.py +0 -0
  66. {memoryos-0.1.12 → memoryos-0.2.0}/src/memos/llms/utils.py +0 -0
  67. {memoryos-0.1.12 → memoryos-0.2.0}/src/memos/log.py +0 -0
  68. {memoryos-0.1.12 → memoryos-0.2.0}/src/memos/mem_chat/__init__.py +0 -0
  69. {memoryos-0.1.12 → memoryos-0.2.0}/src/memos/mem_chat/base.py +0 -0
  70. {memoryos-0.1.12 → memoryos-0.2.0}/src/memos/mem_chat/factory.py +0 -0
  71. {memoryos-0.1.12 → memoryos-0.2.0}/src/memos/mem_chat/simple.py +0 -0
  72. {memoryos-0.1.12 → memoryos-0.2.0}/src/memos/mem_cube/__init__.py +0 -0
  73. {memoryos-0.1.12 → memoryos-0.2.0}/src/memos/mem_cube/base.py +0 -0
  74. {memoryos-0.1.12 → memoryos-0.2.0}/src/memos/mem_cube/general.py +0 -0
  75. {memoryos-0.1.12 → memoryos-0.2.0}/src/memos/mem_cube/utils.py +0 -0
  76. {memoryos-0.1.12 → memoryos-0.2.0}/src/memos/mem_os/client.py +0 -0
  77. {memoryos-0.1.12 → memoryos-0.2.0}/src/memos/mem_os/core.py +0 -0
  78. {memoryos-0.1.12 → memoryos-0.2.0}/src/memos/mem_os/product.py +0 -0
  79. {memoryos-0.1.12 → memoryos-0.2.0}/src/memos/mem_reader/__init__.py +0 -0
  80. {memoryos-0.1.12 → memoryos-0.2.0}/src/memos/mem_reader/base.py +0 -0
  81. {memoryos-0.1.12 → memoryos-0.2.0}/src/memos/mem_reader/factory.py +0 -0
  82. {memoryos-0.1.12 → memoryos-0.2.0}/src/memos/mem_reader/memory.py +0 -0
  83. {memoryos-0.1.12 → memoryos-0.2.0}/src/memos/mem_scheduler/__init__.py +0 -0
  84. {memoryos-0.1.12 → memoryos-0.2.0}/src/memos/mem_scheduler/base_scheduler.py +0 -0
  85. {memoryos-0.1.12 → memoryos-0.2.0}/src/memos/mem_scheduler/general_scheduler.py +0 -0
  86. {memoryos-0.1.12 → memoryos-0.2.0}/src/memos/mem_scheduler/modules/__init__.py +0 -0
  87. {memoryos-0.1.12 → memoryos-0.2.0}/src/memos/mem_scheduler/modules/base.py +0 -0
  88. {memoryos-0.1.12 → memoryos-0.2.0}/src/memos/mem_scheduler/modules/dispatcher.py +0 -0
  89. {memoryos-0.1.12 → memoryos-0.2.0}/src/memos/mem_scheduler/modules/monitor.py +0 -0
  90. {memoryos-0.1.12 → memoryos-0.2.0}/src/memos/mem_scheduler/modules/redis_service.py +0 -0
  91. {memoryos-0.1.12 → memoryos-0.2.0}/src/memos/mem_scheduler/modules/retriever.py +0 -0
  92. {memoryos-0.1.12 → memoryos-0.2.0}/src/memos/mem_scheduler/modules/schemas.py +0 -0
  93. {memoryos-0.1.12 → memoryos-0.2.0}/src/memos/mem_scheduler/scheduler_factory.py +0 -0
  94. {memoryos-0.1.12 → memoryos-0.2.0}/src/memos/mem_scheduler/utils.py +0 -0
  95. {memoryos-0.1.12 → memoryos-0.2.0}/src/memos/memories/__init__.py +0 -0
  96. {memoryos-0.1.12 → memoryos-0.2.0}/src/memos/memories/activation/__init__.py +0 -0
  97. {memoryos-0.1.12 → memoryos-0.2.0}/src/memos/memories/activation/base.py +0 -0
  98. {memoryos-0.1.12 → memoryos-0.2.0}/src/memos/memories/activation/item.py +0 -0
  99. {memoryos-0.1.12 → memoryos-0.2.0}/src/memos/memories/activation/kv.py +0 -0
  100. {memoryos-0.1.12 → memoryos-0.2.0}/src/memos/memories/base.py +0 -0
  101. {memoryos-0.1.12 → memoryos-0.2.0}/src/memos/memories/factory.py +0 -0
  102. {memoryos-0.1.12 → memoryos-0.2.0}/src/memos/memories/parametric/__init__.py +0 -0
  103. {memoryos-0.1.12 → memoryos-0.2.0}/src/memos/memories/parametric/base.py +0 -0
  104. {memoryos-0.1.12 → memoryos-0.2.0}/src/memos/memories/parametric/item.py +0 -0
  105. {memoryos-0.1.12 → memoryos-0.2.0}/src/memos/memories/parametric/lora.py +0 -0
  106. {memoryos-0.1.12 → memoryos-0.2.0}/src/memos/memories/textual/__init__.py +0 -0
  107. {memoryos-0.1.12 → memoryos-0.2.0}/src/memos/memories/textual/base.py +0 -0
  108. {memoryos-0.1.12 → memoryos-0.2.0}/src/memos/memories/textual/general.py +0 -0
  109. {memoryos-0.1.12 → memoryos-0.2.0}/src/memos/memories/textual/naive.py +0 -0
  110. {memoryos-0.1.12 → memoryos-0.2.0}/src/memos/memories/textual/tree_text_memory/__init__.py +0 -0
  111. {memoryos-0.1.12 → memoryos-0.2.0}/src/memos/memories/textual/tree_text_memory/organize/__init__.py +0 -0
  112. {memoryos-0.1.12 → memoryos-0.2.0}/src/memos/memories/textual/tree_text_memory/retrieve/__init__.py +0 -0
  113. {memoryos-0.1.12 → memoryos-0.2.0}/src/memos/memories/textual/tree_text_memory/retrieve/recall.py +0 -0
  114. {memoryos-0.1.12 → memoryos-0.2.0}/src/memos/memories/textual/tree_text_memory/retrieve/reranker.py +0 -0
  115. {memoryos-0.1.12 → memoryos-0.2.0}/src/memos/memories/textual/tree_text_memory/retrieve/retrieval_mid_structs.py +0 -0
  116. {memoryos-0.1.12 → memoryos-0.2.0}/src/memos/memories/textual/tree_text_memory/retrieve/utils.py +0 -0
  117. {memoryos-0.1.12 → memoryos-0.2.0}/src/memos/parsers/__init__.py +0 -0
  118. {memoryos-0.1.12 → memoryos-0.2.0}/src/memos/parsers/base.py +0 -0
  119. {memoryos-0.1.12 → memoryos-0.2.0}/src/memos/parsers/factory.py +0 -0
  120. {memoryos-0.1.12 → memoryos-0.2.0}/src/memos/parsers/markitdown.py +0 -0
  121. {memoryos-0.1.12 → memoryos-0.2.0}/src/memos/settings.py +0 -0
  122. {memoryos-0.1.12 → memoryos-0.2.0}/src/memos/templates/__init__.py +0 -0
  123. {memoryos-0.1.12 → memoryos-0.2.0}/src/memos/templates/mem_scheduler_prompts.py +0 -0
  124. {memoryos-0.1.12 → memoryos-0.2.0}/src/memos/types.py +0 -0
  125. {memoryos-0.1.12 → memoryos-0.2.0}/src/memos/vec_dbs/__init__.py +0 -0
  126. {memoryos-0.1.12 → memoryos-0.2.0}/src/memos/vec_dbs/base.py +0 -0
  127. {memoryos-0.1.12 → memoryos-0.2.0}/src/memos/vec_dbs/factory.py +0 -0
  128. {memoryos-0.1.12 → memoryos-0.2.0}/src/memos/vec_dbs/item.py +0 -0
  129. {memoryos-0.1.12 → memoryos-0.2.0}/src/memos/vec_dbs/qdrant.py +0 -0
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.3
2
2
  Name: MemoryOS
3
- Version: 0.1.12
3
+ Version: 0.2.0
4
4
  Summary: Intelligence Begins with Memory
5
5
  License: Apache-2.0
6
6
  Keywords: memory,llm,language model,memoryOS,agent
@@ -22,6 +22,7 @@ Requires-Dist: ollama (>=0.4.8,<0.5.0)
22
22
  Requires-Dist: openai (>=1.77.0,<2.0.0)
23
23
  Requires-Dist: qdrant-client (>=1.14.2,<2.0.0)
24
24
  Requires-Dist: redis (>=6.2.0,<7.0.0)
25
+ Requires-Dist: schedule (>=1.2.2,<2.0.0)
25
26
  Requires-Dist: sentence-transformers (>=4.1.0,<5.0.0)
26
27
  Requires-Dist: sqlalchemy (>=2.0.41,<3.0.0)
27
28
  Requires-Dist: tenacity (>=9.1.2,<10.0.0)
@@ -31,13 +32,11 @@ Description-Content-Type: text/markdown
31
32
 
32
33
  <div align="center">
33
34
  <a href="https://memos.openmem.net/">
34
- <img src="docs/assets/banner_new.gif" alt="MemOS Banner">
35
+ <img src="https://statics.memtensor.com.cn/memos/memos-banner.gif" alt="MemOS Banner">
35
36
  </a>
36
37
 
37
-
38
-
39
38
  <h1 align="center">
40
- <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"/>
39
+ <img src="https://statics.memtensor.com.cn/logo/memos_color_m.png" alt="MemOS Logo" width="50"/> MemOS 1.0: 星河 (Stellar) <img src="https://img.shields.io/badge/status-Preview-blue" alt="Preview Badge"/>
41
40
  </h1>
42
41
 
43
42
  <p>
@@ -50,11 +49,11 @@ Description-Content-Type: text/markdown
50
49
  <a href="https://pypi.org/project/MemoryOS">
51
50
  <img src="https://img.shields.io/pypi/pyversions/MemoryOS.svg" alt="Supported Python versions">
52
51
  </a>
53
- <a href="https://memos.openmem.net/docs/home">
52
+ <a href="https://memos-docs.openmem.net/home/overview/">
54
53
  <img src="https://img.shields.io/badge/Documentation-view-blue.svg" alt="Documentation">
55
54
  </a>
56
- <a href="https://arxiv.org/abs/2505.22101">
57
- <img src="https://img.shields.io/badge/arXiv-2505.22101-b31b1b.svg" alt="ArXiv Paper">
55
+ <a href="https://arxiv.org/abs/2507.03724">
56
+ <img src="https://img.shields.io/badge/arXiv-2507.03724-b31b1b.svg" alt="ArXiv Paper">
58
57
  </a>
59
58
  <a href="https://github.com/MemTensor/MemOS/discussions">
60
59
  <img src="https://img.shields.io/badge/GitHub-Discussions-181717.svg?logo=github" alt="GitHub Discussions">
@@ -62,7 +61,7 @@ Description-Content-Type: text/markdown
62
61
  <a href="https://discord.gg/Txbx3gebZR">
63
62
  <img src="https://img.shields.io/badge/Discord-join%20chat-7289DA.svg?logo=discord" alt="Discord">
64
63
  </a>
65
- <a href="docs/assets/memos-wechat-group.png">
64
+ <a href="https://statics.memtensor.com.cn/memos/qr-code.png">
66
65
  <img src="https://img.shields.io/badge/WeChat-Group-07C160.svg?logo=wechat" alt="WeChat Group">
67
66
  </a>
68
67
  <a href="https://opensource.org/license/apache-2-0/">
@@ -73,17 +72,14 @@ Description-Content-Type: text/markdown
73
72
 
74
73
  ---
75
74
 
76
- <a href="https://memos.openmem.net/">
77
- <img src="docs/assets/SOTA_Score.jpg" alt="SOTA SCORE">
78
- </a>
79
-
75
+ <img src="https://statics.memtensor.com.cn/memos/sota_score.jpg" alt="SOTA SCORE">
80
76
 
81
77
  **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.
82
78
 
83
- - **Website**: <a href="https://memos.openmem.net/" target="_blank">https://memos.openmem.net/</a>
84
- - **Documentation**: <a href="https://memos.openmem.net/docs/home" target="_blank">https://memos.openmem.net/docs/home</a>
85
- - **API Reference**: <a href="https://memos.openmem.net/docs/api/info" target="_blank">https://memos.openmem.net/docs/api/info</a>
86
- - **Source Code**: <a href="https://github.com/MemTensor/MemOS" target="_blank">https://github.com/MemTensor/MemOS</a>
79
+ - **Website**: https://memos.openmem.net/
80
+ - **Documentation**: https://memos-docs.openmem.net/home/overview/
81
+ - **API Reference**: https://memos-docs.openmem.net/docs/api/info/
82
+ - **Source Code**: https://github.com/MemTensor/MemOS
87
83
 
88
84
  ## 📈 Performance Benchmark
89
85
 
@@ -97,19 +93,12 @@ MemOS demonstrates significant improvements over baseline memory solutions in mu
97
93
 
98
94
  > 💡 **Temporal reasoning accuracy improved by 159% compared to the OpenAI baseline.**
99
95
 
100
-
101
-
102
96
  ### Details of End-to-End Evaluation on LOCOMO
103
97
 
104
98
  > [!NOTE]
105
99
  > 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.
106
100
 
107
- <a href="https://memos.openmem.net/">
108
- <img src="docs/assets/score_all_end2end.jpg" alt="END2END SCORE">
109
- </a>
110
-
111
-
112
-
101
+ <img src="https://statics.memtensor.com.cn/memos/score_all_end2end.jpg" alt="END2END SCORE">
113
102
 
114
103
  ## ✨ Key Features
115
104
 
@@ -182,7 +171,11 @@ For more detailed examples, please check out the [`examples`](./examples) direct
182
171
  ## 📦 Installation
183
172
 
184
173
  > [!WARNING]
185
- > Currently, MemOS primarily supports Linux platforms. You may encounter issues on Windows and macOS temporarily.
174
+ > MemOS is compatible with Linux, Windows, and macOS.
175
+ >
176
+ > However, if you're using macOS, please note that there may be dependency issues that are difficult to resolve.
177
+ >
178
+ > For example, compatibility with macOS 13 Ventura is currently challenging.
186
179
 
187
180
  ### Install via pip
188
181
 
@@ -223,24 +216,50 @@ Join our community to ask questions, share your projects, and connect with other
223
216
  - **Discord**: Join our <a href="https://discord.gg/Txbx3gebZR" target="_blank">Discord Server</a>.
224
217
  - **WeChat**: Scan the QR code to join our WeChat group.
225
218
 
226
- <img src="docs/assets/qr-code.png" alt="QR Code" width="600">
219
+ <img src="https://statics.memtensor.com.cn/memos/qr-code.png" alt="QR Code" width="600">
227
220
 
228
221
  ## 📜 Citation
229
222
 
230
- If you use MemOS in your research, please cite our paper:
223
+ > [!NOTE]
224
+ > 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.
225
+
226
+ If you use MemOS in your research, we would appreciate citations to our papers.
231
227
 
232
228
  ```bibtex
233
- @article{li2025memos,
229
+
230
+ @article{li2025memos_long,
231
+ title={MemOS: A Memory OS for AI System},
232
+ 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},
233
+ journal={arXiv preprint arXiv:2507.03724},
234
+ year={2025},
235
+ url={https://arxiv.org/abs/2507.03724}
236
+ }
237
+
238
+ @article{li2025memos_short,
234
239
  title={MemOS: An Operating System for Memory-Augmented Generation (MAG) in Large Language Models},
235
240
  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},
236
241
  journal={arXiv preprint arXiv:2505.22101},
237
- year={2025}
242
+ year={2025},
243
+ url={https://arxiv.org/abs/2505.22101}
244
+ }
245
+
246
+ @article{yang2024memory3,
247
+ 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},
248
+ title = {Memory$^3$: Language Modeling with Explicit Memory},
249
+ journal = {Journal of Machine Learning},
250
+ year = {2024},
251
+ volume = {3},
252
+ number = {3},
253
+ pages = {300--346},
254
+ issn = {2790-2048},
255
+ doi = {https://doi.org/10.4208/jml.240708},
256
+ url = {https://global-sci.com/article/91443/memory3-language-modeling-with-explicit-memory}
238
257
  }
239
258
  ```
240
259
 
241
260
  ## 🙌 Contributing
242
261
 
243
- We welcome contributions from the community! Please read our [contribution guidelines](./docs/contribution/overview.md) to get started.
262
+ We welcome contributions from the community! Please read our [contribution guidelines](https://memos-docs.openmem.net/contribution/overview) to get started.
244
263
 
245
264
  ## 📄 License
246
265
 
@@ -251,6 +270,7 @@ MemOS is licensed under the [Apache 2.0 License](./LICENSE).
251
270
  Stay up to date with the latest MemOS announcements, releases, and community highlights.
252
271
 
253
272
  - **2025-07-07** – 🎉 *MemOS 1.0 (Stellar) Preview Release*: A SOTA Memory OS for LLMs is now open-sourced.
273
+ - **2025-07-04** – 🎉 *MemOS Paper Released*: [MemOS: A Memory OS for AI System](https://arxiv.org/abs/2507.03724) was published on arXiv.
254
274
  - **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.
255
275
  - **2024-07-04** – 🎉 *Memory3 Model Released at WAIC 2024*: The new memory-layered architecture model was unveiled at the 2024 World Artificial Intelligence Conference.
256
276
  - **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.
@@ -1,12 +1,10 @@
1
1
  <div align="center">
2
2
  <a href="https://memos.openmem.net/">
3
- <img src="docs/assets/banner_new.gif" alt="MemOS Banner">
3
+ <img src="https://statics.memtensor.com.cn/memos/memos-banner.gif" alt="MemOS Banner">
4
4
  </a>
5
5
 
6
-
7
-
8
6
  <h1 align="center">
9
- <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"/>
7
+ <img src="https://statics.memtensor.com.cn/logo/memos_color_m.png" alt="MemOS Logo" width="50"/> MemOS 1.0: 星河 (Stellar) <img src="https://img.shields.io/badge/status-Preview-blue" alt="Preview Badge"/>
10
8
  </h1>
11
9
 
12
10
  <p>
@@ -19,11 +17,11 @@
19
17
  <a href="https://pypi.org/project/MemoryOS">
20
18
  <img src="https://img.shields.io/pypi/pyversions/MemoryOS.svg" alt="Supported Python versions">
21
19
  </a>
22
- <a href="https://memos.openmem.net/docs/home">
20
+ <a href="https://memos-docs.openmem.net/home/overview/">
23
21
  <img src="https://img.shields.io/badge/Documentation-view-blue.svg" alt="Documentation">
24
22
  </a>
25
- <a href="https://arxiv.org/abs/2505.22101">
26
- <img src="https://img.shields.io/badge/arXiv-2505.22101-b31b1b.svg" alt="ArXiv Paper">
23
+ <a href="https://arxiv.org/abs/2507.03724">
24
+ <img src="https://img.shields.io/badge/arXiv-2507.03724-b31b1b.svg" alt="ArXiv Paper">
27
25
  </a>
28
26
  <a href="https://github.com/MemTensor/MemOS/discussions">
29
27
  <img src="https://img.shields.io/badge/GitHub-Discussions-181717.svg?logo=github" alt="GitHub Discussions">
@@ -31,7 +29,7 @@
31
29
  <a href="https://discord.gg/Txbx3gebZR">
32
30
  <img src="https://img.shields.io/badge/Discord-join%20chat-7289DA.svg?logo=discord" alt="Discord">
33
31
  </a>
34
- <a href="docs/assets/memos-wechat-group.png">
32
+ <a href="https://statics.memtensor.com.cn/memos/qr-code.png">
35
33
  <img src="https://img.shields.io/badge/WeChat-Group-07C160.svg?logo=wechat" alt="WeChat Group">
36
34
  </a>
37
35
  <a href="https://opensource.org/license/apache-2-0/">
@@ -42,17 +40,14 @@
42
40
 
43
41
  ---
44
42
 
45
- <a href="https://memos.openmem.net/">
46
- <img src="docs/assets/SOTA_Score.jpg" alt="SOTA SCORE">
47
- </a>
48
-
43
+ <img src="https://statics.memtensor.com.cn/memos/sota_score.jpg" alt="SOTA SCORE">
49
44
 
50
45
  **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.
51
46
 
52
- - **Website**: <a href="https://memos.openmem.net/" target="_blank">https://memos.openmem.net/</a>
53
- - **Documentation**: <a href="https://memos.openmem.net/docs/home" target="_blank">https://memos.openmem.net/docs/home</a>
54
- - **API Reference**: <a href="https://memos.openmem.net/docs/api/info" target="_blank">https://memos.openmem.net/docs/api/info</a>
55
- - **Source Code**: <a href="https://github.com/MemTensor/MemOS" target="_blank">https://github.com/MemTensor/MemOS</a>
47
+ - **Website**: https://memos.openmem.net/
48
+ - **Documentation**: https://memos-docs.openmem.net/home/overview/
49
+ - **API Reference**: https://memos-docs.openmem.net/docs/api/info/
50
+ - **Source Code**: https://github.com/MemTensor/MemOS
56
51
 
57
52
  ## 📈 Performance Benchmark
58
53
 
@@ -66,19 +61,12 @@ MemOS demonstrates significant improvements over baseline memory solutions in mu
66
61
 
67
62
  > 💡 **Temporal reasoning accuracy improved by 159% compared to the OpenAI baseline.**
68
63
 
69
-
70
-
71
64
  ### Details of End-to-End Evaluation on LOCOMO
72
65
 
73
66
  > [!NOTE]
74
67
  > 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.
75
68
 
76
- <a href="https://memos.openmem.net/">
77
- <img src="docs/assets/score_all_end2end.jpg" alt="END2END SCORE">
78
- </a>
79
-
80
-
81
-
69
+ <img src="https://statics.memtensor.com.cn/memos/score_all_end2end.jpg" alt="END2END SCORE">
82
70
 
83
71
  ## ✨ Key Features
84
72
 
@@ -151,7 +139,11 @@ For more detailed examples, please check out the [`examples`](./examples) direct
151
139
  ## 📦 Installation
152
140
 
153
141
  > [!WARNING]
154
- > Currently, MemOS primarily supports Linux platforms. You may encounter issues on Windows and macOS temporarily.
142
+ > MemOS is compatible with Linux, Windows, and macOS.
143
+ >
144
+ > However, if you're using macOS, please note that there may be dependency issues that are difficult to resolve.
145
+ >
146
+ > For example, compatibility with macOS 13 Ventura is currently challenging.
155
147
 
156
148
  ### Install via pip
157
149
 
@@ -192,24 +184,50 @@ Join our community to ask questions, share your projects, and connect with other
192
184
  - **Discord**: Join our <a href="https://discord.gg/Txbx3gebZR" target="_blank">Discord Server</a>.
193
185
  - **WeChat**: Scan the QR code to join our WeChat group.
194
186
 
195
- <img src="docs/assets/qr-code.png" alt="QR Code" width="600">
187
+ <img src="https://statics.memtensor.com.cn/memos/qr-code.png" alt="QR Code" width="600">
196
188
 
197
189
  ## 📜 Citation
198
190
 
199
- If you use MemOS in your research, please cite our paper:
191
+ > [!NOTE]
192
+ > 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.
193
+
194
+ If you use MemOS in your research, we would appreciate citations to our papers.
200
195
 
201
196
  ```bibtex
202
- @article{li2025memos,
197
+
198
+ @article{li2025memos_long,
199
+ title={MemOS: A Memory OS for AI System},
200
+ 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},
201
+ journal={arXiv preprint arXiv:2507.03724},
202
+ year={2025},
203
+ url={https://arxiv.org/abs/2507.03724}
204
+ }
205
+
206
+ @article{li2025memos_short,
203
207
  title={MemOS: An Operating System for Memory-Augmented Generation (MAG) in Large Language Models},
204
208
  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},
205
209
  journal={arXiv preprint arXiv:2505.22101},
206
- year={2025}
210
+ year={2025},
211
+ url={https://arxiv.org/abs/2505.22101}
212
+ }
213
+
214
+ @article{yang2024memory3,
215
+ 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},
216
+ title = {Memory$^3$: Language Modeling with Explicit Memory},
217
+ journal = {Journal of Machine Learning},
218
+ year = {2024},
219
+ volume = {3},
220
+ number = {3},
221
+ pages = {300--346},
222
+ issn = {2790-2048},
223
+ doi = {https://doi.org/10.4208/jml.240708},
224
+ url = {https://global-sci.com/article/91443/memory3-language-modeling-with-explicit-memory}
207
225
  }
208
226
  ```
209
227
 
210
228
  ## 🙌 Contributing
211
229
 
212
- We welcome contributions from the community! Please read our [contribution guidelines](./docs/contribution/overview.md) to get started.
230
+ We welcome contributions from the community! Please read our [contribution guidelines](https://memos-docs.openmem.net/contribution/overview) to get started.
213
231
 
214
232
  ## 📄 License
215
233
 
@@ -220,6 +238,7 @@ MemOS is licensed under the [Apache 2.0 License](./LICENSE).
220
238
  Stay up to date with the latest MemOS announcements, releases, and community highlights.
221
239
 
222
240
  - **2025-07-07** – 🎉 *MemOS 1.0 (Stellar) Preview Release*: A SOTA Memory OS for LLMs is now open-sourced.
241
+ - **2025-07-04** – 🎉 *MemOS Paper Released*: [MemOS: A Memory OS for AI System](https://arxiv.org/abs/2507.03724) was published on arXiv.
223
242
  - **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.
224
243
  - **2024-07-04** – 🎉 *Memory3 Model Released at WAIC 2024*: The new memory-layered architecture model was unveiled at the 2024 World Artificial Intelligence Conference.
225
244
  - **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.
@@ -2,7 +2,7 @@
2
2
 
3
3
  [tool.poetry]
4
4
  name = "MemoryOS"
5
- version = "0.1.12"
5
+ version = "0.2.0"
6
6
  description = "Intelligence Begins with Memory"
7
7
  license = "Apache-2.0"
8
8
  authors = ["MemTensor <lizy@memtensor.cn>"]
@@ -26,6 +26,7 @@ fastapi = {extras = ["all"], version = "^0.115.12"}
26
26
  sentence-transformers = "^4.1.0"
27
27
  sqlalchemy = "^2.0.41"
28
28
  redis = "^6.2.0"
29
+ schedule = "^1.2.2"
29
30
 
30
31
  [tool.poetry.group.dev]
31
32
  optional = false
@@ -51,6 +52,10 @@ zep-cloud = "^2.15.0"
51
52
  rouge-score = "^0.1.2"
52
53
  nltk = "^3.9.1"
53
54
  bert-score = "^0.3.13"
55
+ scipy = "^1.10.1"
56
+ python-dotenv = "^1.1.1"
57
+ langgraph = "^0.5.1"
58
+ langmem = "^0.0.27"
54
59
 
55
60
  [[tool.poetry.source]]
56
61
  name = "mirrors"
@@ -1,4 +1,4 @@
1
- __version__ = "0.1.12"
1
+ __version__ = "0.2.0"
2
2
 
3
3
  from memos.configs.mem_cube import GeneralMemCubeConfig
4
4
  from memos.configs.mem_os import MOSConfig
@@ -0,0 +1,81 @@
1
+ """Configuration classes for internet retrievers."""
2
+
3
+ from typing import Any, ClassVar
4
+
5
+ from pydantic import Field, field_validator, model_validator
6
+
7
+ from memos.configs.base import BaseConfig
8
+ from memos.exceptions import ConfigurationError
9
+
10
+
11
+ class BaseInternetRetrieverConfig(BaseConfig):
12
+ """Base configuration class for internet retrievers."""
13
+
14
+ api_key: str = Field(..., description="API key for the search service")
15
+ search_engine_id: str | None = Field(
16
+ None, description="Search engine ID (required for Google Custom Search)"
17
+ )
18
+
19
+
20
+ class GoogleCustomSearchConfig(BaseInternetRetrieverConfig):
21
+ """Configuration class for Google Custom Search API."""
22
+
23
+ search_engine_id: str = Field(..., description="Google Custom Search Engine ID (cx parameter)")
24
+ max_results: int = Field(default=20, description="Maximum number of results to retrieve")
25
+ num_per_request: int = Field(
26
+ default=10, description="Number of results per API request (max 10 for Google)"
27
+ )
28
+
29
+
30
+ class BingSearchConfig(BaseInternetRetrieverConfig):
31
+ """Configuration class for Bing Search API."""
32
+
33
+ endpoint: str = Field(
34
+ default="https://api.bing.microsoft.com/v7.0/search", description="Bing Search API endpoint"
35
+ )
36
+ max_results: int = Field(default=20, description="Maximum number of results to retrieve")
37
+ num_per_request: int = Field(default=10, description="Number of results per API request")
38
+
39
+
40
+ class XinyuSearchConfig(BaseInternetRetrieverConfig):
41
+ """Configuration class for Xinyu Search API."""
42
+
43
+ search_engine_id: str | None = Field(
44
+ None, description="Not used for Xinyu Search (kept for compatibility)"
45
+ )
46
+ max_results: int = Field(default=20, description="Maximum number of results to retrieve")
47
+ num_per_request: int = Field(
48
+ default=10, description="Number of results per API request (not used for Xinyu)"
49
+ )
50
+
51
+
52
+ class InternetRetrieverConfigFactory(BaseConfig):
53
+ """Factory class for creating internet retriever configurations."""
54
+
55
+ backend: str | None = Field(
56
+ None, description="Backend for internet retriever (google, bing, etc.)"
57
+ )
58
+ config: dict[str, Any] | None = Field(
59
+ None, description="Configuration for the internet retriever backend"
60
+ )
61
+
62
+ backend_to_class: ClassVar[dict[str, Any]] = {
63
+ "google": GoogleCustomSearchConfig,
64
+ "bing": BingSearchConfig,
65
+ "xinyu": XinyuSearchConfig,
66
+ }
67
+
68
+ @field_validator("backend")
69
+ @classmethod
70
+ def validate_backend(cls, backend: str | None) -> str | None:
71
+ """Validate the backend field."""
72
+ if backend is not None and backend not in cls.backend_to_class:
73
+ raise ConfigurationError(f"Invalid internet retriever backend: {backend}")
74
+ return backend
75
+
76
+ @model_validator(mode="after")
77
+ def create_config(self) -> "InternetRetrieverConfigFactory":
78
+ if self.backend is not None:
79
+ config_class = self.backend_to_class[self.backend]
80
+ self.config = config_class(**self.config)
81
+ return self
@@ -24,6 +24,7 @@ class OpenAILLMConfig(BaseLLMConfig):
24
24
  api_base: str = Field(
25
25
  default="https://api.openai.com/v1", description="Base URL for OpenAI API"
26
26
  )
27
+ extra_body: Any = Field(default=None, description="extra body")
27
28
 
28
29
 
29
30
  class OllamaLLMConfig(BaseLLMConfig):
@@ -57,6 +57,10 @@ class MOSConfig(BaseConfig):
57
57
  default=False,
58
58
  description="Enable memory scheduler for automated memory management",
59
59
  )
60
+ PRO_MODE: bool = Field(
61
+ default=False,
62
+ description="Enable PRO mode for complex query decomposition",
63
+ )
60
64
 
61
65
 
62
66
  class MemOSConfigFactory(BaseConfig):
@@ -22,6 +22,10 @@ class BaseMemReaderConfig(BaseConfig):
22
22
  chunker: ChunkerConfigFactory = Field(
23
23
  ..., description="Chunker configuration for the MemReader"
24
24
  )
25
+ remove_prompt_example: bool = Field(
26
+ default=False,
27
+ description="whether remove example in memory extraction prompt to save token",
28
+ )
25
29
 
26
30
 
27
31
  class SimpleStructMemReaderConfig(BaseMemReaderConfig):
@@ -5,6 +5,7 @@ from pydantic import Field, field_validator, model_validator
5
5
  from memos.configs.base import BaseConfig
6
6
  from memos.configs.embedder import EmbedderConfigFactory
7
7
  from memos.configs.graph_db import GraphDBConfigFactory
8
+ from memos.configs.internet_retriever import InternetRetrieverConfigFactory
8
9
  from memos.configs.llm import LLMConfigFactory
9
10
  from memos.configs.vec_db import VectorDBConfigFactory
10
11
  from memos.exceptions import ConfigurationError
@@ -133,7 +134,7 @@ class GeneralTextMemoryConfig(BaseTextMemoryConfig):
133
134
 
134
135
 
135
136
  class TreeTextMemoryConfig(BaseTextMemoryConfig):
136
- """General memory configuration class."""
137
+ """Tree text memory configuration class."""
137
138
 
138
139
  extractor_llm: LLMConfigFactory = Field(
139
140
  ...,
@@ -155,6 +156,15 @@ class TreeTextMemoryConfig(BaseTextMemoryConfig):
155
156
  default_factory=GraphDBConfigFactory,
156
157
  description="Graph database configuration for the tree-memory storage",
157
158
  )
159
+ internet_retriever: InternetRetrieverConfigFactory | None = Field(
160
+ None,
161
+ description="Internet retriever configuration (optional)",
162
+ )
163
+
164
+ reorganize: bool | None = Field(
165
+ False,
166
+ description="Optional description for this memory configuration.",
167
+ )
158
168
 
159
169
 
160
170
  # ─── 3. Global Memory Config Factory ──────────────────────────────────────────
@@ -0,0 +1,46 @@
1
+ import uuid
2
+
3
+ from typing import Any, Literal
4
+
5
+ from pydantic import BaseModel, ConfigDict, Field, field_validator
6
+
7
+ from memos.memories.textual.item import TextualMemoryItem
8
+
9
+
10
+ class GraphDBNode(TextualMemoryItem):
11
+ pass
12
+
13
+
14
+ class GraphDBEdge(BaseModel):
15
+ """Represents an edge in a graph database (corresponds to Neo4j relationship)."""
16
+
17
+ id: str = Field(
18
+ default_factory=lambda: str(uuid.uuid4()), description="Unique identifier for the edge"
19
+ )
20
+ source: str = Field(..., description="Source node ID")
21
+ target: str = Field(..., description="Target node ID")
22
+ type: Literal["RELATED", "PARENT"] = Field(
23
+ ..., description="Relationship type (must be one of 'RELATED', 'PARENT')"
24
+ )
25
+ properties: dict[str, Any] | None = Field(
26
+ default=None, description="Additional properties for the edge"
27
+ )
28
+
29
+ model_config = ConfigDict(extra="forbid")
30
+
31
+ @field_validator("id")
32
+ @classmethod
33
+ def validate_id(cls, v):
34
+ """Validate that ID is a valid UUID."""
35
+ if not isinstance(v, str) or not uuid.UUID(v, version=4):
36
+ raise ValueError("ID must be a valid UUID string")
37
+ return v
38
+
39
+ @classmethod
40
+ def from_dict(cls, data: dict[str, Any]) -> "GraphDBEdge":
41
+ """Create GraphDBEdge from dictionary."""
42
+ return cls(**data)
43
+
44
+ def to_dict(self) -> dict[str, Any]:
45
+ """Convert to dictionary format."""
46
+ return self.model_dump(exclude_none=True)