한눈에 보기
- 무엇: TencentDB Agent Memory(텐센트DB 에이전트 메모리)는 여러 AI 에이전트가 기억을 함께 쓰게 해 주는 ‘팀 메모리 허브’예요. 코드가 공개된 오픈소스예요. 대화·문서·코드를 4가지 ‘메모리 자산’으로 바꿔 팀과 에이전트에 나눠 줘요(공식, 저장소 README).
- 누가: 중국 텐센트 클라우드(TencentCloud)가 깃허브에 공개했어요.
- 언제: 저장소는 2026년 4월 7일 만들어졌고, 최신 릴리스는 10월 9일 v2.0.2예요(GitHub API, 10월 13일 확인).
- 얼마: 무료 오픈소스(MIT 라이선스)예요. 다만 기억을 정리하는 데 쓰는 LLM 비용은 따로 들어요(공식, README 설치 안내 기준).
- 어디서: 내 컴퓨터나 서버에 직접 설치해요. 클로드 코드, 코덱스 같은 에이전트를 붙일 수 있고, 문서는 영어·중국어로 나와 있어요(공식).
결론부터 말하면, 이 프로젝트의 핵심은 ‘대화 기록 창고’가 아니라 ‘누가 어떤 기억을 쓸 수 있는지 사람이 정하는 관리판’이에요(공식, README). 깃허브 별은 2만 8,275개로 관심이 커요. 하지만 저장소에는 아직 기억이 중복 저장되거나 빠지는 버그 보고가 여럿 열려 있어요(GitHub API·이슈, 10월 13일 18시 14분 확인).
용어부터 짧게 풀게요. AI 에이전트는 사람 대신 여러 단계 작업을 스스로 처리하는 AI예요. 에이전트 메모리는 에이전트가 새 대화를 시작해도 이전 맥락과 결정 사항을 이어 쓰게 하는 저장 장치예요. LLM은 챗GPT·클로드 같은 대형 언어 모델이에요.
무엇을 기억하나요? 4가지 메모리 자산
| 자산 | 무엇을 담나(README 설명) |
|---|---|
| Chat Memory(대화 기억) | 이용자의 선호, 사실, 결정, 대화 이력. 에이전트마다 만들 때 자동으로 생겨요. |
| Skill(스킬) | 복잡한 작업을 마친 뒤 대화와 도구 사용 기록에서 뽑아낸 재사용 절차. 버전·실행 단계·검증 규칙이 붙어요. |
| Wiki(위키) | 제품 문서·설계서·운영 매뉴얼을 서로 링크된 구조 페이지로 바꾼 것. 카파시의 ‘LLM 위키’ 아이디어에서 영향을 받았다고 밝혀요. |
| CodeGraph(코드 그래프) | 코드의 함수·파일·호출 관계를 색인해, 고치기 전에 “이걸 바꾸면 어디에 영향이 가나”를 볼 수 있게 한 것. |
대화 기억은 4단계로 정리돼요. 원본 대화(L0)를 저장한 뒤, 사실·선호를 뽑은 조각(L1), 프로젝트별 묶음(L2), 장기 프로필(L3)로 차례로 요약해요(공식). 찾을 때는 키워드 검색(BM25)과 의미 검색(벡터 검색)을 함께 쓰고, 두 결과를 섞는 RRF 방식으로 순위를 매긴다고 밝혀요(공식). 벡터 검색은 글의 뜻을 숫자로 바꿔 비슷한 뜻을 찾는 방식이에요.
어떻게 붙이나요?
설치는 저장소를 내려받아 설정 파일에 LLM 정보 두 묶음(기억 정리용, 프록시용)을 채우는 데서 시작해요. 그다음 실행 스크립트 하나로 세 서비스(memory-core, memory-hub, proxy)를 띄워요(공식, README). 관리 화면은 내 컴퓨터의 8125번 포트에서 열려요. Node.js 22.16 이상이 필요해요(공식, README 배지).
에이전트 연결은 프록시로 해요. 프록시는 에이전트와 LLM 사이에서 요청을 대신 주고받는 중계 서버예요. 에이전트의 접속 주소(base URL)만 프록시로 바꾸면 플러그인이나 MCP 서버 없이 붙는다고 설명해요(공식). README가 밝힌 지원 에이전트는 클로드 코드, 코덱스를 비롯해 7가지예요. 나머지는 DeepSeek Harness, CodeBuddy, WorkBuddy, Hermes, OpenClaw 같은 코딩·업무용 에이전트 도구예요.
기억의 공개 범위는 4가지로 나눠요. private는 본인만 보고 팀 관리자도 못 봐요. team은 팀원이 읽을 수 있어요. restricted는 사람·역할·에이전트별 권한 목록으로 정하고, agent는 특정 에이전트에 장착할 때 써요. 새 대화 기억과 스킬은 기본이 private이고, 공유는 따로 눌러야 해요(공식).
숫자로 보면
| 항목 | 값 | 출처·조건 |
|---|---|---|
| 깃허브 별 | 28,275개 | GitHub API, 2026-10-13 18:14 KST |
| 포크 | 2,746개 | GitHub API, 같은 시각 |
| 열린 이슈·PR(수정 제안) | 898건 | GitHub API, 같은 시각 |
| 최신 릴리스 | v2.0.2 (2026-10-09) | GitHub 릴리스. README 본문은 아직 ‘v2.0.0’으로 적혀 있어요 |
| PersonaMem(개인화 기억 시험) 점수 | 48% → 76% | 회사 측정. 쓴 모델·실험 조건은 README에 없어요 |
PersonaMem은 긴 대화 뒤에도 에이전트가 이용자 정보를 제대로 이해하고 쓰는지 보는 시험이라고 README가 설명해요. 다만 어떤 LLM과 설정으로 잰 값인지 적혀 있지 않아, 다른 메모리 도구와 바로 비교하기는 어려워요(README 기준).
한계와 열린 문제
README가 스스로 밝힌 한계가 있어요. 위키와 코드 그래프는 비동기로 만들어져 준비될 때까지 시간이 걸려요. 코드 그래프는 누구나 주소로 열 수 있는 공개 저장소(HTTPS 주소)를 우선 지원해요. 비공개 저장소와 SSH 인증(보안 키로 접속하는 방식)은 아직 다듬는 중이에요. 기억을 에이전트에 자동으로 배정하는 기능도 아직 개발 중이고, 지금은 사람이 직접 연결해요(공식). MongoDB 저장소는 실험 기능이라 기본으로 꺼져 있어요(공식).
저장소 이슈에는 데이터 품질과 관련된 버그 보고가 열려 있어요(10월 13일 확인). 먼저 L1 중복 제거가 실패하면 조용히 전부 저장해 기억이 중복된다는 보고가 있어요(#1640). 같은 이용자 메시지가 한 턴에 22~309번 기록된다는 보고도 있어요(#1621). 추출이 실패해도 진행 위치가 넘어가 일부 대화가 영영 빠진다는 보고도 올라왔어요(#1618). 윈도 Git Bash에서 배포 스크립트가 깨진다는 보고(#1609)도 있어요. 모두 이용자·기여자 보고이고, 일부는 수정 PR이 함께 올라와 있어요(GitHub 이슈).
라이선스 표기도 확인해 둘 점이에요. 라이선스 파일(LICENSE)에는 “MIT로 배포한다”고 적혀 있어요. 다만 텐센트 저작권 문구가 덧붙어 깃허브는 라이선스 종류를 ‘Other’로 표시해요(GitHub API·LICENSE 파일). 회사에서 쓸 때는 LICENSE 원문을 직접 읽어 보는 게 좋아요(추정).
한국 이용자에게는 무엇이 달라지나요?
문서와 관리 화면은 영어·중국어 중심이에요(공식, README 언어 표시). 한국어 대화를 저장·요약하는 품질은 README에 따로 나와 있지 않아, 기억을 정리하는 LLM을 무엇으로 고르느냐에 크게 달려 있을 거예요(추정).
국내 팀이 따져 볼 부분은 데이터 흐름이에요. 프록시 방식은 에이전트의 모든 요청이 프록시를 지나간다는 뜻이고, 그 대화가 기억으로 저장돼요(공식 구조 설명 기준). 고객 정보나 사내 코드가 오가는 팀이라면 어떤 서버에 설치하고, 어떤 LLM으로 요약하는지부터 정해야 해요(추정). 에이전트에게 권한을 어디까지 줄지에 대한 기본 원칙은 AI 에이전트 권한 제한 기사에서 볼 수 있어요.
대단한 점과 아쉬운 점
| 의미 있는 점 | 아쉬운 점·우려 |
|---|---|
| 기억을 ‘누가, 어떤 버전을, 어느 에이전트에게’까지 관리하는 권한 구조를 갖췄어요(공식, README). | 성능 근거는 조건이 빠진 PersonaMem 점수 하나뿐이에요(README 기준). |
| 접속 주소만 바꾸는 프록시 방식이라 여러 에이전트를 코드 수정 없이 붙일 수 있다고 밝혀요(공식). | 기억 중복·누락 같은 데이터 품질 버그가 아직 열려 있어요(GitHub 이슈 #1640·#1621·#1618). |
| 문서·코드·대화를 한곳에서 기억 자산으로 다뤄, 새 에이전트가 처음부터 다시 배우는 수고를 줄이려 해요(공식). | README의 버전 표기(v2.0.0)가 실제 릴리스(v2.0.2)와 달라, 문서가 개발 속도를 못 따라가는 모습이에요(GitHub 릴리스 대조). |
확장성
작은 팀이라면 ‘조사 담당·개발 담당·검토 담당’ 에이전트마다 필요한 기억만 장착하는 식으로 쓸 수 있어요. README도 1인 회사가 역할별 에이전트 팀을 꾸리는 예를 들어요(공식). 예전에는 에이전트마다 프로젝트 설명을 다시 붙여 넣어야 했다면, 이 구조에서는 팀의 기억을 ‘저장 파일’처럼 불러와 시작하는 게 목표예요(공식).
여러 에이전트와 도구를 한 관문으로 묶는 흐름은 다른 회사에서도 보여요. 우버가 MCP 서버 800개를 한곳으로 묶은 사례는 우버 MCP 게이트웨이 기사에서 볼 수 있어요.
아직 모르는 것
- PersonaMem 48% → 76%를 어떤 모델·설정으로 쟀는지 공개되지 않았어요.
- 한국어 대화의 기억 추출·요약 품질은 확인된 자료가 없어요.
- 텐센트 클라우드의 관리형(유료) 서비스로 이어질지, 가격이 어떻게 될지는 저장소에 나와 있지 않아요.
- 열린 데이터 품질 버그가 다음 릴리스에서 언제 고쳐질지는 정해지지 않았어요.
자주 묻는 질문
TencentDB Agent Memory는 오픈소스인가요?
네. 깃허브에 소스가 공개돼 있고 LICENSE 파일에 MIT 라이선스로 배포한다고 적혀 있어요. 텐센트 저작권 문구가 붙어 깃허브는 종류를 ‘Other’로 표시하니, 회사에서 쓸 때는 원문을 확인해 보세요.
TencentDB Agent Memory를 Codex에서도 쓸 수 있나요?
README는 코덱스를 프록시로 붙일 수 있는 에이전트로 적고, 설정 방법을 설치 문서(INSTALL.md)에 안내해요. README 로드맵에는 코덱스 IDE(코드 편집 프로그램)의 Plan 모드 지원이 v2.0.1 목표로 적혀 있어요.
AI 에이전트 메모리는 RAG와 무엇이 다른가요?
RAG(검색 증강 생성)는 질문할 때 관련 문서를 찾아 AI에 붙여 주는 방식이에요. README는 RAG가 “무엇을 찾을 수 있나”에 답한다고 설명해요. 팀 메모리는 여기에 “누가 쓸 수 있고, 어떤 버전이 유효하고, 어느 에이전트에게 줄지”까지 답한다고 밝혀요.
Claude Code 메모리로도 쓸 수 있나요?
README는 클로드 코드를 지원 에이전트로 적고, 접속 주소를 프록시로 바꾸는 방식으로 연결한다고 안내해요. 클로드 코드에 원래 있는 메모리 기능과 어떻게 함께 쓰는지는 README에 따로 나와 있지 않아요.
출처
- TencentCloud/TencentDB-Agent-Memory, README.md (확인 2026-10-13 18:14 KST) — 링크
- GitHub REST API, 저장소 정보(별·포크·열린 이슈·생성일) (확인 2026-10-13 18:14 KST) — 링크
- GitHub 릴리스 v2.0.2 (게시 2026-10-09 11:19 UTC, 확인 2026-10-13) — 링크
- LICENSE 파일 (확인 2026-10-13) — 링크
- GitHub 이슈 #1640·#1621·#1618·#1609 (확인 2026-10-13) — 링크
대표 이미지: 텐센트 클라우드
구글 검색에서 AIMAG 소식을 먼저 보려면
AI 보조 초안 · 편집부 검수