Files
TinyTorch/site/intro.md
Vijay Janapa Reddi 5597e600f0 Simplify pip install indicator to inline coming soon text
- Remove separate badge, add inline (coming soon) text
- Cleaner design that works with existing under construction banner
2025-11-14 18:33:47 -05:00

13 KiB
Raw Blame History

Build Your Own ML Framework

Don't just import it. Build it.

Build a complete machine learning (ML) framework from tensors to systems—understand how PyTorch, TensorFlow, and JAX really work under the hood.

<!-- Install Command - Compact Claude Code style -->
<div style="text-align: center; margin: 1.5rem auto 2rem auto;">
  <div style="display: inline-block; background: #f8fafc; border: 1px solid #e2e8f0; border-radius: 0.375rem; padding: 0.5rem 1rem; font-family: 'Monaco', 'Menlo', 'Courier New', monospace; font-size: 0.875rem; color: #334155; box-shadow: 0 1px 2px rgba(0,0,0,0.05);">
    <span style="color: #94a3b8;">$</span> pip install tinytorch <span style="color: #94a3b8; font-style: italic;">(coming soon)</span>
  </div>
</div>

<!-- Hero GIF Carousel - Compact Design -->
<div class="hero-carousel-compact">
  <div class="carousel-track">
    <div class="carousel-item active">
      <div class="gif-preview">
        <div class="preview-icon">🚀</div>
      </div>
      <div class="carousel-text">
        <h4>Setup & First Run</h4>
        <p>From zero to ready in 2 minutes</p>
      </div>
    </div>

    <div class="carousel-item">
      <div class="gif-preview">
        <div class="preview-icon">⚙️</div>
      </div>
      <div class="carousel-text">
        <h4>Complete a Module</h4>
        <p>Build → Test → Ship workflow</p>
      </div>
    </div>

    <div class="carousel-item">
      <div class="gif-preview">
        <div class="preview-icon">🏆</div>
      </div>
      <div class="carousel-text">
        <h4>Run a Milestone</h4>
        <p>Your code recreates ML history</p>
      </div>
    </div>

    <div class="carousel-item">
      <div class="gif-preview">
        <div class="preview-icon">💡</div>
      </div>
      <div class="carousel-text">
        <h4>The "Aha!" Moment</h4>
        <p>You built this, not imported it</p>
      </div>
    </div>
  </div>

  <div class="carousel-nav">
    <button class="nav-arrow prev" onclick="moveCarousel(-1)">←</button>
    <div class="carousel-indicators">
      <span class="indicator active" onclick="currentSlide(0)"></span>
      <span class="indicator" onclick="currentSlide(1)"></span>
      <span class="indicator" onclick="currentSlide(2)"></span>
      <span class="indicator" onclick="currentSlide(3)"></span>
    </div>
    <button class="nav-arrow next" onclick="moveCarousel(1)">→</button>
  </div>
</div>

Getting Started

TinyTorch is organized into four progressive tiers that take you from mathematical foundations to production-ready systems. Each tier builds on the previous one, teaching you not just how to code ML components, but how they work together as a complete system.

Complete course structureDaily workflow guideJoin the community

Recreate ML History

Walk through ML history by rebuilding its greatest breakthroughs with YOUR TinyTorch implementations. Click each milestone to see what you'll build and how it shaped modern AI.

