From 9c2f2f566366481952307379d96ebe7bb5c83a65 Mon Sep 17 00:00:00 2001 From: Safi Date: Fri, 5 Jun 2026 22:34:34 +0100 Subject: [PATCH] docs: clarify code-only extract needs no API key (#1122) Co-Authored-By: Claude Sonnet 4.6 --- README.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index b7b258d..ade5038 100644 --- a/README.md +++ b/README.md @@ -381,7 +381,7 @@ These are only needed for **headless / CI extraction** (`graphify extract`). Whe ## Privacy -- **Code files** — processed locally via tree-sitter. Nothing leaves your machine. +- **Code files** — processed locally via tree-sitter. Nothing leaves your machine. A code-only corpus requires no API key — `graphify extract` runs fully offline. - **Video / audio** — transcribed locally with faster-whisper. Nothing leaves your machine. - **Docs, PDFs, images** — sent to your AI assistant for semantic extraction (via the `/graphify` skill, using whatever model your IDE session runs). Headless `graphify extract` requires `GEMINI_API_KEY` / `GOOGLE_API_KEY` (Gemini), `MOONSHOT_API_KEY` (Kimi), `ANTHROPIC_API_KEY` (Claude), `OPENAI_API_KEY` (OpenAI), `DEEPSEEK_API_KEY` (DeepSeek), a running Ollama instance (`OLLAMA_BASE_URL`), AWS credentials via the standard provider chain (Bedrock - no API key needed, uses IAM), or the `claude` CLI binary (Claude Code - no API key needed, uses your Claude subscription). The `--dedup-llm` flag uses the same key. - **Data residency** — `graphify extract` auto-detects which provider to use based on which API key is set (priority: Gemini → Kimi → Claude → OpenAI → DeepSeek → Bedrock → Ollama). For code with data-residency requirements, use `--backend ollama` (fully local) or pass an explicit `--backend` flag. Kimi (`MOONSHOT_API_KEY`) routes to Moonshot AI servers in China. @@ -430,7 +430,7 @@ graphify query "..." Run `graphify hook install` — it sets up a git merge driver that union-merges `graph.json` automatically so conflicts never happen. **Extraction returns empty nodes/edges for docs or PDFs** -Docs and PDFs require an LLM call. Check that your API key is set and the backend is correct: +Docs, PDFs, and images require an LLM call — code-only corpora need no key. Check that your API key is set and the backend is correct: ```bash ANTHROPIC_API_KEY=sk-... graphify extract ./docs --backend claude ```