Skip to content
View AnranS's full-sized avatar
🎯
Focusing
🎯
Focusing

Block or report AnranS

Block user

Prevent this user from interacting with your repositories and sending you notifications. Learn more about blocking users.

You must be logged in to block users.

Content in all repositories owned by your account will be closed.
Maximum 250 characters. Please don’t include any personal information such as legal names or email addresses. Markdown is supported. This note will only be visible to you.
Report abuse

Contact GitHub support about this user’s behavior. Learn more about reporting abuse.

Report abuse
AnranS/README.md

Anran — learning Transformer inference and ML systems from first principles

Hi, I'm Anran 👋

I'm learning modern AI systems by rebuilding Transformer inference from first principles.

AI learning · Roadmap · Selected projects · Toolbox

My current focus is not just using models, but understanding what happens between tokens and generated text. I turn each topic into small implementations, tests, notebooks, concept notes, and benchmarks—and keep the whole learning trail public.

AI learning, in public

From Tokenizer to KV Cache, I'm building a Llama-style decoder-only inference engine step by step—starting from the math, making every tensor shape explicit, and verifying each layer before moving on.

This is a 40-unit, test-driven learning path toward Hugging Face numerical parity and reproducible Prefill/Decode performance analysis.

Start learning → · 40-unit roadmap · Source · Tests

Python PyTorch Transformers pytest Jupyter

Current checkpoint

Day 9 / 40

Built:
Embeddings, LM Head, autoregressive generation, causal and padding masks, multi-head attention.

Next gate:
Hugging Face LlamaAttention numerical alignment.

The live checkpoint is maintained in the learning repository.

Graduation criteria

  • Match final logits with the Hugging Face reference implementation
  • Produce identical generation results with and without KV Cache
  • Publish reproducible Prefill/Decode benchmarks and performance analysis

Learning roadmap

Stage Focus Evidence I want to produce
01 · Foundations — built Tokenizer, embeddings, LM Head, autoregressive generation Shape contracts, notebooks, unit tests
02 · Model internals — now Attention, RMSNorm, SwiGLU, RoPE, decoder blocks Layer-by-layer numerical alignment
03 · Efficient inference — next Sampling, padding, Prefill, Decode, KV Cache Cache/no-cache correctness parity
04 · ML systems — next GQA, benchmarks, profiler, memory analysis A reproducible performance report

My learning loop is deliberately engineering-heavy: derive the operation, inspect the shapes, implement the smallest correct version, lock it down with tests, compare against a trusted reference, and only then optimize it.

Selected projects

Alongside the inference engine, these projects show how I turn learning into reusable material and ship systems-focused products:

A self-contained AI learning path with 40 units, 28 day guides, concept notes, executable notebooks, test-driven implementations, and explicit graduation gates.

AI Learning Notebooks TDD

A native macOS WidgetKit dashboard for system health, weather, and privacy-conscious Codex, Cursor, Claude Code, and Grok usage snapshots.

Swift SwiftUI WidgetKit

A profile-guided Rust splitter and TypeScript runtime for loading large WebAssembly modules in hot and cold stages.

Rust WebAssembly TypeScript

Export Godot 4 projects to WeChat, Douyin, and TikTok Mini Games through an editor-native, CI-validated WebAssembly toolchain.

Godot GDScript WebAssembly

Toolbox

Python, PyTorch, Rust, WebAssembly, TypeScript, Node.js, Swift, Godot, PostgreSQL, Docker, Git, and GitHub Actions

Transformer inference · ML systems · runtime engineering · developer tooling


Learning in public, one verified tensor shape at a time.

Pinned Loading

  1. repo-maestro repo-maestro Public

    A workflow orchestrator for changes that span many repos — plan a dependency-ordered DAG, run with contract gates and verification, recover on failure. Local-first.

    Rust

  2. godot_for_minigame godot_for_minigame Public

    Godot 4 plugin for exporting games to WeChat and Douyin mini games

    JavaScript 46 10

  3. tiktok-minigame-unity-demo tiktok-minigame-unity-demo Public

    Reference Unity 2022.3 demo for the TikTok Mini Game SDK — covers every TT.* API across 14 categories, with bilingual code comments and README.

    C# 8

  4. inline-vocab-translator inline-vocab-translator Public

    Inline vocabulary translator for Chinese → English. Selection translate, auto-highlight unmastered words, multi-device sync via GitHub Gist or Google Drive.

    JavaScript 4 1

  5. wallpaper wallpaper Public

    wallpaper for mac

    TypeScript

  6. deepcoldy/botmux deepcoldy/botmux Public

    Bridge Feishu/Lark to AI coding CLIs — Claude Code, Codex, Gemini, OpenCode… every DM, group or topic spawns its own live-streaming CLI session

    TypeScript 1.3k 264