Glucksberg/cristalina-v4

cristalina-v4은(는) 무엇을 하나요?

AI 에이전트를 위한 통제된 장기 기억 시스템으로, 출처 추적, 권한 게이트, 의미론적 성숙, 캐논, 위키, 검색 및 Hermes/OpenClaw 런타임 통합을 제공합니다.

개요

Glucksberg/cristalina-v4는 AI 에이전트가 장기적으로 정보를 기억하고 관리할 수 있도록 지원하는 정교한 메모리 시스템입니다. 이 시스템은 단순한 저장소를 넘어, 정보의 출처를 명확히 하고, 접근 권한을 제어하며, 지식이 시간이 지남에 따라 성숙하고 정제되는 과정을 관리합니다.

주요 기능

• 출처 추적 (Provenance): 모든 메모리 항목의 출처를 기록하여 정보의 신뢰성과 투명성을 보장합니다.
• 권한 게이트 (Authority Gates): 특정 에이전트 또는 사용자만 메모리를 읽거나 쓸 수 있도록 접근을 제어합니다.
• 의미론적 성숙 (Semantic Maturation): 정보가 여러 번 검증되고 정제됨에 따라 점진적으로 더 정확하고 구조화된 지식으로 변환됩니다.
• 캐논 (Canon): 확정된 지식의 집합으로, 시스템의 신뢰할 수 있는 참조 지점을 제공합니다.
• 위키 (Wiki): 구조화된 문서화를 지원하여 지식 베이스를 쉽게 탐색하고 업데이트할 수 있습니다.
• 검색 (Retrieval): 강력한 검색 기능을 통해 필요에 따라 관련 정보를 빠르게 찾을 수 있습니다.
• Hermes/OpenClaw 통합: Hermes 및 OpenClaw 런타임 환경과 완벽하게 통합되어 실제 AI 에이전트 워크플로우에서 원활하게 작동합니다.

사용 방법

설치

# 예시 설치 명령어 (실제 패키지 매니저에 따라 다를 수 있음)
npm install glucksberg/cristalina-v4

기본 설정

import { CristalinaMemory } from 'glucksberg/cristalina-v4';

const memory = new CristalinaMemory({
  provenance: true,
  authorityGates: ['admin', 'user'],
  semanticMaturation: true,
  canon: { enabled: true },
  wiki: { enabled: true },
  retrieval: { algorithm: 'hybrid' }
});

메모리 저장

await memory.save({
  id: 'mem-001',
  content: '사용자의 선호도: 어두운 테마 선호',
  source: 'user-preferences-service',
  authorityLevel: 'user'
});

메모리 검색

const results = await memory.retrieve({
  query: '선호도',
  filters: { authorityLevel: 'user' },
  limit: 10
});

통합 가이드

Hermes 런타임

# hermes-config.yaml
memory:
  provider: cristalina-v4
  settings:
    provenance: true
    authorityGates: ["agent", "system"]

OpenClaw 런타임

{
  "memory": {
    "type": "cristalina",
    "config": {
      "semanticMaturation": true,
      "canon": {
        "autoApprove": false
      }
    }
  }
}

아키텍처

시스템은 다음과 같은 계층으로 구성됩니다:

1. 저장 계층: 메모리 항목을 영구적으로 저장하고 출처 정보를 유지합니다.
2. 제어 계층: 권한 게이트를 통해 접근을 관리하고 의미론적 성숙 프로세스를 조정합니다.
3. 검색 계층: 인덱싱 및 검색 알고리즘을 통해 효율적인 정보 검색을 제공합니다.
4. 통합 계층: Hermes 및 OpenClaw와 같은 외부 런타임과의 연결을 담당합니다.

라이선스

이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여됩니다.