Epitome

공식

개인 AI 메모리 — 모든 AI 에이전트에게 사용자에 대한 공유되고 지속적인 메모리를 제공합니다

GitHub

Epitome MCP(으)로 무엇을 할 수 있나요?

AI 어시스턴트가 당신에 대해 알고 있는 정보를 불러오기 — recall 도구를 사용하여 저장된 사실, 선호도 또는 맥락을 어시스턴트에게 요청하세요.
새로운 정보를 공유 메모리에 저장하기 — memorize 도구를 통해 당신에 대한 선호도, 사실 또는 세부 정보를 유지하도록 어시스턴트에게 지시하세요.
저장된 메모리 검토 및 감사하기 — review 도구를 사용하여 저장된 내용과 어떤 에이전트가 접근했는지에 대한 요약 또는 검사를 요청하세요.

문서

Epitome

하나의 메모리 계층, 모든 AI 에이전트를 위해.

모든 AI 에이전트가 당신에 대한 공유되고 지속적인 기억을 갖도록 하는 휴대 가능한 정체성 계층입니다.
오픈 소스. 자체 호스팅 가능. 당신의 것.

웹사이트 · 빠른 시작 · 에이전트 연결 · 문서 · 기여하기

문제점

모든 AI 대화는 처음부터 시작됩니다. 당신은 모든 에이전트에게 자신의 이름, 선호도, 알레르기, 기술 스택을 반복해서 말해야 합니다. 채팅 기록은 앱별로 분리되어 있습니다. 휴대 가능한 메모리 계층이 없습니다.

Epitome이 이 문제를 해결합니다. 모든 AI 에이전트가 공유하는 하나의 데이터베이스로, 모두가 당신을 기억합니다.

빠른 시작

호스팅 (가장 빠름)

epitome.fyi에서 가입하세요
설정 → API 키로 이동하여 MCP URL을 복사하세요
AI 에이전트 연결 — 완료

자체 호스팅

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

localhost:5173을 열고 Google 또는 GitHub OAuth로 로그인하세요.

AI 에이전트 연결

대시보드(호스팅 또는 자체 호스팅)의 설정 → API 키에서 API 키를 가져오세요.

Claude Desktop

claude_desktop_config.json에 추가하세요:

{
  "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

자체 호스팅

자체 호스팅의 경우 https://epitome.fyi을 http://localhost:3000로 교체하세요.

Epitome은 3가지 MCP 도구를 제공합니다 — recall, memorize, review. 전체 도구 참조를 확인하세요.

대상 사용자

AI 개발자: 지속적인 사용자 메모리가 필요한 에이전트를 구축하는 분
파워 유저: 모든 AI가 플랫폼 전반에서 자신을 기억하길 원하는 분
자체 호스팅 사용자: 클라우드 없이 완전한 데이터 소유권을 원하는 분

사용 사례

식사 추적 에이전트가 당신의 알레르기를 기억합니다
코딩 도우미가 당신의 스택, 패턴, 팀을 알고 있습니다
캘린더 에이전트가 당신의 가족, 우선순위, 일과를 알고 있습니다
당신이 시도하는 모든 새로운 AI 도구가 첫날부터 당신을 이미 알고 있습니다

왜 Epitome인가?

	벡터 DB	Epitome
휴대 가능한 정체성		✓
다중 에이전트 공유 메모리		✓
지식 그래프		✓
에이전트별 동의 및 감사		✓
사용자별 스키마 격리		✓
구조화 + 의미론적 데이터	부분적	✓
자체 호스팅 가능	✓	✓

다섯 가지 계층

#	계층	설명
01	개인 데이터베이스	구조화된 테이블, 벡터 의미 메모리, 키-값 저장소. 데이터는 PostgreSQL에 저장되며 쿼리 가능하고 내보낼 수 있으며 당신의 것입니다.
02	휴대 가능한 정체성	모든 AI 에이전트가 즉시 읽을 수 있는 구조화된 프로필. 이름, 선호도, 관계 — 콜드 스타트 없이 모든 대화가 시작됩니다.
03	메모리 품질	신뢰도 점수, 출처 표시, 생명주기 관리. 기억은 맹목적인 믿음이 아닌 강화를 통해 신뢰를 얻습니다.
04	지식 그래프	유형화되고 가중치가 부여된 엣지를 가진 엔티티. 사람, 장소, 개념 — 모든 상호작용과 함께 성장하는 그래프로 연결됩니다.
05	동의 및 감사	테이블별 권한과 추가 전용 활동 로그. 각 에이전트가 보고 수행할 수 있는 작업을 정확히 제어합니다.

아키텍처

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

각 사용자는 자신만의 PostgreSQL 스키마(user_{id})를 갖습니다 — 행 수준 보안이 아닌 완전한 스키마 수준 격리입니다. SQL 수준에서 스키마 간 접근은 불가능합니다.

전체 아키텍처는 EPITOME_TECH_SPEC.md를 참조하세요.

보안 및 개인정보 보호

데이터 소유권은 당신에게 — 자체 호스팅하거나 호스팅 서비스를 이용하세요
사용자별 PostgreSQL 스키마 격리 — 행 수준 보안이 아닌 완전한 스키마 분리
에이전트별 동의 규칙 — 각 에이전트가 읽고 쓸 수 있는 것을 제어합니다
추가 전용 감사 로그 — 모든 접근이 기록됩니다
GDPR 대응 — 언제든지 모든 데이터를 내보내거나 삭제할 수 있습니다

기술 스택

구성 요소	기술
런타임	Node.js 22 LTS
API	Hono
데이터베이스	PostgreSQL 17 + pgvector
MCP	@modelcontextprotocol/sdk
프론트엔드	React 19 + Tailwind CSS 4 + shadcn/ui
유효성 검사	Zod
테스트	Vitest

문서

빠른 시작 — 몇 분 안에 실행하기
JavaScript SDK — @epitomefyi/sdk으로 빌드하기
npm 패키지 — 설치 및 버전 기록
AI SDK 도구 — 도구 호출을 위한 searchMemory, saveMemory, getUserContext
API 참조 — REST 엔드포인트 문서
MCP 도구 — 3가지 MCP 도구 모두 설명
아키텍처 — 전체 기술 사양
데이터 모델 — 모든 테이블, 열, 제약 조건
자체 호스팅 가이드 — Docker Compose 배포
보안 — 격리, 동의, 감사

기여하기

기여를 환영합니다! 가이드라인은 CONTRIBUTING.md를 참조하세요.

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

그런 다음 PR을 열어주세요 — 첫 기여를 기꺼이 도와드리겠습니다.

라이선스

MIT