AI-IQ: SQLite 파일 하나로 구현하는 신념, 예측, 꿈 통합 기능을 갖춘 경량 영구 메모리

실용적 조언

pip install ai-iq를 통해 즉시 설치하여 로컬 에이전트에 적용 가능하다.
SQLite 파일 하나로 모든 데이터가 관리되므로 백업과 시스템 간 이관이 매우 간편하다.
Claude Code와 같은 코딩 에이전트와 연동하여 개발 과정의 아키텍처 선택이나 버그 수정 이력을 추적하는 용도로 활용할 수 있다.

섹션별 상세

AI-IQ는 단순한 벡터 저장을 넘어 베이지안 추론을 통한 신념 점수화 기능을 제공한다. 입력된 데이터에 대해 베이지안 업데이트를 수행하여 0에서 1 사이의 신뢰도 점수를 산출한다. 작성자는 2개월간의 프로덕션 운영을 통해 322개의 메모리와 53개의 그래프 엔티티를 관리하며 의사결정 과정을 추적했다. 이는 단순 검색보다 고차원적인 추론 기반 메모리 관리를 가능하게 한다.

시스템은 인과 관계 지식 그래프를 통해 예측을 관리하고 업데이트를 전파한다. 예측 데이터를 입력받아 지식 그래프 내의 관련 엔티티로 정보를 전파하여 전체적인 일관성을 유지한다. 사용자가 실제로 선택한 검색 결과를 추적하여 검색 가중치를 자동으로 조정하는 자기 학습 기능을 포함한다. 이를 통해 에이전트의 응답 정확도를 지속적으로 개선할 수 있다.

'드림 모드(Dream mode)'라는 자율 통합 프로세스를 통해 중복 데이터를 제거하고 모순을 해결한다. 원시 메모리를 입력받아 자율적으로 통합하거나 모순을 감지하여 정제된 지식 베이스를 출력한다. SQLite의 FTS5와 sqlite-vec을 결합한 하이브리드 검색을 사용하여 로컬 환경에서도 빠른 성능을 보장한다. 클라우드 의존성 없이 단일 파일로 모든 메모리를 관리할 수 있는 것이 핵심이다.

용어 해설

베이지안 추론(Bayesian Inference): — 새로운 증거를 바탕으로 가설의 확률을 업데이트하는 통계적 방법이다. AI-IQ에서 신념의 신뢰도 점수를 동적으로 조정하는 핵심 메커니즘으로 사용된다. 데이터가 누적될수록 에이전트의 판단 근거를 수치화하여 관리할 수 있게 돕는다.
인과 관계 지식 그래프(Causal Knowledge Graph): — 엔티티 간의 원인과 결과 관계를 구조화한 데이터 맵이다. 특정 예측의 결과가 시스템 전체의 지식 체계에 미치는 영향을 논리적으로 전파하는 데 사용된다. 단순한 키워드 연결을 넘어 지식의 논리적 일관성을 유지하는 역할을 한다.
전문 검색 엔진 5(FTS5): — SQLite에서 제공하는 고성능 전문 검색 엔진 모듈이다. 텍스트 데이터에 대한 효율적인 인덱싱과 검색 기능을 제공하여 하이브리드 검색의 한 축을 담당한다. 로컬 환경에서 대량의 텍스트 메모리를 빠르게 검색할 수 있게 지원한다.
SQLite 벡터 확장(sqlite-vec): — SQLite 내에서 벡터 임베딩 저장 및 유사도 검색을 가능하게 하는 확장 기능이다. 별도의 외부 벡터 데이터베이스 없이도 로컬 환경에서 벡터 검색을 수행할 수 있게 한다. AI-IQ가 단일 SQLite 파일로 작동할 수 있게 하는 핵심 기술이다.
벡터 저장소(Vector Store): — 고차원 벡터 데이터를 저장하고 유사도 기반 검색을 수행하는 시스템이다. 텍스트를 수치화한 임베딩을 저장하여 의미적으로 유사한 정보를 찾아내는 데 쓰인다. AI-IQ는 이 기본 기능을 넘어 인지적 추론 계층을 추가한 형태이다.

코드 예제

bash

pip install ai-iq

AI-IQ 라이브러리를 설치하는 명령어

언급된 도구

AI-IQ추천

로컬 AI 에이전트용 인지형 영구 메모리 시스템

SQLite중립

메모리 저장을 위한 경량 데이터베이스 엔진

Claude Code중립

AI-IQ가 실제로 적용되어 운영 중인 코딩 에이전트 도구

언급된 리소스

GitHubAI-IQ GitHub Repository