rushdb/platform

---

镜像概述

RushDB是一款为AI代理和应用设计的内存层工具，替代传统AI内存栈中需分别使用键值存储、向量数据库和图关系系统的复杂方案，通过单一API提供托管嵌入、图遍历+语义搜索一体等核心能力。

---

核心功能

• 托管嵌入：集成嵌入模型支持
• 图与语义搜索融合：单查询实现图关系遍历与语义检索
• 零Schema JSON摄入：直接处理非结构化JSON数据，无需预定义模式
• ACID安全写入：基于Neo4j确保数据一致性

---

使用场景

1. AI代理记忆管理：存储/检索对话上下文与历史信息
2. 语义搜索系统：构建基于向量的智能检索应用
3. 知识图谱构建：自动生成数据间的图关系网络
4. 无模式数据存储：快速处理半结构化JSON数据

---

配置说明

核心环境变量

---

Docker部署示例

快速启动（Docker Run）

bash
docker run -d \
  --name rushdb \
  -p 3000:3000 \
  -e NEO4J_URL='neo4j+s://your-instance.databases.neo4j.io' \
  -e NEO4J_USERNAME='neo4j' \
  -e NEO4J_PASSWORD='password' \
  -e RUSHDB_AES_256_ENCRYPTION_KEY='替换为32字符密钥' \
  -e RUSHDB_LOGIN='admin' \
  -e RUSHDB_PASSWORD='强密码' \
  docker.xuanyuan.run/rushdb/platform

访问地址：http://localhost:3000

Docker Compose配置

yaml
version: '3.8'
services:
  rushdb:
    image: docker.xuanyuan.run/rushdb/platform:latest
    container_name: rushdb
    ports:
      - '3000:3000'
    environment:
      - NEO4J_URL=neo4j+s://your-instance.databases.neo4j.io
      - NEO4J_USERNAME=neo4j
      - NEO4J_PASSWORD=password
      - RUSHDB_AES_256_ENCRYPTION_KEY=替换为32字符密钥
      - RUSHDB_LOGIN=admin
      - RUSHDB_PASSWORD=强密码

---

容器内CLI操作

管理自托管用户：

bash
rushdb create-user admin@example.com 安全密码123
rushdb update-password admin@example.com 新安全密码456

---

SDK示例

TypeScript

bash
npm install @rushdb/javascript-sdk

typescript
import RushDB from '@rushdb/javascript-sdk'
const db = new RushDB('RUSHDB_API_KEY', { url: 'http://localhost:3000' })
await db.records.create({
  label: 'MEMORY',
  data: { agent_id: 'agent-42', topic: 'Q4规划', output: '决策摘要' }
})

Python

bash
pip install rushdb

python
from docker.xuanyuan.run/rushdb import RushDB
db = RushDB('RUSHDB_API_KEY', base_url='http://localhost:3000')
result = db.records.create(label='MEMORY', data={
    'agent_id': 'agent-42', 'topic': 'Q4规划', 'output': '决策摘要'
})

---

更多信息

• 文档：[***]
• 自托管指南：[***]
• 主仓库：https://github.com/rush-db/rushdb
• 问题反馈：https://github.com/rush-db/rushdb/issues