Engram

AI 에이전트를 위한 영구적 기하학적 메모리. 특허 출원 중 US19/372,256 — Aric Goodman & Static Rooster Media

Engram은 AI 에이전트에게 인간의 연상 기억과 직접적으로 작동하는 장기 기억을 제공합니다. 키워드가 아닌 의미로 저장하고 검색하세요. 벡터 데이터베이스도, 클라우드도, API 키도 필요 없습니다. 모델 컨텍스트 프로토콜(MCP)을 통해 로컬 머신에서 완전히 실행됩니다.

🚀 AI 네이티브 에이전트 데몬

Engram은 단순한 수동적 데이터베이스가 아닙니다. LLM IDE(Antigravity 또는 Cursor 등)에 매핑하면, 백그라운드에서 기하학적 인식을 완전히 처리하는 **에이전트 데몬(Agentic Daemon)**이 부팅됩니다:

1. 네이티브 OS 감시자: mcp_engram_watch_workspace JSON 도구를 호출하면, 데몬이 OS 수준의 커널 이벤트(inotify/fsevents)에 직접 바인딩됩니다. 귀하 또는 에이전트가 주요 코드 파일을 저장하는 즉시, Engram은 해당 벡터 청크를 매니폴드(manifold)로 즉시 재수집합니다. 귀하의 컨텍스트 윈도우는 절대 구식으로 변하지 않습니다.

2. 계층적 자가포식 GC: 매시간, 심층 비동기 Tokio 스레드가 깨어나 메모리 매니폴드를 스캔합니다. 관련 없는 일시적 상태는 자동으로 로그 감쇠됩니다(24시간 경과 시 2%, 7일 경과 시 5%). 기하학적 블록이 0.05 CRS(Coherence-Reliability Score, 일관성-신뢰도 점수) 아래로 떨어지면, 새로운 벡터를 위한 공간을 확보하기 위해 NVMe 디스크에서 영구적으로 제거됩니다.

3. 프로젝트 매트릭스 고정: mcp_engram_pin 또는 mcp_engram_remember_solution 도구를 사용하여, 연결된 LLM은 중요한 작업 보드, PR 사양 또는 버그 수정을 완벽한 1.0 CRS로 영구적으로 고정할 수 있습니다. 자가포식 데몬은 고정된 불변 항목을 절대 감쇠시키지 않도록 하드코딩되어 있습니다.

⚡ 의미론적 레이 트레이서 & NVSA 추론

Engram은 핵심 수학 엔진 내부에 **벡터 심볼릭 아키텍처(Vector Symbolic Architectures)**를 사용하므로, 귀하와 에이전트는 메모리를 추출하기 전에 복잡한 기하학적 연산을 수행할 수 있습니다.

Engram 네이티브 연산자는 Monad CodeLand NVSA 사양을 엄격히 준수합니다:

• op_deduce: 논리적 함의 제약($A \rightarrow B$)을 물리적으로 추적합니다.

• op_attend: 홀로그램을 훼손하지 않고 차원을 대규모로 감쇠시킵니다.

• op_is_symbolic_of: 역설을 ZADO-CPS 등각 토로이드 임베딩으로 끌어올려 논리적 정지 상태를 방지합니다.

• op_geometric_product: Clifford ansatz를 사용하여 직교 차원과 함께 코사인 유사도를 동시에 계산합니다.

키워드를 찾는 대신, Trace 명령을 사용하여 초차원 평면 전반에서 개념을 수학적으로 결합, 중첩 및 교차시킬 수 있습니다:

# Locate the precise `.rs` chunks where native "CUDA" overlaps contextually with "Memory"
engram-cli trace "cuda" BIND "memory"

# Find code blocks that share equivalence between two combined domains
engram-cli trace "geometric" ADD "tensor"

이러한 로고물리적 수학 경로는 CLI를 통해 로컬에서 사용할 수 있으며, 강력한 /api/trace Axum REST 경로를 통해 AI 통합에 명시적으로 노출됩니다!

