Skip to content

Instantly share code, notes, and snippets.

View quanhua92's full-sized avatar

Quan Hua quanhua92

  • Ho Chi Minh city, Vietnam
View GitHub Profile
@quanhua92
quanhua92 / AGENTS.md
Last active July 9, 2026 02:32
FORMAT-CONCEPT-BOOK.md

AGENTS.md — Roadmap Curriculum Builder

This repo produces multi-concept learning roadmaps that bridge online courses to a build-from-scratch project (ZeroServe). Each roadmap is a single Markdown file converted to PDF.

Repo layout

roadmap/
├── FORMAT.md                 # Per-concept template (READ FIRST)
├── zeroserve-in-public.md # LLM inference engine curriculum (101 concepts)
@quanhua92
quanhua92 / P0.md
Last active June 29, 2026 15:29
OpenVideoKit web — 8-phase build plan (P0–P7): TanStack Router + React 19 + Tailwind v4 + shadcn/ui, CapCut-style responsive studio, AI-first-class editor

Phase P0 — Foundation

App boots, routes navigate, mock data layer in place, AI/EditBus primitive types defined. Studio route renders an empty shell.

Problem

Before this phase, ovk-web/ is a bare Vite + React 19 + TanStack Router scaffold with several blockers that make every later phase harder:

  1. Duplicate router wiring. src/router.tsx and src/main.tsx both create a router with subtly different options (defaultPreloadStaleTime only in router.tsx). One is dead code; later phases won't know which to extend.
  2. No providers. No Query provider (server state), no Toast provider (feedback), no Renderer provider (DI seam from bundle §9). Every feature phase would have to retrofit its own.
@quanhua92
quanhua92 / 01_01_01_01_transformer_in_one_diagram.md
Last active June 29, 2026 14:18
LLM Fundamentals Curriculum (Units 1.1-1.9)

1.1 The Transformer in One Diagram

The map. After this, "the model" is never a black box again. Prerequisites: none · Pays off in: everything · Video: T1


The One Diagram

The complete forward pass of a GPT-style transformer — from input token IDs at the bottom to the output next token at the top.

@quanhua92
quanhua92 / DEV_hyperframes.md
Last active August 1, 2026 15:25
RESEARCH notes

HyperFrames — Developer & Contributor Guide

A working engineer's reference for the HyperFrames open-source video framework (Apache 2.0). Covers the architecture from high-level package flow down to the deterministic capture loop, shows how to build videos programmatically with the SDK, and walks through a flagship contribution: centralizing the duplicated skill-layer TTS providers into the CLI and adding Gemini TTS via OpenRouter as a new audio provider.

All claims below are grounded in source files in the cloned repo at /Volumes/data/workspace/video/hyperframes/. File references use path:line form. Where a fact is inferred rather than read directly, it is called out.

@quanhua92
quanhua92 / 00_Foundations.md
Last active June 16, 2026 14:52
ZeroServe Learning Journey Guides

Part 0: The Foundations of LLM Systems

Goal: Build a mathematically perfect Transformer block from scratch, guided by tiny-llm (MLX/Apple Silicon) and nanoGPT (PyTorch/eager).

graph LR
    subgraph loop ["Autoregressive Loop"]
        A[Input Tokens] --> B[Embedding Lookup]
        B --> C[N x Transformer Blocks]
        C --> D[Final RMSNorm]
        D --> E[LM Head]
@quanhua92
quanhua92 / fastmcp-integration-guide.md
Created June 14, 2026 18:23
fastapi-fastmcp-asyncpq-alembic-guide.md

FastMCP Integration Guide

How to build MCP servers with FastMCP 3.x and mount them inside FastAPI.

Reference: The complete FastMCP documentation index is available at https://gofastmcp.com/llms.txt. Fetch it to discover all available pages, API references, and integration guides.


@quanhua92
quanhua92 / docker-compose.yml
Last active April 23, 2026 01:45
docker compose socks5 proxy
version: '3'
services:
socks5:
image: serjs/go-socks5-proxy
container_name: socks5
restart: always
# Host mode bypasses the Docker bridge, solving the IPv6 'network unreachable' bug
network_mode: "host"
env_file: .env
@quanhua92
quanhua92 / k3s_or_nomad.md
Last active February 25, 2026 04:15
HA Nomad Cluster

Nomad generally uses less CPU and RAM than K3s for the same basic cluster functionality. Nomad is widely regarded as one of the most efficient and lightweight orchestrators available.

For your 5-VPS setup, Nomad's single-binary, minimal approach will result in lower resource utilization and operational overhead compared to K3s, which, despite being "lightweight," still runs the full set of Kubernetes control plane components.

⚖️ Nomad vs. K3s Resource Footprint

The difference in resource consumption stems from the architectural complexity of the two systems.

Resource Nomad Agent (Server/Client) K3s Agent / Server
@quanhua92
quanhua92 / whitelist_bunny.sh
Created August 10, 2022 06:55
Add Bunny.net Edge Server IP Address to UFW firewall
#!/bin/sh
curl -s https://bunnycdn.com/api/system/edgeserverlist -H "Accept: application/json" | jq -r .[] > /tmp/bunny_ips
echo "" >> /tmp/bunny_ips
curl -s https://bunnycdn.com/api/system/edgeserverlist/ipv6 -H "Accept: application/json" | jq -r .[] >> /tmp/bunny_ips
for ip in `cat /tmp/bunny_ips`; do ufw allow proto tcp from $ip comment 'Bunny IP'; done;
@quanhua92
quanhua92 / racknerd_vps_yabs_results.txt
Created December 22, 2021 13:45
Racknerd Blackfriday VPS 3 Cores 4GB Ram 75GB SSD
curl -sL yabs.sh | bash -s -- -r9
3x vCPU Cores
75 GB PURE SSD RAID-10 Storage
4 GB RAM
10,000GB Monthly Premium Bandwidth
1Gbps Public Network Port
Full Root Admin Access
1 Dedicated IPv4 Address
KVM / SolusVM Control Panel - Reboot, Reinstall, Manage rDNS, & much more