Verify your Graphify installation and graph are working correctly.
Confirm your Graphify setup is working correctly at every level.
1# Check binary
2graphify --version
3# Output: graphify 0.1.x
4
5# Check model
6ls -lh ~/.cache/graphify/model.gguf
7# Should exist (~1.5-2 GB)
1cd your-project
2
3# Signal activity
4mkdir -p graphify-out && touch graphify-out/.graphify-activity
5
6# Build code-only graph
7graphify . --code-only
8
9# Verify graph file
10ls -lh graphify-out/graph.json
11# Should be > 500 KB (3.3 MB in this project)
12
13# Check node/edge counts
14graphify query "project overview" | head -5
15# Should return architectural summary
1# Signal activity
2mkdir -p graphify-out && touch graphify-out/.graphify-activity
3
4# Test basic query
5graphify query "project overview"
6
7# Test specific component
8graphify query "how does the dictionary extraction work?"
9
10# Test path tracing
11graphify path scripts/dictionary/yt-to-content-v2.py tasks/content.yaml
12
13# Test deep-dive
14graphify explain scripts/dictionary/yt-to-content-v2.py
| Command | Success Indicator |
|---|---|
graphify query "project overview" | Returns multi-paragraph architectural summary with file paths |
graphify path A B | Shows chain of nodes/edges connecting A to B |
graphify explain <file> | Shows functions, classes, imports, calls in that file |
1# Generate named communities and HTML report
2graphify cluster-only .
3
4# Check outputs
5ls -lh graphify-out/GRAPH_REPORT.md
6ls -lh graphify-out/graph.html
7
8# Open in browser
9open graphify-out/graph.html
1# Check activity marker
2cat graphify-out/.graphify-activity.json
3# Should show recent command with timestamp
4
5# Check machine config
6ls -lh ~/.graphify-stats/configured
7# Should exist (created during setup)
If using GraphifyStats:
update, initial build)graph.html 1# Requires API key (GEMINI_API_KEY, OPENAI_API_KEY, etc.)
2export GEMINI_API_KEY="your-key"
3
4# Signal activity
5mkdir -p graphify-out && touch graphify-out/.graphify-activity
6
7# Build full graph (code + docs + markdown + PDFs)
8graphify .
9
10# Verify larger graph
11ls -lh graphify-out/graph.json
12# Should be significantly larger than code-only
13
14# Test doc query
15graphify query "what does the youtube-content skill do?"
16# Should reference .github/skills/youtube-content/SKILL.md content
1#!/usr/bin/env bash
2# save as verify-graphify.sh
3
4echo "=== Graphify Health Check ==="
5
6# 1. Binary
7echo -n "Binary: "
8graphify --version 2>/dev/null && echo "✅" || echo "❌"
9
10# 2. Model
11echo -n "Model: "
12[[ -f ~/.cache/graphify/model.gguf ]] && echo "✅" || echo "❌"
13
14# 3. Graph exists
15echo -n "Graph: "
16[[ -f graphify-out/graph.json ]] && echo "✅ ($(du -h graphify-out/graph.json | cut -f1))" || echo "❌"
17
18# 4. Query works
19echo -n "Query: "
20mkdir -p graphify-out && touch graphify-out/.graphify-activity
21graphify query "test" >/dev/null 2>&1 && echo "✅" || echo "❌"
22
23# 4. Activity
24echo -n "Activity: "
25[[ -f graphify-out/.graphify-activity.json ]] && echo "✅" || echo "❌"
26
27# 5. Machine config
28echo -n "Machine config: "
29[[ -f ~/.graphify-stats/configured ]] && echo "✅" || echo "❌"
30
31echo "=== Done ==="
| Check | Failure | Fix |
|---|---|---|
| Binary | command not found | Restart shell; check PATH includes ~/.local/bin |
| Model | Missing | Run graphify install |
| Graph | < 500 bytes | Run graphify update . after adding source files |
| Query | Empty/error | Rebuild with graphify update . |
| Activity | Missing JSON | Run mkdir -p graphify-out && touch graphify-out/.graphify-activity |