Getting Started on Ghafoor's Personal Blog

First Query

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

First Query

Your first Graphify architecture question — from signal to answer.

Prerequisites

Graphify installed (uv tool install graphifyy && graphify install)
Graph built (graphify . --code-only in your project root)
In your project directory

The Golden Rule: Signal Activity

Before EVERY Graphify command, you must signal activity:

1mkdir -p graphify-out && touch graphify-out/.graphify-activity

This is required by the GraphifyStats VS Code extension and prevents stale data warnings.

Your First Query

1# 1. Signal activity
2mkdir -p graphify-out && touch graphify-out/.graphify-activity
3
4# 2. Ask an architecture question
5graphify query "project overview"

Expected Output

This project is a Hugo + HBStack site for a personal blog with course content.
The codebase includes:

**Core Systems:**
- Dictionary/vocabulary extraction pipeline (scripts/dictionary/)
- YouTube content automation (scripts/dictionary/yt-to-content-v2.py)
- Anki flashcard generation (scripts/anki/)
- CBT lexicon extraction (scripts/extract-cbt-lexicon.mjs)

**Content Structure:**
- Courses under content/courses/ags/ (spirituality, storytelling)
- Docs under content/docs/ (dictionary, anki, tutorials, lexicon)
- JupyterLite integration for interactive notebooks

**Build Pipeline:**
- Hugo with HBStack theme
- Task-based automation (Taskfile.yaml)
- Custom shortcodes for accordions, vocabulary, diagrams

Understanding the Output

Element	Meaning
Natural language answer	Graphify synthesizes findings into readable text
File references	Specific paths cited (e.g., `scripts/dictionary/yt-to-content-v2.py`)
Architectural concepts	Components, pipelines, data flows identified

Next Queries to Try

 1# Always signal activity first!
 2mkdir -p graphify-out && touch graphify-out/.graphify-activity
 3
 4# How does a specific system work?
 5graphify query "how does the youtube content pipeline work?"
 6
 7# What depends on a file?
 8graphify query "what depends on tasks/content.yaml?"
 9
10# Trace a relationship
11graphify path scripts/dictionary/yt-to-content-v2.py data/course/ags/storytelling/j-wiebe/youtube-content/course-structure.yaml
12
13# Deep-dive on a component
14graphify explain scripts/dictionary/yt-to-content-v2.py

Common Patterns

Question Type	Query Template
Architecture overview	`graphify query "project overview"`
How X works	`graphify query "how does X work?"`
Dependencies of X	`graphify query "what depends on X?"`
Relationship A→B	`graphify path A B`
Deep-dive on file	`graphify explain <file-path>`

Tips for Better Queries

Use specific names from your codebase — “yt-to-content-v2.py” not “the script”
Ask about concepts, not syntax — “how does auth work?” not “show me the login function”
Iterate — Start broad, then drill down with explain and path
Rebuild if stale — graphify update . after significant changes

Next Steps

Daily Usage - Common query patterns for development
Verification - Confirm your setup is correct

Setup Guide

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

Setup Guide

Complete installation, configuration, and troubleshooting for Graphify.

🚀 Installation

Prerequisites Check

1# Check Python version (3.10+ required)
2python3 --version
3
4# Check uv availability
5which uv
6# If not installed: curl -LsSf https://astral.sh/uv/install.sh | sh

Install Graphify

 1# Install via uv (recommended - isolated, fast)
 2uv tool install graphifyy
 3
 4# Verify installation
 5graphify --version
 6# Output: graphify 0.1.x
 7
 8# Install local LLM model (~2 GB, one-time)
 9graphify install
10# Downloads model to ~/.cache/graphify/
11# Creates ~/.claude/CLAUDE.md with instructions

Alternative: pip install

1# If uv not available
2pip install graphifyy
3graphify install

⚙️ Configuration

Project-Level (recommended)

Create .graphifyignore in project root to exclude paths:

Verification

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

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

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

✅ 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: