Stay updated — Join the build list for tutorials and AI insights. No spam.

Verification

Verify your Graphify installation and graph are working correctly.

Verification

Confirm your Graphify setup is working correctly at every level.

✅ Level 1: Installation

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)

✅ Level 2: Graph Building

 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

✅ Level 3: Query Functionality

 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

Expected Results

CommandSuccess Indicator
graphify query "project overview"Returns multi-paragraph architectural summary with file paths
graphify path A BShows chain of nodes/edges connecting A to B
graphify explain <file>Shows functions, classes, imports, calls in that file

✅ Level 4: Visual Report

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

Graph.html Features

  • Search - Filter nodes by name
  • Communities - Color-coded groups (e.g., “YouTube Pipeline”, “Dictionary System”)
  • Node details - Click node to see file, symbols, edges
  • Zoom/pan - Navigate large graphs

✅ Level 5: Activity Tracking (GraphifyStats)

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)

VS Code Extension

If using GraphifyStats:

  • Status bar shows last command, duration, status
  • Spinner during long commands (update, initial build)
  • Click to open graph.html
  • Auto-signals activity on command run

✅ Level 6: Full Graph (Optional)

 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

📊 Quick Health Check Script

 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 ==="

🚨 Common Verification Failures

CheckFailureFix
Binarycommand not foundRestart shell; check PATH includes ~/.local/bin
ModelMissingRun graphify install
Graph< 500 bytesRun graphify update . after adding source files
QueryEmpty/errorRebuild with graphify update .
ActivityMissing JSONRun mkdir -p graphify-out && touch graphify-out/.graphify-activity

Next Steps