Setup on Ghafoor's Personal Blog

Getting Started Checklist

noreply@example.com (AG Sayyed) — Fri, 08 May 2026 00:00:00 +0000

Dictionary Video-to-Vocabulary: Getting Started Checklist

⚡ Quick Start (Copilot Method - 15 minutes)

Prerequisites

Have a YouTube video URL you want to learn from
Have GitHub Copilot Chat or ChatGPT access

Steps

Install youtube-transcript-api: pip install youtube-transcript-api
Get video transcript: youtube-transcript-api VIDEO_ID --format text > transcript.txt
Read /docs/dictionary/02-workflows/copilot-integration/
Copy the main prompt template
Replace [TOPIC] with your topic
Replace [TRANSCRIPT] with your transcript
Paste into Copilot Chat
Wait for YAML output
Copy output to data/dictionary/[topic]/vocabulary.yaml
Validate YAML: python -c "import yaml; yaml.safe_load(open('data/dictionary/[topic]/vocabulary.yaml'))"
Create Hugo page: hugo new content/docs/dictionary/[topic]/index.md --kind dictionary
Edit Hugo page to reference your topic
Test: npm run dev:memory
Visit: http://localhost:1313/docs/dictionary/[topic]/
Review and edit Urdu translations
Commit: git add data/dictionary/ content/docs/dictionary/ && git commit -m "Add vocabulary from [video]"

Estimated Time: 15-20 minutes

Getting Started

noreply@example.com (AG Sayyed) — Fri, 08 May 2026 00:00:00 +0000

Getting Started

Everything you need to set up the Dictionary system and begin extracting vocabulary.

📖 Documentation in This Section

Setup Guide - Environment setup and installation
Setup Checklist - Step-by-step verification

🎯 Prerequisites

Hugo installed and working
Conda environment setup (ags-dictionary)
YouTube Transcript API access
Copilot or ChatGPT access for vocabulary extraction
Git for version control

⚡ Quick Path

New to the system? Follow this path:

Read Setup Guide
Run Setup Checklist

Then move to Workflows for your first vocabulary extraction.

Quick Reference

noreply@example.com (AG Sayyed) — Fri, 08 May 2026 00:00:00 +0000

Dictionary Extraction - Quick Commands

✅ Easy Ways to Run the Script (From Anywhere!)

Method 1: Using Shell Script (Recommended - Simplest!)

From ANY directory in your project:

1# Activate your conda environment first
2conda activate ags-dictionary
3
4# Run from anywhere (the script will handle paths)
5/home/ag-sayyed/Documents/projects/hbstack/ghafoors-blog/scripts/dictionary/dict-extract.sh \
6 --video-url "https://www.youtube.com/watch?v=9M_dq_0ljsc" \
7 --topic "capitalism" \
8 --create-hugo-page \
9 --source-name "Capitalism is not natural"

Or create an alias in your ~/.bashrc:

1# Add this to ~/.bashrc
2alias dict-extract="/home/ag-sayyed/Documents/projects/hbstack/ghafoors-blog/scripts/dictionary/dict-extract.sh"
3
4# Then you can run from anywhere:
5dict-extract --video-url "URL" --topic "my-topic" --create-hugo-page

Method 2: Using Python Wrapper

1conda activate ags-dictionary
2
3# From project root
4python scripts/dictionary/extract_vocab.py \
5 --video-url "https://www.youtube.com/watch?v=9M_dq_0ljsc" \
6 --topic "capitalism" \
7 --create-hugo-page \
8 --source-name "Capitalism is not natural"

Method 3: From Project Root (Traditional)

1conda activate ags-dictionary
2cd /home/ag-sayyed/Documents/projects/hbstack/ghafoors-blog
3
4python scripts/dictionary/extract_vocabulary.py \
5 --video-url "https://www.youtube.com/watch?v=9M_dq_0ljsc" \
6 --topic "capitalism" \
7 --create-hugo-page \
8 --source-name "Capitalism is not natural"

🔑 Environment Setup

One-time Setup

The following is not needed as I am using Github Copilot paid account, but I am keeping it here for reference and for anyone else who might use this project.

Setup Guide

noreply@example.com (AG Sayyed) — Fri, 08 May 2026 00:00:00 +0000

Setup Guide

🎉 SOLVED: Easy Script Execution from Anywhere

✅ What Was Fixed

Problem: Running scripts from wrong directories with complex relative paths and missing dependencies.

Solution:

✅ Installed all required Python packages in your ags-dictionary conda environment
✅ Created wrapper scripts that work from ANY directory
✅ Clear documentation and aliases

🚀 How to Use Now

⭐ Recommended Method (Easiest!)

From ANY directory in your project:

1# 1. Activate your conda environment
2conda activate ags-dictionary
3
4# 2. Run the wrapper script (absolute path)
5/home/ag-sayyed/Documents/projects/hbstack/ghafoors-blog/scripts/dictionary/dict-extract.sh \
6 --video-url "https://www.youtube.com/watch?v=9M_dq_0ljsc" \
7 --topic "capitalism" \
8 --create-hugo-page \
9 --source-name "Capitalism is not natural"

That’s it! The script handles all paths correctly.

Kubernetes Setup

noreply@example.com (AG Sayyed) — Tue, 15 Jul 2025 17:51:43 +0000

The guide walks through deploying a Kubernetes lab with MicroK8s, installing add-ons, and testing basic workloads. Key steps include cluster initialization, Helm usage, and dashboard access.

Kubernetes local Installation

Kubernetes can be installed locally on a desktop mahcine. There are many ways to do this, but one of the most popular and easiest methods is to use MicroK8s. MicroK8s is a lightweight, production-grade Kubernetes distribution that can be installed on Linux systems, including Ubuntu. Other distructions are Minikube, K3s and kubeadm. These tools provide a simplified way to run Kubernetes clusters on local machines, making them ideal for development and testing purposes. Another popular distro is Docker Desktop/Rancher Desktop, it is good for Desktop users. They all can be setup with a single-node cluster known as light-weight or a multi-node cluseter setup.