SeedOS n8n Custom Node

SeedOS Memory System을 n8n 워크플로우에 통합하는 Custom Node입니다.

🎯 기능

• Store Memory: 메모리 블록 저장
• Search Memory: 의미 기반 메모리 검색
• Query with AI: Thalamic AI를 사용한 쿼리
• Create Identity: AI Identity 생성
• Verify Proof: Merkle Proof 검증

📦 설치

n8n에서 설치

# n8n 커뮤니티 노드로 설치
npm install @seedos/n8n-nodes-seedos

또는 n8n UI에서:

1. Settings → Community Nodes
2. "Install community node" 클릭
3. @seedos/n8n-nodes-seedos 입력
4. Install 클릭

🚀 빠른 시작

1. SeedOS 서버 준비

# Docker로 실행
docker-compose up -d

# 또는 로컬에서 실행
uvicorn app.api:app --reload

2. n8n에서 노드 사용

1. 워크플로우에 "SeedOS" 노드 추가
2. Credentials 설정:
   • API Key: your-secret-api-key-here (또는 설정한 키)
   • Base URL: http://localhost:8000
3. Operation 선택 (Store, Search, Query, Identity, Proof)
4. 파라미터 입력 및 실행

📋 Operations

Store Memory

메모리 블록을 저장합니다.

파라미터:

• layer: 메모리 레이어 (예: "memory")
• type: 블록 타입 (예: "event")
• payload: 저장할 데이터 (JSON 객체)

예시:

{
  "layer": "memory",
  "type": "event",
  "payload": {
    "text": "Important meeting notes",
    "date": "2026-01-21"
  }
}

Search Memory

의미 기반으로 메모리를 검색합니다.

파라미터:

• query: 검색 쿼리
• topK: 반환할 결과 수 (기본: 5)

Query with AI

Thalamic AI를 사용하여 메모리 기반 응답을 생성합니다.

파라미터:

• question: 질문
• llmProvider: LLM 제공업체 (openai, anthropic)
• model: 모델 이름 (예: "gpt-4")

주의: LLM API Key가 SeedOS 서버에 설정되어 있어야 합니다.

Create Identity

AI Identity를 생성합니다.

파라미터:

• name: Identity 이름 (영문, 숫자, -, _만 사용)
• purpose: 목적 (최소 10자)
• coreValues: 핵심 가치 (comma-separated)
• role: 역할 (선택)

Verify Proof

Merkle Proof를 검증합니다.

파라미터:

• address: 블록 주소 (MMP 형식)
• leafIndex: 리프 인덱스
• leaves: Merkle tree leaves (JSON 배열)
• leafValue: 검증할 리프 값

📚 워크플로우 템플릿

5개의 워크플로우 템플릿이 제공됩니다:

1. Simple Memory Storage - 기본 메모리 저장
2. Semantic Memory Search - 의미 기반 검색
3. AI Memory Assistant - AI 어시스턴트
4. Identity Management - Identity 관리
5. Complete Memory Loop - 완전한 메모리 루프

템플릿은 workflow_templates/ 디렉토리에 있으며, n8n에서 직접 import할 수 있습니다.

자세한 내용은 워크플로우 템플릿 가이드를 참조하세요.

🔧 개발

# 의존성 설치
npm install

# 빌드
npm run build

# 개발 모드 (watch)
npm run dev

# 린트
npm run lint
npm run lintfix

🔗 API 엔드포인트

SeedOS API 엔드포인트:

• POST /write - 메모리 블록 저장
• POST /search - 의미 기반 검색
• POST /query - AI 쿼리
• POST /identity - Identity 생성
• POST /proof - Merkle Proof 검증
• GET /read - 메모리 블록 읽기
• GET /health - Health check

📖 추가 문서

• 워크플로우 템플릿 가이드
• 로컬 개발 가이드
• 테스트 가이드
• npm 발행 가이드

🐛 문제 해결

"Invalid API key" 오류

• SeedOS 서버가 실행 중인지 확인
• API Key가 올바른지 확인
• Credentials 설정 확인

"Identity not found" 오류

• Identity가 생성되었는지 확인
• 필요시 Identity 생성 워크플로우 실행

"Search failed" 오류

• Identity가 생성되어 있는지 확인
• 메모리가 저장되어 있는지 확인

📝 라이선스

MIT

🔗 관련 링크

• SeedOS GitHub
• SeedOS API 문서
• n8n 문서