Epitome

Epitome

Một lớp bộ nhớ, mọi tác nhân AI.

Lớp nhận dạng di động cung cấp cho mọi tác nhân AI một bộ nhớ chung, bền vững về bạn.
Mã nguồn mở. Có thể tự lưu trữ. Của bạn.

Trang web · Bắt đầu nhanh · Kết nối Tác nhân · Tài liệu · Đóng góp

---

Vấn đề

Mọi cuộc trò chuyện AI đều bắt đầu từ con số không. Bạn lặp lại chính mình với mọi tác nhân — tên bạn, sở thích, dị ứng, stack công nghệ. Lịch sử trò chuyện bị cô lập theo từng ứng dụng. Không có lớp bộ nhớ di động nào.

Epitome khắc phục điều này. Một cơ sở dữ liệu mà mọi tác nhân AI chia sẻ, để tất cả chúng đều ghi nhớ bạn.

---

Bắt đầu nhanh

Dịch vụ lưu trữ (nhanh nhất)

1. Đăng ký tại epitome.fyi
2. Vào Cài đặt → Khóa API và sao chép URL MCP của bạn
3. Kết nối một tác nhân AI — xong

Tự lưu trữ

git clone https://github.com/gunning4it/epitome.git
cd epitome
cp .env.example .env    # edit with your credentials
docker compose up -d

Mở localhost:5173 và đăng nhập bằng Google hoặc GitHub OAuth.

---

Kết nối một Tác nhân AI

Lấy khóa API của bạn từ Cài đặt → Khóa API trong bảng điều khiển (dịch vụ lưu trữ hoặc tự lưu trữ).

Claude Desktop

Thêm vào claude_desktop_config.json của bạn:

{
  "mcpServers": {
    "epitome": {
      "url": "https://epitome.fyi/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Claude Code

claude mcp add --transport http --header "Authorization: Bearer YOUR_API_KEY" epitome https://epitome.fyi/mcp

Tự lưu trữ

Đối với tự lưu trữ, thay thế https://epitome.fyi bằng http://localhost:3000.

Epitome cung cấp 3 công cụ MCP — recall, memorize, và review. Xem tài liệu tham khảo công cụ đầy đủ.

---

Dành cho ai

• Nhà phát triển AI xây dựng tác nhân cần bộ nhớ người dùng bền vững
• Người dùng thành thạo muốn mọi AI ghi nhớ họ trên các nền tảng
• Người tự lưu trữ muốn sở hữu toàn bộ dữ liệu — không cần đám mây

Trường hợp sử dụng

• Tác nhân theo dõi bữa ăn của bạn ghi nhớ dị ứng của bạn
• Trợ lý lập trình biết stack, mẫu code, nhóm của bạn
• Tác nhân lịch biết gia đình, ưu tiên, thói quen của bạn
• Mọi công cụ AI mới bạn thử đều đã biết bạn từ ngày đầu tiên

---

Tại sao chọn Epitome?

	Lịch sử Chat	Vector DB	Ứng dụng Ghi chú	Epitome
Nhận dạng di động				✓
Bộ nhớ chia sẻ đa tác nhân				✓
Đồ thị tri thức				✓
Đồng ý & kiểm toán mỗi tác nhân				✓
Cô lập schema mỗi người dùng				✓
Dữ liệu có cấu trúc + ngữ nghĩa		một phần		✓
Có thể tự lưu trữ		✓		✓

---

Năm lớp

#	Lớp	Mô tả
01	Cơ sở dữ liệu Cá nhân	Bảng có cấu trúc, bộ nhớ ngữ nghĩa vector, và lưu trữ khóa-giá trị. Dữ liệu của bạn nằm trong PostgreSQL — có thể truy vấn, xuất ra, của bạn.
02	Nhận dạng Di động	Hồ sơ có cấu trúc mà bất kỳ tác nhân AI nào cũng đọc được ngay lập tức. Tên, sở thích, mối quan hệ — không khởi đầu lạnh, mọi cuộc trò chuyện.
03	Chất lượng Bộ nhớ	Chấm điểm độ tin cậy, ghi nhận nguồn gốc, và quản lý vòng đời. Ký ức có được lòng tin qua củng cố, không phải niềm tin mù quáng.
04	Đồ thị Tri thức	Thực thể với các cạnh có kiểu, có trọng số. Người, địa điểm, khái niệm — được kết nối trong một đồ thị phát triển qua mỗi tương tác.
05	Đồng ý & Kiểm toán	Quyền hạn mỗi bảng và nhật ký hoạt động chỉ thêm vào. Bạn kiểm soát chính xác những gì mỗi tác nhân có thể thấy và làm.

---

Kiến trúc

AI Agent ──→ MCP (Streamable HTTP) ──→ Hono API ──→ PostgreSQL
                                         │
                                    per-user schema
                                      isolation

Mỗi người dùng có schema PostgreSQL riêng (user_{id}) — không phải bảo mật cấp hàng, mà là cô lập toàn bộ cấp schema. Truy cập chéo schema là không thể ở cấp SQL.

Xem EPITOME_TECH_SPEC.md để biết kiến trúc đầy đủ.

---

Bảo mật & Quyền riêng tư

• Bạn sở hữu dữ liệu của mình — tự lưu trữ hoặc dùng dịch vụ lưu trữ
• Cô lập schema PostgreSQL mỗi người dùng — không phải bảo mật cấp hàng, tách biệt schema hoàn toàn
• Quy tắc đồng ý mỗi tác nhân — bạn kiểm soát những gì mỗi tác nhân có thể đọc và ghi
• Nhật ký kiểm toán chỉ thêm vào — mọi truy cập đều được ghi lại
• Sẵn sàng GDPR — xuất hoặc xóa tất cả dữ liệu của bạn bất cứ lúc nào

---

Stack Công nghệ

Thành phần	Công nghệ
Runtime	Node.js 22 LTS
API	Hono
Cơ sở dữ liệu	PostgreSQL 17 + pgvector
MCP	@modelcontextprotocol/sdk
Frontend	React 19 + Tailwind CSS 4 + shadcn/ui
Xác thực	Zod
Kiểm thử	Vitest

---

Tài liệu

• Bắt đầu Nhanh — Chạy trong vài phút
• SDK JavaScript — Xây dựng với @epitomefyi/sdk
• Gói npm — Cài đặt và lịch sử phiên bản
• Công cụ SDK AI — searchMemory, saveMemory, getUserContext cho gọi công cụ
• Tham khảo API — Tài liệu endpoint REST
• Công cụ MCP — Giải thích tất cả 3 công cụ MCP
• Kiến trúc — Đặc tả kỹ thuật đầy đủ
• Mô hình Dữ liệu — Mọi bảng, cột, và ràng buộc
• Hướng dẫn Tự lưu trữ — Triển khai Docker Compose
• Bảo mật — Cô lập, đồng ý, và kiểm toán

---

Đóng góp

Hoan nghênh đóng góp! Xem CONTRIBUTING.md để biết hướng dẫn.

git clone https://github.com/gunning4it/epitome.git
cd epitome && cp .env.example .env
docker compose up -d

Sau đó mở PR — chúng tôi sẵn lòng giúp đỡ đóng góp đầu tiên của bạn.

---

Giấy phép

MIT