chore: bump version to v0.1.13 (#48)

- Project Management:

Added issue templates and updated pull request template for better
contribution workflow
Enhanced PR template for clarity and completeness

- 📖 Documentation & Research:
     Published long version of MemOS paper
     Updated citations and references

Migrated all documentation to dedicated MemOS-Docs repository
Improved documentation structure and accessibility

- 🧪 Evaluation & Testing:

Added evaluation configuration examples
Implemented run locomo eval script for performance testing
Fixed redundant memory search branches in evaluation system

- 🔧 Features & Functionality:

Added internet retrieval capabilities to MemOS
Implemented Chain-of-Thought (CoT) functionality
Fixed ParsedTaskGoal usage in examples
Added unrelated memory filtering functionality

Author: fridayL

.github/CONTRIBUTING

@@ -0,0 +1,3 @@
+Please read https://memos.openmem.net/docs/contribution/overview to learn how to contribute to this repository. 🌟
+
+请阅读 https://memos.openmem.net/docs/contribution/overview 了解如何为此项目贡献代码。🌟

.github/ISSUE_TEMPLATE/bug-report.yml

@@ -0,0 +1,38 @@
+name: "\U0001F41B Bug / help"
+description: Create a report to help us improve MemOS
+labels: ["bug", "pending"]
+body:
+
+  - type: textarea
+    id: system-info
+    validations:
+      required: true
+    attributes:
+      label: System Info
+      description: |
+        Please share your system info with us. You can run the command **pip show MemoryOS** and copy-paste its output below.
+        请提供您的系统信息。您可以在命令行运行 **pip show MemoryOS** 并将其输出复制到该文本框中。
+
+      placeholder: MemoryOS version, platform, python version, ...
+
+  - type: textarea
+    id: reproduction
+    validations:
+      required: true
+    attributes:
+      label: Reproduction
+      description: |
+        Please provide entry arguments, error messages and stack traces that reproduces the problem.
+        请提供入口参数，错误日志以及异常堆栈以便于我们复现问题。
+
+      value: |
+        ```text
+        Put your message here.
+        ```
+
+  - type: textarea
+    id: others
+    validations:
+      required: false
+    attributes:
+      label: Others

.github/ISSUE_TEMPLATE/feature-request.yml

@@ -0,0 +1,41 @@
+name: "\U0001F680 Feature request"
+description: Submit a request for a new feature
+labels: ["enhancement", "pending"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Please do not create issues that are not related to new features under this category.
+        请勿在此分类下创建和新特性无关的 issues。
+
+  - type: checkboxes
+    id: reminder
+    attributes:
+      label: Reminder
+      description: |
+        Please ensure you have read the above rules carefully and searched the existing issues.
+        请确保您已经认真阅读了上述规则并且搜索过现有的 issues。
+
+      options:
+        - label: I have read the above rules and searched the existing issues.
+          required: true
+
+  - type: textarea
+    id: description
+    validations:
+      required: true
+    attributes:
+      label: Description
+      description: |
+        A clear and concise description of the feature proposal.
+        请详细描述您希望加入的新功能特性。
+
+  - type: textarea
+    id: contribution
+    validations:
+      required: false
+    attributes:
+      label: Pull Request
+      description: |
+        Have you already created the relevant PR and submitted the code?
+        您是否已经创建了相关 PR 并提交了代码？

.github/PULL_REQUEST_TEMPLATE.md

@@ -1,39 +1,28 @@
 ## Description
 
-Please include a summary of the change and which issue is fixed. Please also include relevant motivation and context. List any dependencies that are required for this change.
+<!--
+Please include a summary of the changes below;
+Fill in the issue number that this PR addresses (if applicable);
+Mention the person who will review this PR (if you know who it is);
+Replace (summary), (issue), and (reviewer) with the appropriate information (No parentheses).
 
-Fixes # (issue)
+请在下方填写更改的摘要；
+填写此 PR 解决的问题编号（如果适用）；
+提及将审查此 PR 的人（如果您知道是谁）；
+替换 (summary)、(issue) 和 (reviewer) 为适当的信息（不带括号）。
+-->
 
-## Type of change
+Summary: (summary)
 
-Please delete options that are not relevant.
+Fix: #(issue)
 
-- [ ] Bug fix (non-breaking change which fixes an issue)
-- [ ] New feature (non-breaking change which adds functionality)
-- [ ] Breaking change (fix or feature that would cause existing functionality to not work as expected)
-- [ ] Refactor (does not change functionality, e.g. code style improvements, linting)
-- [ ] Documentation update
-
-## How Has This Been Tested?
-
-Please describe the tests that you ran to verify your changes. Provide instructions so we can reproduce. Please also list any relevant details for your test configuration
-
-Please delete options that are not relevant.
-
-- [ ] Unit Test
-- [ ] Test Script (please provide)
+Reviewer: @(reviewer)
 
 ## Checklist:
 
-- [ ] My code follows the style guidelines of this project
-- [ ] I have performed a self-review of my own code
-- [ ] I have commented my code, particularly in hard-to-understand areas
-- [ ] My changes generate no new warnings
-- [ ] I have added tests that prove my fix is effective or that my feature works
-- [ ] New and existing unit tests pass locally with my changes
-- [ ] I have checked my code and corrected any misspellings
-
-## Maintainer Checklist
-
-- [ ] closes #xxxx (Replace xxxx with the GitHub issue number)
-- [ ] Made sure Checks passed
+- [ ] I have performed a self-review of my own code | 我已自行检查了自己的代码
+- [ ] I have commented my code in hard-to-understand areas | 我已在难以理解的地方对代码进行了注释
+- [ ] I have added tests that prove my fix is effective or that my feature works | 我已添加测试以证明我的修复有效或功能正常
+- [ ] I have added necessary documentation (if applicable) | 我已添加必要的文档（如果适用）
+- [ ] I have linked the issue to this PR (if applicable) | 我已将 issue 链接到此 PR（如果适用）
+- [ ] I have mentioned the person who will review this PR | 我已提及将审查此 PR 的人

.github/workflows/python-tests.yml

@@ -3,6 +3,9 @@
 
 name: Python tests
 
+permissions:
+  contents: read
+
 on:
   push:
     branches:
@@ -22,6 +25,10 @@ jobs:
       matrix:
         os:
           - "ubuntu-latest"
+          - "windows-latest"
+          - "macos-14"
+          - "macos-15"
+          # Ref: https://docs.github.com/en/actions/how-tos/writing-workflows/choosing-where-your-workflow-runs/choosing-the-runner-for-a-job
         python-version:
           - "3.10"
           - "3.11"
@@ -48,4 +55,4 @@ jobs:
         poetry run ruff format --check
     - name: Test with pytest
       run: |
-        PYTHONPATH=src poetry run pytest tests -vv
+        poetry run pytest tests -vv

.gitignore

@@ -10,7 +10,6 @@ evaluation/data/langmemeval
 evaluation/*tmp/
 evaluation/results
 evaluation/.env
-evaluation/scripts/*.sh
 evaluation/configs/*
 .env
 

Makefile

@@ -1,4 +1,4 @@
-.PHONY: test docs
+.PHONY: test
 
 install:
 	poetry install --with dev --with test
@@ -11,7 +11,7 @@ clean:
 	rm -rf tmp
 
 test:
-	PYTHONPATH=src poetry run pytest tests
+	poetry run pytest tests
 
 format:
 	poetry run ruff check --fix
@@ -23,24 +23,5 @@ pre_commit:
 serve:
 	poetry run uvicorn memos.api.start_api:app
 
-docs:
-	pytest tests/test_docs.py -xq
-	pip install mkdocs mkdocs-material -q
-	mkdir -p tmp
-	rm -f tmp/mkdocs.yml
-	echo "site_name: MemOS Documentation" > tmp/mkdocs.yml
-	echo "docs_dir: `pwd`/docs" >> tmp/mkdocs.yml
-	echo "theme: material" >> tmp/mkdocs.yml
-	echo "markdown_extensions:" >> tmp/mkdocs.yml
-	echo "  - pymdownx.highlight:" >> tmp/mkdocs.yml
-	echo "      anchor_linenums: true" >> tmp/mkdocs.yml
-	echo "      line_spans: __span" >> tmp/mkdocs.yml
-	echo "      pygments_lang_class: true" >> tmp/mkdocs.yml
-	echo "  - pymdownx.inlinehilite" >> tmp/mkdocs.yml
-	echo "  - pymdownx.snippets" >> tmp/mkdocs.yml
-	echo "  - pymdownx.superfences" >> tmp/mkdocs.yml
-	cat docs/settings.yml >> tmp/mkdocs.yml
-	mkdocs serve -f tmp/mkdocs.yml --no-livereload
-
 openapi:
 	poetry run python scripts/export_openapi.py --output docs/openapi.json

README.md

@@ -22,16 +22,16 @@
     <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/2505.22101">
-        <img src="https://img.shields.io/badge/arXiv-2505.22101-b31b1b.svg" alt="ArXiv Paper">
+    <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/memos-wechat-group.png">
+    <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/">
@@ -43,7 +43,7 @@
 ---
 
   <a href="https://memos.openmem.net/">
-    <img src="docs/assets/SOTA_Score.jpg" alt="SOTA SCORE">
+    <img src="docs/assets/sota_score.jpg" alt="SOTA SCORE">
   </a>
 
 
@@ -151,7 +151,11 @@ For more detailed examples, please check out the [`examples`](./examples) direct
 ## 📦 Installation
 
 > [!WARNING]
-> Currently, MemOS primarily supports Linux platforms. You may encounter issues on Windows and macOS temporarily.
+> 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
 
@@ -192,24 +196,50 @@ Join our community to ask questions, share your projects, and connect with other
 - **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">
+<img src="docs/assets/qr_code.png" alt="QR Code" width="600">
 
 ## 📜 Citation
 
-If you use MemOS in your research, please cite our paper:
+> [!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,
+
+@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}
+  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](./docs/contribution/overview.md) to get started.
+We welcome contributions from the community! Please read our [contribution guidelines](https://memos.openmem.net/docs/contribution/overview) to get started.
 
 ## 📄 License
 
@@ -220,6 +250,7 @@ MemOS is licensed under the [Apache 2.0 License](./LICENSE).
 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.

docs/README.md

@@ -0,0 +1,3 @@
+All documentation has been moved to a separate repository: https://github.com/MemTensor/MemOS-Docs. Please edit documentation there.
+
+所有文档已迁移至独立仓库：https://github.com/MemTensor/MemOS-Docs。请在该仓库中编辑文档。