<div class="ml-timeline-container">
    <div class="ml-timeline-line"></div>

    <div class="ml-timeline-item left perceptron">
        <div class="ml-timeline-dot"></div>
        <div class="ml-timeline-content">
            <div class="ml-timeline-year">1957</div>
            <div class="ml-timeline-title">The Perceptron</div>
            <div class="ml-timeline-desc">The first trainable neural network</div>
            <div class="ml-timeline-tech">Input → Linear → Sigmoid → Output</div>
        </div>
    </div>

    <div class="ml-timeline-item right xor">
        <div class="ml-timeline-dot"></div>
        <div class="ml-timeline-content">
            <div class="ml-timeline-year">1969</div>
            <div class="ml-timeline-title">XOR Crisis Solved</div>
            <div class="ml-timeline-desc">Hidden layers unlock non-linear learning</div>
            <div class="ml-timeline-tech">Input → Linear → ReLU → Linear → Output</div>
        </div>
    </div>

    <div class="ml-timeline-item left mlp">
        <div class="ml-timeline-dot"></div>
        <div class="ml-timeline-content">
            <div class="ml-timeline-year">1986</div>
            <div class="ml-timeline-title">MLP Revival</div>
            <div class="ml-timeline-desc">Backpropagation enables deep learning (95%+ MNIST)</div>
            <div class="ml-timeline-tech">Images → Flatten → Linear → ... → Classes</div>
        </div>
    </div>

    <div class="ml-timeline-item right cnn">
        <div class="ml-timeline-dot"></div>
        <div class="ml-timeline-content">
            <div class="ml-timeline-year">1998</div>
            <div class="ml-timeline-title">CNN Revolution 🎯</div>
            <div class="ml-timeline-desc">Spatial intelligence unlocks computer vision (75%+ CIFAR-10)</div>
            <div class="ml-timeline-tech">Images → Conv → Pool → ... → Classes</div>
        </div>
    </div>

    <div class="ml-timeline-item left transformer">
        <div class="ml-timeline-dot"></div>
        <div class="ml-timeline-content">
            <div class="ml-timeline-year">2017</div>
            <div class="ml-timeline-title">Transformer Era</div>
            <div class="ml-timeline-desc">Attention launches the LLM revolution</div>
            <div class="ml-timeline-tech">Tokens → Attention → FFN → Output</div>
        </div>
    </div>

    <div class="ml-timeline-item right olympics">
        <div class="ml-timeline-dot"></div>
        <div class="ml-timeline-content">
            <div class="ml-timeline-year">2018</div>
            <div class="ml-timeline-title">MLPerf Benchmarks </div>
            <div class="ml-timeline-desc">Production optimization (8-16× smaller, 12-40× faster)</div>
            <div class="ml-timeline-tech">Profile → Compress → Accelerate</div>
        </div>
    </div>
</div>

View complete milestone details to see full technical requirements and learning objectives.

Why Build Instead of Use?

Understanding the difference between using a framework and building one is the difference between being limited by tools and being empowered to create them.

Traditional ML Education

import torch
model = torch.nn.Linear(784, 10)
output = model(input)
# When this breaks, you're stuck

Problem: OOM errors, NaN losses, slow training—you can't debug what you don't understand.

TinyTorch Approach

from tinytorch import Linear  # YOUR code
model = Linear(784, 10)       # YOUR implementation
output = model(input)
# You know exactly how this works

Advantage: You understand memory layouts, gradient flows, and performance bottlenecks because you implemented them.

Systems Thinking: TinyTorch emphasizes understanding how components interact—memory hierarchies, computational complexity, and optimization trade-offs—not just isolated algorithms. Every module connects mathematical theory to systems understanding.

See Course Philosophy for the full origin story and pedagogical approach.

The Build → Use → Reflect Approach

Every module follows a proven learning cycle that builds deep understanding:

graph LR
    B[Build<br/>Implement from scratch] --> U[Use<br/>Real data, real problems]
    U --> R[Reflect<br/>Systems thinking questions]
    R --> B

    style B fill:#FFC107,color:#000
    style U fill:#4CAF50,color:#fff
    style R fill:#2196F3,color:#fff
  1. Build: Implement each component yourself—tensors, autograd, optimizers, attention
  2. Use: Apply your implementations to real problems—MNIST, CIFAR-10, text generation
  3. Reflect: Answer systems thinking questions—memory usage, scaling behavior, trade-offs

This approach develops not just coding ability, but systems engineering intuition essential for production ML.

Is This For You?

Perfect if you want to debug ML systems, implement custom operations, or understand how PyTorch actually works.

Prerequisites: Python + basic linear algebra. No prior ML experience required.


Next Steps: Quick Start Guide (15 min) • Course StructureFAQ