supermemoryai/supermemory

Supermemory는 AI를 위한 최첨단 메모리 및 컨텍스트 엔진입니다. LongMemEval, LoCoMo, ConvoMem이라는 세 가지 주요 AI 메모리 벤치마크에서 1위를 차지했습니다. 대화에서 사실을 추출하고, 시간적 변화와 모순을 처리하며, 만료된 정보를 잊고, 적시에 올바른 컨텍스트를 제공합니다. 전체 RAG, 커넥터, 파일 처리를 하나의 시스템으로 제공합니다.

• 🧠 메모리: 대화에서 사실을 추출하고, 시간적 변화, 모순, 자동 망각을 처리합니다.
• 👤 사용자 프로필: 안정적인 사실과 최근 활동을 포함한 자동 유지 사용자 컨텍스트. 한 번의 호출로 약 50ms.
• 🔍 하이브리드 검색: 단일 쿼리로 RAG + 메모리. 지식 베이스 문서와 개인화된 컨텍스트를 함께 제공합니다.
• 🔌 커넥터: Google Drive, Gmail, Notion, OneDrive, GitHub — 실시간 웹훅으로 자동 동기화.
• 📄 멀티모달 추출기: PDF, 이미지(OCR), 비디오(자막), 코드(AST 기반 청킹). 업로드만 하면 작동합니다.

주요 기능:

Supermemory 사용하기

AI 도구 사용자

앱을 사용하여 개인 슈퍼메모리를 구축하세요. 모든 대화에 걸쳐 지속적인 메모리 그래프를 구축합니다. AI가 선호도, 프로젝트, 과거 논의를 기억하고 시간이 지남에 따라 더 똑똑해집니다.

AI 제품 개발자

단일 API로 에이전트와 앱에 메모리, RAG, 사용자 프로필, 커넥터를 추가하세요. 벡터 DB 설정, 임베딩 파이프라인, 청킹 전략이 필요 없습니다.

직접 실행

최첨단 메모리를 자신의 머신에서 실행하세요. 하나의 바이너리, 제로 설정. 모든 모델을 가져오거나 Ollama로 완전히 오프라인으로 실행할 수 있습니다.

curl -fsSL https://supermemory.ai/install | bash

AI에 메모리 부여하기

Supermemory 앱, 브라우저 확장 프로그램, 플러그인, MCP 서버는 호환되는 AI 어시스턴트에 지속적인 메모리를 제공합니다.

앱

https://app.supermemory.ai 에서 무료로 사용할 수 있습니다.

Supermemory 플러그인

Claude Code, OpenCode, OpenClaw, Hermes용 플러그인이 내장되어 있습니다. 오픈 소스입니다.

MCP - 빠른 설치

npx -y install-mcp@latest https://mcp.supermemory.ai/mcp --client claude --oauth=yes

claude를 cursor, windsurf, vscode 등으로 바꾸세요.

AI가 얻는 도구

• memory: 정보 저장 또는 망각. AI가 기억할 가치가 있는 것을 공유할 때 자동으로 호출합니다.
• recall: 쿼리로 메모리 검색. 관련 메모리와 사용자 프로필 요약을 반환합니다.
• context: 대화 시작 시 전체 프로필(선호도, 최근 활동)을 주입합니다. Cursor와 Claude Code에서는 /context를 입력하세요.

작동 방식

1. AI와 평소처럼 대화합니다.
2. Supermemory가 중요한 정보(사실, 선호도, 프로젝트 컨텍스트)를 추출하고 저장합니다.
3. 다음 대화에서 AI가 이미 사용자를 알고 있습니다.

메모리는 프로젝트(컨테이너 태그)로 범위가 지정되어 업무와 개인 컨텍스트를 분리하거나 클라이언트, 리포지토리 등으로 구성할 수 있습니다.

지원 클라이언트

Claude Desktop, Cursor, Windsurf, VS Code, Claude Code, OpenCode, OpenClaw, Hermes

수동 설정

MCP 클라이언트 설정에 다음을 추가하세요:

{
  "mcpServers": {
    "supermemory": {
      "url": "https://mcp.supermemory.ai/mcp"
    }
  }
}

또는 API 키 사용:

{
  "mcpServers": {
    "supermemory": {
      "url": "https://mcp.supermemory.ai/mcp",
      "headers": {
        "Authorization": "Bearer sm_your_api_key_here"
      }
    }
  }
}

Supermemory로 구축하기 (API)

설치

npm install supermemory    # 또는: pip install supermemory

빠른 시작

import Supermemory from "supermemory";

const client = new Supermemory();

// 대화 저장
await client.add({
  content: "User loves TypeScript and prefers functional patterns",
  containerTag: "user_123",
});

// 한 번의 호출로 사용자 프로필 + 관련 메모리 가져오기
const { profile, searchResults } = await client.profile({
  containerTag: "user_123",
  q: "What programming style does the user prefer?",
});

// profile.static  → ["Loves TypeScript", "Prefers functional patterns"]
// profile.dynamic → ["Working on API integration"]
// searchResults   → 유사도 순으로 정렬된 관련 메모리

from supermemory import Supermemory

client = Supermemory()

client.add(
    content="User loves TypeScript and prefers functional patterns",
    container_tag="user_123"
)

result = client.profile(container_tag="user_123", q="programming style")

print(result.profile.static)   # 장기 사실
print(result.profile.dynamic)  # 최근 컨텍스트

프레임워크 통합

Vercel AI SDK, LangChain, LangGraph, OpenAI Agents SDK, Mastra, Agno, Claude Memory Tool, n8n용 드롭인 래퍼를 제공합니다.

검색 모드

• 하이브리드(기본값): 단일 쿼리로 RAG + 메모리
• 메모리 전용

사용자 프로필

전통적인 메모리는 검색에 의존하지만, Supermemory는 모든 사용자에 대한 프로필을 자동으로 유지합니다. 한 번의 호출로 약 50ms.

커넥터

Google Drive, Gmail, Notion, OneDrive, GitHub, 웹 크롤러와 자동 동기화. 실시간 웹훅, 문서 자동 처리 및 청킹.

API 개요

Supermemory 로컬 — 직접 실행

curl -fsSL https://supermemory.ai/install | bash
# 또는
npx supermemory local

supermemory-server

첫 부팅 시 임베디드 Supermemory 그래프 엔진, 로컬 임베딩, 자격 증명을 설정하고 API 키를 출력합니다. 전체 메모리 API가 http://localhost:6767에서 실행됩니다.

const client = new Supermemory({
  apiKey: "sm_...",
  baseURL: "http://localhost:6767", // 이것만 변경
});

• 모든 모델 지원: OpenAI, Anthropic, Gemini, Groq 또는 OpenAI 호환 엔드포인트.
• 완전 오프라인 가능: Ollama를 가리키면 데이터가 머신을 떠나지 않습니다.
• 데이터는 ./.supermemory 디렉토리에 저장되어 백업 및 이동이 쉽습니다.
• 플랫폼과 동일한 API: 로컬에서 프로토타이핑하고 baseURL만 변경하여 호스팅 플랫폼에 배포할 수 있습니다.