Files

Contributor 5d5336757d feat: HaBraid v0.1.0 — host-following memory visualization engine for Obsidian

- Hybrid BM25 + HNSW vector search with context enrichment
- Knowledge graph with entities, relations, and community detection
- Host-following LLM route with fallback backends
- 3-tier lint system (static + HNSW dup + contradiction detection)
- Q&A Synthesis (Karpathy LLM Wiki pattern)
- 16 MCP tools for agent-driven workflows
- Incremental wiki generation with checkpointing
- SQLite-backed item store with FTS5 + vector indexes

2026-04-18 15:46:42 +09:00

3.1 KiB

Raw Permalink Blame History

설정 파일 레퍼런스

위치

기본 경로:

~/.habraid/data/config.json

하위 호환 / 명시 실행 경로:

HABRAID_CONFIG=/path/to/config.json
WIKI_ENGINE_CONFIG=/path/to/config.json
레거시 fallback: ~/.habraid/config.json, ~/.config/habraid/config.json

스키마

interface WikiEngineConfig {
  vault: {
    path: string;
    git_remote?: string;
    branch: string;
  };
  db: {
    path: string;
  };
  mempalace: {
    enabled: boolean;
    path: string;
  };
  llm: {
    mode: "host" | "standalone";
    preferences?: {
      priority?: "fast" | "balanced" | "smart";
    };
    fallback?: {
      provider: "openai" | "zai" | "glm" | "ollama";
      model: string;
      api_url: string;
      api_key_env: string;
      max_tokens: number;
    };

    // legacy compatibility fields
    provider: string;
    model: string;
    api_url: string;
    api_key_env: string;
    max_tokens: number;
  };
  sync: {
    timezone: string;
  };
}

권장 기본값

{
  "vault": {
    "path": "~/wiki",
    "branch": "main"
  },
  "db": {
    "path": "~/.habraid/data/habraid.db"
  },
  "mempalace": {
    "enabled": true,
    "path": ""
  },
  "llm": {
    "mode": "host",
    "preferences": {
      "priority": "balanced"
    },
    "fallback": {
      "provider": "zai",
      "model": "glm-5.1",
      "api_url": "https://api.example.com/v1",
      "api_key_env": "GLM_API_KEY",
      "max_tokens": 4096
    },
    "provider": "zai",
    "model": "glm-5.1",
    "api_url": "https://api.example.com/v1",
    "api_key_env": "GLM_API_KEY",
    "max_tokens": 4096
  },
  "sync": {
    "timezone": "Asia/Seoul"
  }
}

동작 원칙

`llm.mode = "host"`

host(Hermes/OpenClaw/Codex CLI)가 가능하면 추론을 담당
host bridge가 unavailable이면 llm.fallback 사용
hw_status / sync state에 마지막 route/provider/model이 기록될 수 있음

`llm.mode = "standalone"`

habraid가 직접 backend 호출
legacy config(provider/model/api_url/api_key_env)는 fallback 정보를 제공한다.
mode를 명시하지 않은 기존 config도 기본적으로 host-first로 해석되고, legacy llm 필드는 fallback/runtime metadata로 유지된다.

레거시 설정 예시

다음 형태도 계속 읽을 수 있다.

{
  "llm": {
    "provider": "zai",
    "model": "glm-5.1",
    "api_url": "https://api.example.com/v1",
    "api_key_env": "GLM_API_KEY",
    "max_tokens": 4096
  }
}

이 경우 내부 normalize 시 standalone-compatible runtime config로 변환된다.

설정 파일 로드 순서

explicit path (loadConfig(path) 또는 CLI --config)
WIKI_ENGINE_CONFIG
HABRAID_CONFIG
~/.habraid/data/config.json
legacy fallback (~/.habraid/config.json, ~/.config/habraid/config.json)
built-in defaults

API 키

.env 검색 경로:

~/.hermes/.env
~/.openclaw/.env
./.env

예시:

GLM_API_KEY=***
OPENAI_API_KEY=***
OPENROUTER_API_KEY=***

실제 사용하는 키는 선택된 standalone backend 또는 fallback의 api_key_env를 따른다.

3.1 KiB Raw Permalink Blame History