# memos-server

**Repository Path**: yuclaw/memos-server

## Basic Information

- **Project Name**: memos-server
- **Description**: MemOS Server - AI Agent 记忆操作系统服务端 (nanobot 适配版)
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2026-03-13
- **Last Updated**: 2026-03-14

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# MemOS Server

AI Agent 记忆操作系统服务端 - nanobot 适配版

## 功能特性

### 核心模块

- **存储层 (Storage)** - SQLite + FTS5 全文搜索 + 向量存储
- **嵌入层 (Embedding)** - 多提供商支持 (OpenAI/Gemini/Cohere/Voyage/Mistral/本地)
- **摄入层 (Ingest)** - 消息摄入 + 摘要生成
- **召回层 (Recall)** - 混合检索 (FTS + 向量 + MMR) + RRF 融合

### 高级功能

- **任务处理层 (Task)** - 任务边界检测 + 摘要生成
- **技能进化层 (Skill)** - 自动评估 + 技能生成 + 技能升级

## 技术栈

- Node.js >= 18.0.0
- TypeScript
- better-sqlite3 (SQLite + FTS5)
- @huggingface/transformers (本地嵌入)

## 安装

```bash
npm install
npm run build
```

## 配置

创建 `.env` 文件:

```env
# 服务端口
PORT=9527

# 嵌入配置 (可选，默认使用本地模型)
EMBEDDING_PROVIDER=local
# EMBEDDING_PROVIDER=openai
# OPENAI_API_KEY=sk-xxx

# 数据库路径
DB_PATH=./data/memos.db
```

## 运行

```bash
npm start
```

## API 端点

- `GET /health` - 健康检查
- `POST /ingest` - 消息摄入
- `POST /recall` - 记忆召回
- `GET /tasks` - 任务列表
- `GET /skills` - 技能列表

## 架构

```
src/
├── core/
│   ├── types.ts          # 类型定义
│   ├── storage/          # 存储层
│   ├── embedding/        # 嵌入层
│   ├── ingest/           # 摄入层
│   ├── recall/           # 召回层
│   ├── task/             # 任务处理层
│   └── skill/             # 技能进化层
└── index.ts              # 入口
```

## 许可证

MIT