Hindsight

Hindsight란 무엇인가요?

Hindsight는 오픈소스(MIT 라이선스) 에이전트 메모리 시스템으로, 세션 간 진정한 학습을 가능하게 하여 AI 에이전트를 더 똑똑하게 만듭니다. 기존의 RAG나 단순한 대화 기록과 달리, Hindsight는 메모리를 추론을 위한 핵심 기반으로 취급합니다.

이 시스템은 상호작용 사이에 모든 것을 잊어버리는 상태 비저장(stateless) 에이전트의 문제를 해결하며, 세 가지 핵심 연산(Retain, Recall, Reflect)을 갖춘 구조화된 생체 모방적(biomimetic) 메모리를 제공합니다.

주요 기능

• 생체 모방적 메모리 네트워크: 지식을 세계적 사실, 경험, 정신 모델(자동 관찰 통합 포함)로 구성합니다.
• Retain: 엔티티, 관계, 사실, 시간적 데이터를 정규 메모리 뱅크로 추출하는 LLM 기반 기능입니다.
• Recall (TEMPR): 의미론적(벡터), 키워드(BM25), 그래프(엔티티/시간적/인과적), 시간적 필터링을 결합한 하이브리드 다중 전략 검색으로, 상호 순위 융합 및 재순위 지정으로 통합됩니다.
• Reflect: 메모리를 사용하여 통찰력을 생성하고, 신념을 업데이트하며, 복잡한 추론을 지원하는 에이전트 합성 기능입니다. Mission, Directives, Disposition을 통해 구성 가능합니다.
• 메모리 뱅크: 사용자별 또는 컨텍스트별 격리된 저장소로 메타데이터를 지원합니다.
• 다중 LLM 지원: LiteLLM을 통해 OpenAI, Anthropic, Gemini, Groq, Ollama 등과 호환됩니다.

성능

Hindsight는 LongMemEval(2026년 초 기준)에서 최고 정확도를 포함한 장기 메모리 벤치마크에서 최첨단 성과를 달성했습니다. 성능은 버지니아 공대의 Sanghani Center와 The Washington Post에서 독립적으로 재현되었습니다.

설치 및 빠른 시작

Docker(권장)

export OPENAI_API_KEY=sk-xxx
docker run --rm -it --pull always -p 8888:8888 -p 9999:9999 \
  -e HINDSIGHT_API_LLM_API_KEY=$OPENAI_API_KEY \
  -v $HOME/.hindsight-docker:/home/hindsight/.pg0 \
  ghcr.io/vectorize-io/hindsight:latest

API는 http://localhost:8888에서 실행되며, 웹 UI는 http://localhost:9999에서 제공됩니다.

Python SDK

pip install hindsight-client -U

기본 사용법:

from hindsight_client import Hindsight

client = Hindsight(base_url="http://localhost:8888")
client.retain(bank_id="demo", content="...")
results = client.recall(bank_id="demo", query="...")
insights = client.reflect(bank_id="demo", query="...")

Node.js/TypeScript와 임베디드 모드도 지원됩니다.

사용 사례

• 지속적인 코딩 에이전트 구축(Claude Code, Cursor 통합) , 장기적인 사용자 선호도 보존이 가능한 맞춤형 대화 에이전트
• 경험에서 학습하고 전략을 조정하는 자율 에이전트
• 세션 간 메모리와 추론이 필요한 엔터프라이즈 AI 워크플로우

리소스

• GitHub: https://github.com/vectorize-io/hindsight
• 공식 문서: https://hindsight.vectorize.io
• arXiv 논문: https://arxiv.org/abs/2512.12818
• Hindsight Cloud: https://ui.hindsight.vectorize.io

Hindsight는 꾸준히 유지보수되고 있으며(최신 커밋 2026년 4월) 포춘 500 기업과 AI 스타트업에서 프로덕션 환경에서 사용되고 있습니다.