mirror of https://github.com/MLSysBook/TinyTorch.git synced 2026-08-02 22:07:52 -05:00

Files

T

Vijay Janapa ReddiandClaude 7bc4f6f835 Reorganize repository: rename docs/ to site/ for clarity

- Delete outdated site/ directory
- Rename docs/ → site/ to match original architecture intent
- Update all GitHub workflows to reference site/:
  - publish-live.yml: Update paths and build directory
  - publish-dev.yml: Update paths and build directory
  - build-pdf.yml: Update paths and artifact locations
- Update README.md:
  - Consolidate site/ documentation (website + PDF)
  - Update all docs/ links to site/
- Test successful: Local build works with all 40 pages

The site/ directory now clearly represents the course website
and documentation, making the repository structure more intuitive.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>

2025-12-04 16:31:51 -08:00

2.8 KiB

Raw Permalink Blame History

📋 NBGrader Quick Reference Card

TinyTorch + NBGrader Essential Commands for Instructors

🚀 One-Time Setup

# 1. Setup environment
python3 -m venv .venv && source .venv/bin/activate
pip install -r requirements.txt

# 2. Initialize NBGrader
./bin/tito nbgrader init

# 3. Verify setup
./bin/tito system health

📝 Weekly Assignment Workflow

Monday: Release New Assignment

# Generate assignment from TinyTorch module
./bin/tito nbgrader generate 03_activations

# Create student version
./bin/tito nbgrader release 03_activations

# Upload assignments/release/03_activations/03_activations.ipynb to LMS

Friday: Grade Submissions

# After downloading student submissions to assignments/submitted/
./bin/tito nbgrader autograde 03_activations
./bin/tito nbgrader feedback 03_activations

# Return assignments/feedback/ files to students

🔧 Essential Commands

Status & Monitoring

./bin/tito module status --comprehensive    # System health
./bin/tito nbgrader status                  # Assignment status
./bin/tito nbgrader analytics MODULE_NAME   # Student progress

Batch Operations

./bin/tito nbgrader generate --all          # All assignments
./bin/tito nbgrader generate --range 01-04  # Module range
./bin/tito nbgrader autograde --all         # Grade everything
./bin/tito nbgrader feedback --all          # Generate all feedback

Export & Cleanup

./bin/tito nbgrader report --format csv     # Export gradebook
./bin/tito clean                            # Clean temp files

📁 Directory Structure

assignments/
├── source/        # Generated assignments (git tracked)
├── release/       # Student versions (git tracked)
├── submitted/     # Student submissions (git ignored)
├── autograded/    # Graded submissions (git ignored)
└── feedback/      # Student feedback (git ignored)

🆘 Quick Troubleshooting

# Environment issues
source .venv/bin/activate
./bin/tito system health

# Module not found
ls modules/                          # Check available modules
./bin/tito nbgrader generate 02_tensor      # Use exact name

# Validation failures (normal for student notebooks)
# Students have unimplemented functions = expected behavior

📚 Course Planning

17 TinyTorch Modules:

00-02: Foundation (intro, setup, tensors)
03-07: Building Blocks (activations, layers, dense, spatial, attention)
08-11: Training (dataloader, autograd, optimizers, training)
12-16: Production (compression, kernels, benchmarking, mlops, capstone)

Recommended Pacing: 1 module per week = 16-week semester

📖 For complete details: See Instructor Guide

2.8 KiB Raw Permalink Blame History