Metadata-Version: 2.4
Name: aidumei
Version: 18.2.0
Summary: aiduMEM: self-hosted multi-tier memory for Hermes Agent — native MemoryProvider bridge, CoreMemory, FTS5 & Qdrant recall
Author-email: "Jack & Dudu (aiduHER)" <iamjw9@gmail.com>
License: MIT
Project-URL: Homepage, https://github.com/monkey2jack/aiduMEM
Project-URL: Documentation, https://github.com/monkey2jack/aiduMEM#readme
Project-URL: Repository, https://github.com/monkey2jack/aiduMEM.git
Keywords: memory,mem0,hermes,hermes-agent,aiduMEM,ai,rag,qdrant,fts5,memory-provider
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT 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: Topic :: Scientific/Engineering :: Artificial Intelligence
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: mem0ai>=2.0.17
Requires-Dist: fastapi>=0.100.0
Requires-Dist: uvicorn>=0.20.0
Requires-Dist: pydantic>=2.0.0
Requires-Dist: qdrant-client>=1.7.0
Requires-Dist: requests>=2.28.0
Dynamic: license-file

# aiduMEI_dudu — aidumei.hycoforce.com 自部署源

aiduMEI 记忆系统在 **aidumei.hycoforce.com** 的私有部署仓库。

> **定位说明**：开源源是 [`monkey2jack/aiduMEI`](https://github.com/monkey2jack/aiduMEI)（供全世界使用）；
> 本仓库是**我们自己部署实例的完整私有源**（后端 + 前端 + 部署配置）——
> 相当于某个网友给自己的 Hermes 部署了 aiduMEI 记忆系统，部署实例与开源源互相独立，互不污染。

## 结构

```
ducky/  api_server.py  ...    # 后端代码（从开源源同步的部署副本）
frontend/                      # 前端（线上 /ui 使用的部署副本）
deploy/
  nginx-aidumei.hycoforce.com.conf   # 杭州 nginx 反代配置（443 + certbot）
  dudu-mem0-api.service.example      # systemd 服务参考（密码占位符，不入库）
```

敏感内容一律不入库：`data/`、`logs/`、`venv/`、`.sf_key`、`.llm_key`、
`mem0_config_local.json`（见 `.gitignore`）。登录密码只存在于杭州 systemd 环境变量。

## 部署拓扑

```
https://aidumei.hycoforce.com
        │  Cloudflare（proxied，边缘 TLS）
        ▼
   杭州 nginx :443（certbot Let's Encrypt 证书）
        ▼
   127.0.0.1:8767  ← 后端 api_server.py（自带 /ui 静态托管 + /api）
```

## 更新流程（铁律：部署先行，验证后再开源）

**流程方向：私有仓先行 → 杭州验证 → 回开源仓。禁止直接往开源仓推新改动。**

### 1. 改动先进私有仓
在本地工作台（或开源仓克隆）完成代码修改后，将改动同步到本仓库：
```bash
cd <本仓库工作台>
# 从开发目录同步 tracked 文件到本仓（.gitignore 内容自动排除）
git add -A
git commit -m "feat/fix: ..."
git push origin main
```

### 2. 杭州拉取验证
```bash
cd /root/dudu-mem0
git pull origin main
systemctl restart dudu-mem0-api
# 验证 health / UI / 关键功能后，再进入下一步
```

### 3. 验证通过后回开源仓
把同一批改动（文件级）同步回 `monkey2jack/aiduMEI` 并 push：
```bash
cd <开源源工作台>
# 从私有仓复制改动文件覆盖到开源仓工作目录
git add -A
git commit -m "feat/fix: ...（同私有仓已验证 commit）"
git push origin main
```

### 红线
- `deploy/`、部署专用本地化改动 **只进私有仓**，开源仓保持纯净
- 部署敏感内容（密码/密钥/配置/数据）一律不入任何仓库
- 开源仓永远只接收"已在 aidumei.hycoforce.com 验证通过"的改动