💾 엔지니어링 제한 사항: NVMe O_DIRECT 블록 규칙

모든 지식 조각은 근본적으로 격리된 HolographicBlocks(.leg 파일)에 스탬프 처리됩니다. 우리는 이러한 논리적 컨테이너가 메모리 공간에서 정확히 **262,144바이트(256KB)**가 되도록 설계했습니다.

이는 임의적인 제한이 아닙니다. 정확히 256KB인 페이로드는 O_DIRECT 물리적 SSD 정렬을 위해 특별히 최적화되었습니다. 이를 통해 기하학적 텐서가 표준 운영 체제의 CPU 버퍼 캐시를 완전히 우회하고, M.2 NVMe 드라이브에서 직접 DMA(Direct Memory Access) 스트리밍되어 CUDA 또는 ROCm 커널 처리를 위해 GPU VRAM으로 전달될 수 있습니다. types.rs의 구조체 기하학을 변경하여 최신 블록 경계와 균등하게 정렬되지 않게 만들면, 기본 DMA 속도가 저하될 것입니다!

⚡ 빠른 시작 통합

지원되는 모든 IDE에 대한 통합 구성은 integrations/에서 공개적으로 추적됩니다.

설치

cargo install engram --git https://github.com/staticroostermedia-arch/engram

Google Antigravity IDE

Engram은 Google Antigravity IDE를 위한 즉시 사용 가능한 구성을 제공합니다. ~/.gemini/antigravity/mcp_config.json에 추가하십시오:

{
  "mcpServers": {
    "engram": {
      "command": "engram",
      "args": ["mcp", "--store", "~/.engram/manifold"],
      "disabled": false
    }
  }
}

Claude Desktop 통합

~/.config/claude-desktop/claude_desktop_config.json에 추가하십시오:

{
  "mcpServers": {
    "engram": {
      "command": "engram",
      "args": ["mcp", "--store", "~/.engram/manifold"]
    }
  }
}

Claude Desktop을 재시작하십시오. 즉시 다음 네이티브 도구를 사용할 수 있습니다: remember, recall, forget, list_concepts, mcp_engram_watch_workspace, mcp_engram_pin, mcp_engram_relate, mcp_engram_context_for_file, mcp_engram_remember_solution.

💻 CLI 작업 & 매니폴드 부트스트래핑

Engram을 레거시 저장소에 도입하는 경우, 코드 로그를 수동으로 파싱할 필요가 없습니다. 네이티브 재귀 청킹 엔진을 활용하십시오:

# Bootstrap an entire monolithic repository into geometric logic inside of seconds:
engram-cli ingest /path/to/monolithic-workspace --chunk-size 8000

# Store single ad-hoc memories:
engram-cli remember krebs_cycle "The Krebs cycle converts acetyl-CoA to ATP via 8 enzymatic steps"

# Interrogate memory conceptually:
engram-cli recall "how does cellular respiration produce energy"
# Prints exactly the Krebs Cycle vector, and exact code lines tied to that phase domain.

하드웨어 지원

Engram은 주요 하드웨어 아키텍처 전반에서 동일하게 네이티브로 매핑됩니다:

라이선스 및 특허

이 소프트웨어는 AGPL-3.0-only 라이선스를 따릅니다.

.LEG 컨테이너 형식은 미국 특허 출원 번호 19/372,256(계류 중)의 적용을 받습니다. 독립형 가변 파일 시스템(.LEG 컨테이너 형식), 출원인: Aric Goodman, 미국 오리건주 — Static Rooster Media.

이것은 참조 구현입니다. 상용 라이선스(SaaS/클라우드 사용 포함)를 이용할 수 있습니다. 문의: StaticRoosterMedia@gmail.com

자세한 내용은 PATENT-NOTICE.md를 참조하십시오.