Configuration

hello@ghafoorsblog.com (AG Sayyed) — Mon, 09 Nov 2026 00:00:00 +0000

Configuration

Graphify configuration file options, environment variables, and runtime settings.

📁 Config File Locations

Location	Scope	Priority
`~/.config/graphify/config.yaml`	Global (all projects)	Low
`.graphify.yaml`	Project root	Medium
`--config PATH`	CLI argument	High

📝 Config File Format (YAML)

 1# ~/.config/graphify/config.yaml
 2
 3# Model settings
 4model:
 5 path: ~/.cache/graphify/model.gguf # Local LLM model path
 6 n_ctx: 8192 # Context window
 7 n_gpu_layers: -1 # -1 = all on GPU; 0 = CPU only
 8 n_threads: 8 # CPU threads for inference
 9 verbose: false # Model debug output
10
11# Extraction settings
12extraction:
13 max_file_size_mb: 10 # Skip files larger than this
14 skip_binary: true # Auto-skip binary files
15 include_patterns: [] # Additional include globs
16 exclude_patterns: [] # Additional exclude globs
17 parallel_workers: 16 # AST extraction workers
18
19# LLM settings (for full graph)
20llm:
21 provider: gemini # gemini, openai, anthropic, moonshot, deepseek
22 api_key_env: GEMINI_API_KEY # Env var name for API key
23 model: gemini-1.5-flash # Model name
24 temperature: 0.1 # Generation temperature
25 max_tokens: 4096 # Max output tokens
26 timeout: 60 # Request timeout (seconds)
27
28# Activity tracking
29activity:
30 enabled: true # Enable activity signaling
31 path: ~/.graphify-stats # Activity data directory
32 auto_signal: true # Auto-touch .graphify-activity
33
34# Output settings
35output:
36 graph_path: graphify-out/graph.json # Graph file location
37 report_path: graphify-out/GRAPH_REPORT.md
38 html_path: graphify-out/graph.html
39 cluster_resolution: 1.0 # Community detection resolution
40 min_community_size: 3 # Min nodes per community
41
42# Logging
43logging:
44 level: INFO # DEBUG, INFO, WARN, ERROR
45 file: '' # Empty = stderr only
46 format: text # text, json

🌍 Environment Variables

Variable	Description	Default
`GEMINI_API_KEY`	Google Gemini API key	—
`GOOGLE_API_KEY`	Alias for Gemini	—
`OPENAI_API_KEY`	OpenAI API key	—
`ANTHROPIC_API_KEY`	Anthropic API key	—
`MOONSHOT_API_KEY`	Moonshot/Kimi API key	—
`DEEPSEEK_API_KEY`	DeepSeek API key	—
`GRAPHIFY_CONFIG`	Custom config file path	`~/.config/graphify/config.yaml`
`GRAPHIFY_CACHE_DIR`	Model/cache directory	`~/.cache/graphify`
`GRAPHIFY_GRAPH_PATH`	Graph output path	`graphify-out/graph.json`
`GRAPHIFY_VERBOSE`	Enable verbose logging	`false`
`GRAPHIFY_CODE_ONLY`	Force code-only mode	`false`

⚙️ CLI Overrides

All config options can be overridden via CLI flags:

Config on Ghafoor's Personal Blog

Configuration

Configuration

📁 Config File Locations

📝 Config File Format (YAML)

🌍 Environment Variables

⚙️ CLI Overrides