Repolode
vectorize-io

vectorize-io/hindsight

대화 기록만 재생하는 대신 기억을 저장·회상·성찰해 AI 에이전트가 시간이 지날수록 학습하도록 돕는 에이전트 메모리 시스템입니다.

스타
51,907
포크
6,178
열린 이슈
148
마지막 커밋
2시간 전

어떤 프로젝트인가요?

Hindsight는 단순히 기억하는 데 그치지 않고 학습하는 AI 에이전트를 만들기 위한 메모리 시스템입니다. 대화 기록만 떠올리는 대신, 기억을 세상에 관한 사실, 에이전트 자신의 경험, 통합된 관찰 내용, 그리고 시간이 지나며 종합되는 심성 모델로 정리합니다.

핵심 API는 세 가지 작업으로 구성됩니다. retain은 LLM이 사실, 엔티티, 관계를 추출해 새로운 정보를 저장하고, recall은 시맨틱 검색, BM25 키워드 검색, 엔티티 그래프 검색, 시간순 검색을 병렬로 실행한 뒤 결과를 병합하며, reflect는 기존 기억을 심층 분석합니다. 기억은 사용자, 에이전트 또는 프로젝트별로 분리된 뱅크에 저장되며, 서버는 각 뱅크마다 MCP 엔드포인트를 제공합니다.

Hindsight는 Docker 컨테이너, pip 패키지 또는 Kubernetes용 Helm 차트로 실행할 수 있으며, pgvector를 사용하는 PostgreSQL을 기반으로 합니다. Python, Node.js, Go 및 CLI 클라이언트를 제공하고, Ollama와 LM Studio 같은 완전 로컬 모델을 포함해 다양한 LLM 제공업체를 지원합니다.

핵심 기능

  • 01에이전트 기억을 저장하고 조회하는 retain, recall, reflect 작업
  • 02벡터, 키워드, 엔티티 그래프 및 시간순 검색을 결합하고 재순위화를 수행하는 recall
  • 03사용자, 에이전트 또는 프로젝트별로 기억을 분리하는 메모리 뱅크
  • 04MCP 호환 클라이언트용 뱅크별 내장 MCP 엔드포인트
  • 05Ollama 및 LM Studio를 통한 로컬 모델을 포함해 25개 이상의 LLM 제공업체 지원
  • 06Python, Node.js, Go 및 CLI 클라이언트와 REST API

활용 사례

  • 사용자별 선호 사항과 기록을 기억해 챗봇을 개인화
  • 코딩 에이전트가 프로젝트 아키텍처와 이전 세션을 장기적으로 기억하도록 지원
  • OpenAI 또는 Anthropic 클라이언트를 래핑해 기존 LLM 앱에 메모리 추가
  • 누적된 피드백을 바탕으로 동작을 조정하는 자율 에이전트 구축

빠른 시작

  1. 1

    Docker로 서버를 시작하세요

    docker run -it --pull always --name hindsight --restart unless-stopped -p 8888:8888 -p 9999:9999 -e HINDSIGHT_API_LLM_API_KEY=$OPENAI_API_KEY -v hindsight-data:/home/hindsight/.pg0 ghcr.io/vectorize-io/hindsight:latest
  2. 2

    Python 클라이언트를 설치하세요

    pip install hindsight-client -U
  3. 3

    클라이언트를 연결해 기억을 저장하고, 불러오고, 되돌아보세요

사용 전 알아둘 점

  • 완전한 셀프 호스팅에는 LLM 제공업체의 API 키 또는 로컬 모델 설정이 필요합니다.
  • Intel Mac에서 임베디드 용도로 사용하려면 별도의 hindsight-all-slim 패키지가 필요합니다.

토픽

자주 묻는 질문

hindsight은(는) 무엇인가요?
대화 기록만 재생하는 대신 기억을 저장·회상·성찰해 AI 에이전트가 시간이 지날수록 학습하도록 돕는 에이전트 메모리 시스템입니다. Hindsight는 단순히 기억하는 데 그치지 않고 학습하는 AI 에이전트를 만들기 위한 메모리 시스템입니다. 대화 기록만 떠올리는 대신, 기억을 세상에 관한 사실, 에이전트 자신의 경험, 통합된 관찰 내용, 그리고 시간이 지나며 종합되는 심성 모델로 정리합니다.
hindsight은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
hindsight은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
hindsight은(는) 아직 유지보수되고 있나요?
활발히 유지보수 중. hindsight의 마지막 커밋은 2026년 10월 20일입니다.
hindsight은(는) 어디에 사용할 수 있나요?
사용자별 선호 사항과 기록을 기억해 챗봇을 개인화 코딩 에이전트가 프로젝트 아키텍처와 이전 세션을 장기적으로 기억하도록 지원 OpenAI 또는 Anthropic 클라이언트를 래핑해 기존 LLM 앱에 메모리 추가 누적된 피드백을 바탕으로 동작을 조정하는 자율 에이전트 구축
hindsight는 어떻게 설치하나요?
Docker로 서버를 시작하세요: docker run -it --pull always --name hindsight --restart unless-stopped -p 8888:8888 -p 9999:9999 -e HINDSIGHT_API_LLM_API_KEY=$OPENAI_API_KEY -v hindsight-data:/home/hindsight/.pg0 ghcr.io/vectorize-io/hindsight:latest Python 클라이언트를 설치하세요: pip install hindsight-client -U 클라이언트를 연결해 기억을 저장하고, 불러오고, 되돌아보세요
hindsight은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/vectorize-io/hindsight

요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.

관련 프로젝트