Filesystem As Remote Memory - Agent memory storage system
Project description
FARM - Filesystem As Remote Memory
为 AI Agent 设计的持久化记忆系统。让 Agent 能够跨会话记住重要信息，并通过语义搜索快速检索。
核心功能
- 记忆存储: 保存对话摘要、用户偏好、学习到的知识
- 多模式搜索: 支持语义搜索、全文搜索、混合搜索
- 多接口: MCP Server (Claude)、REST API、CLI
技术栈
- 向量搜索: DuckDB + VSS 扩展 (HNSW 索引)
- Embedding:
BAAI/bge-small-zh-v1.5(中文优化) - 全文搜索: 关键词匹配
快速开始
# 安装
pip install farm-memory
# 或
uv add farm-memory
# 初始化存储
farm init
# 添加记忆
farm add "用户偏好 Vue 框架" --tag preference
# 搜索记忆
farm search "前端框架" --mode semantic
farm search "Vue" --mode text
farm search "前端" --mode hybrid
# 启动 API 服务
farm serve
Claude 集成
添加到 Claude 配置 (~/.claude.json):
{
"mcpServers": {
"farm": {
"command": "uvx",
"args": ["farm-memory", "mcp"]
}
}
}
文档
License
MIT
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file farm_memory-0.1.2.tar.gz.
File metadata
- Download URL: farm_memory-0.1.2.tar.gz
- Upload date:
- Size: 177.6 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.7
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
c267e8cc20c180154f0a6f16bc75ce27a33d32c316da2895c70fa1ae2ff48eed
|
|
| MD5 |
6c9820d692d54863eff806aab158eea7
|
|
| BLAKE2b-256 |
32e177b1c43ee0dac1f485b3bfee1f8db4b73b117369bf8135c4a0caf47ccae8
|
Provenance
The following attestation bundles were made for farm_memory-0.1.2.tar.gz:
Publisher:
release.yml on mmga-lab/farm
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
farm_memory-0.1.2.tar.gz -
Subject digest:
c267e8cc20c180154f0a6f16bc75ce27a33d32c316da2895c70fa1ae2ff48eed - Sigstore transparency entry: 832764830
- Sigstore integration time:
-
Permalink:
mmga-lab/farm@f7f11f984d3b7f022cf643fe232bb59fed7da42a -
Branch / Tag:
refs/tags/v0.1.2 - Owner: https://github.com/mmga-lab
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@f7f11f984d3b7f022cf643fe232bb59fed7da42a -
Trigger Event:
push
-
Statement type:
File details
Details for the file farm_memory-0.1.2-py3-none-any.whl.
File metadata
- Download URL: farm_memory-0.1.2-py3-none-any.whl
- Upload date:
- Size: 17.1 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.7
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
468ca98a36a62b206fba629275396c56c463eb770b369dea30e40ade8c273411
|
|
| MD5 |
2f09e59a348eaab5cf59175647f4ab07
|
|
| BLAKE2b-256 |
4dd80d57d4b6a56838b782ca38d5345328f8f83c446d70615c9d07b03aeccf5b
|
Provenance
The following attestation bundles were made for farm_memory-0.1.2-py3-none-any.whl:
Publisher:
release.yml on mmga-lab/farm
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
farm_memory-0.1.2-py3-none-any.whl -
Subject digest:
468ca98a36a62b206fba629275396c56c463eb770b369dea30e40ade8c273411 - Sigstore transparency entry: 832764831
- Sigstore integration time:
-
Permalink:
mmga-lab/farm@f7f11f984d3b7f022cf643fe232bb59fed7da42a -
Branch / Tag:
refs/tags/v0.1.2 - Owner: https://github.com/mmga-lab
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@f7f11f984d3b7f022cf643fe232bb59fed7da42a -
Trigger Event:
push
-
Statement type:
