Commit Graph

9348 Commits

Author SHA1 Message Date
Vijay Janapa Reddi
77baa56d25 Fix convolution example computation error (8 → 7)
Position (1,1) with region [[6,7],[0,1]] and kernel [[1,0],[0,1]]
correctly computes to 6×1 + 7×0 + 0×0 + 1×1 = 7, not 8.

Fixes harvard-edge/cs249r_book#1144
2026-01-27 07:47:31 -05:00
Vijay Janapa Reddi
1654ce4bf3 Style abstract: emphasize AI engineers and pattern names 2026-01-27 07:47:30 -05:00
Vijay Janapa Reddi
aecb79026b Rewrite abstract in formal academic style 2026-01-27 07:47:30 -05:00
Vijay Janapa Reddi
2df0c69a47 Tighten abstract (1785 -> 1496 chars) 2026-01-27 07:47:30 -05:00
Vijay Janapa Reddi
ce5d0ea879 Update abstract with cleaner prose 2026-01-27 07:47:30 -05:00
Vijay Janapa Reddi
ee64168813 Expand abstract with scope, accessibility, and concrete examples 2026-01-27 07:47:30 -05:00
Vijay Janapa Reddi
0d00348cc8 Trim abstract to fit arXiv 1920 char limit 2026-01-27 07:47:30 -05:00
Vijay Janapa Reddi
e4a664b9c1 Frame AI engineers as aspirational goal in abstract 2026-01-27 07:47:29 -05:00
Vijay Janapa Reddi
7c70577ab7 Emphasize AI engineers term in abstract 2026-01-27 07:47:29 -05:00
Vijay Janapa Reddi
c8476b1010 Add AI engineer framing to abstract 2026-01-27 07:47:29 -05:00
Vijay Janapa Reddi
000e8f7f5b Restore original writing style in transitions
Remove mechanical enumeration (First/Second/Third) and meta-commentary
to match paper's flowing academic prose style
2026-01-27 07:47:29 -05:00
Vijay Janapa Reddi
673e6ff73e Improve paragraph transitions throughout paper
- Future Directions: add numbering and connecting phrases between extensions
- Limitations: add category intro and transition words
- Pedagogical Scope: clarify two-principle structure
- Conclusion: add 'First/Second/Third' and audience transition
2026-01-27 07:47:29 -05:00
Vijay Janapa Reddi
918006b957 Fix UTF-8 multiplication signs for arXiv pdflatex 2026-01-27 07:47:29 -05:00
Vijay Janapa Reddi
64ecda7289 Fix compile script to use bibtex for natbib 2026-01-27 07:47:28 -05:00
Vijay Janapa Reddi
ac4c440606 Convert date fields to year for bibtex compatibility 2026-01-27 07:47:28 -05:00
Vijay Janapa Reddi
97d786fd54 Add fontawesome5 fire icon with spacing for title 2026-01-27 07:47:28 -05:00
Vijay Janapa Reddi
3344514eed Make paper arXiv-compatible with pdflatex
- Switch from fontspec/TeX Gyre to standard fonts (mathpazo, helvet, courier)
- Replace emoji package with no-op (title is just "TinyTorch")
- Switch from biblatex/biber to natbib/bibtex
- Works with both lualatex (local) and pdflatex (arXiv)
2026-01-27 07:47:28 -05:00
Vijay Janapa Reddi
d508b4292b Update acknowledgments and GenAI disclosure
- Acknowledge CS249r students whose feedback shaped the curriculum
- Acknowledge global mlsysbook.ai community
- Expand GenAI statement to cover framework development
- Frame AI assistance as enabling democratization (single author, 20 modules)
- Remove em-dashes throughout for cleaner prose
2026-01-27 07:47:28 -05:00
Vijay Janapa Reddi
7aef7150b1 Add generative AI disclosure statement per ACM policy 2026-01-27 07:47:28 -05:00
Vijay Janapa Reddi
fd5e735494 Restore fontspec, emoji, and biblatex for local compilation
Reverts arXiv-specific changes to work with compile_paper.sh:
- Restored fontspec with TeX Gyre fonts
- Restored emoji package
- Restored biblatex with biber backend
- Works with lualatex as expected by compile script
2026-01-27 07:47:27 -05:00
Vijay Janapa Reddi
b97d086f95 Fix arXiv compatibility issues
- Replace fontspec/custom fonts with standard LaTeX fonts (mathpazo, helvet, courier)
- Remove emoji package, define empty command for \emoji
- Switch from biblatex/biber to natbib/bibtex for better arXiv support
- Change \printbibliography to \bibliography{references}
2026-01-27 07:47:27 -05:00
Vijay Janapa Reddi
12fa930dd1 Simplify title and fix bibliography entry types
- Remove "Tensors to Systems" from subtitle for cleaner title
- Fix @article entries that should be @inproceedings (kannan2022astrasim,
  micikevicius2018mixed, strubell2019energy, vaswani2017attention)
- Remove duplicate booktitle field from williams2009roofline
- Standardize year fields across entries
2026-01-27 07:47:27 -05:00
Vijay Janapa Reddi
3ed2f58dab Remove unused module_flow diagram files 2026-01-27 07:47:27 -05:00
Vijay Janapa Reddi
90e30a508a Update paper title and add AI Engineering framing
- New title: "TinyTorch: Building Machine Learning Systems from First
  Principles: Tensors to Systems"
- Add strategic mentions of AI engineering as an emerging discipline
- Update competency matrix caption to reference AI engineer competencies
- Update conclusion to position TinyTorch as training AI engineers
- Add SEI AI Engineering workshop report reference
2026-01-27 07:47:27 -05:00
Vijay Janapa Reddi
a5f8a41100 Remove ungrounded claims from paper
- Remove fabricated claim about quantum ML and robotics community forks
  that don't actually exist
- Remove "quantum ML" from conclusion's list of future fork variants
- Change "validated through pilot implementations" to "designed for
  diverse institutional contexts" since validation is planned future work
2026-01-27 07:47:27 -05:00
Vijay Janapa Reddi
79ff0cd44a Update memory calculation example to match Module 1
- Replace MNIST/ImageNet full dataset calculation with the actual Module 1 exercise
- New text: "Students calculate memory footprints, discovering that a single batch of 32 ImageNet images requires 19 MB, while the full dataset exceeds 670 GB."
- Aligns paper claims with the codebase (01_tensor.py Q1)
2026-01-27 07:47:26 -05:00
Vijay Janapa Reddi
f8485a3323 Fix orphans and widows in paper text
- Rephrase 'optimization opportunities' sentence to avoid dangling word
- Adjust 'roles industry desperately needs' to 'roles that the industry desperately needs'
- Change 'over dense layers' to 'compared to dense layers' to improve line break
- Reorder 'construct mental models gradually' to 'gradually construct mental models'
- Change 'self-paced professional development' to 'independent professional development'
2026-01-27 07:47:26 -05:00
Vijay Janapa Reddi
9bbab8f739 Remove Champion Trophy Icon
- Remove the TikZ scope containing the trophy icon code
- Keep the Capstone node and connection
2026-01-27 07:47:26 -05:00
Vijay Janapa Reddi
a0dfcfa5f9 Realign module graph to two distinct rows
- Align '09 CNNs' (Spatial) with the top Foundation row (01 Tensor)
- Align '15 Quant' and '16 Compress' with the top Foundation row
- Position '10-13' (Language path) and '17-18' (Accel/Memo) on the bottom row
- Center '14 Profiling' and '19 Benchmark' vertically between the two rows
- Remove 'Vision' and 'Language' labels
- Adjust tier labels to be consistently positioned above the top row
2026-01-27 07:47:26 -05:00
Vijay Janapa Reddi
a25d3bf502 Fix Tier Label positioning
- Define a common LabelLine coordinate relative to the top of Foundation Row 1 (T.north + 1.2cm)
- Ensure all tier labels (FOUNDATION, ARCHITECTURE, OPTIMIZATION) are placed on this line
- Prevents labels from overlapping with nodes or being placed too low
- Maintains horizontal centering for each section
2026-01-27 07:47:26 -05:00
Vijay Janapa Reddi
683b105c9f Align and center tier labels
- Place all tier labels (FOUNDATION, ARCHITECTURE, OPTIMIZATION) on the same vertical line
- Center each label horizontally over its respective section using coordinate calculations
- Use Architecture label position as the anchor for height alignment
2026-01-27 07:47:26 -05:00
Vijay Janapa Reddi
bd988b4f85 Center CNN node in Architecture tier
- Move Vision path definition after Language path to allow relative positioning
- Center '09 CNNs' node horizontally above the Language path (Tok-Trans)
- Update arrow routing to accommodate the new centered position
2026-01-27 07:47:25 -05:00
Vijay Janapa Reddi
e62e84c4f7 Fix Foundation tier arrow routing
- Reroute the arrow from 04 Losses to 05 DataLoad to go between the rows
- Prevents the arrow from cutting through 06, 07, 08 nodes
- Improves visual clarity of the two-row layout
2026-01-27 07:47:25 -05:00
Vijay Janapa Reddi
d26b7bc1eb Refactor Foundation tier layout into two rows
- Split Foundation modules (01-08) into two rows of 4 nodes each
- Row 1: 01 Tensor -> 04 Losses
- Row 2: 05 DataLoad -> 08 Training
- Connect end of Row 1 to start of Row 2 with a wrapped arrow
- Center 'FOUNDATION' label over the new two-row layout
2026-01-27 07:47:25 -05:00
Vijay Janapa Reddi
b09f79f387 Fix module dependency graph layout and labels
- Reposition Profiling node to avoid overlap with Architecture branch
- Center Architecture label and align with Optimization label
- Increase font size of path labels for better readability
- Fix overlap of 'Speed' label with 'Transform' node
2026-01-27 07:47:25 -05:00
Vijay Janapa Reddi
bb323bff5a style(paper): improve typography and add single node framing
- Add single node focus framing throughout paper
- Update ML Systems Competency Matrix caption to clarify single node scope
- Strengthen distributed systems discussion in Curriculum Evolution
- Remove all em-dashes (25 total) replacing with colons, commas, periods
- Switch to lining numbers for technical content
- Add widow/orphan penalties to reduce dangling lines
- Fix single-item bullet list (Intentional Gap section)
- Update author limit to 50 before et al truncation
- Fix tinytorch package references to match actual implementation
2026-01-27 07:47:25 -05:00
Vijay Janapa Reddi
f7701968bc refactor(paper): remove Open Science Commitment paragraph 2026-01-27 07:47:25 -05:00
Vijay Janapa Reddi
3334e73260 refactor(paper): condense empirical validation roadmap
Trim detailed phase-by-phase validation plan to a concise summary.
Removes specific dates, sample sizes, and instrument names that would
age poorly. Keeps the Open Science Commitment and general validation
approach. Also removes two orphaned references (paas1992training,
sorva2012visual) that were only cited in the removed text.
2026-01-27 07:47:24 -05:00
Vijay Janapa Reddi
71c883eaf9 fix(paper): use biber instead of bibtex for biblatex
The paper now uses biblatex for bibliography management, which requires
biber as the backend processor instead of bibtex. Updated both
compile_paper.sh and Makefile to use biber.
2026-01-27 07:47:24 -05:00
Vijay Janapa Reddi
5597230700 fix(paper): align paper.tex with codebase and verify all references
- Switch from natbib to biblatex for better author truncation control
- Fix package structure references (tinytorch.nn.conv → tinytorch.core.spatial)
- Fix import examples to use actual tinytorch API patterns
- Fix class references (Transformer → GPT, Attention → MultiHeadAttention)
- Correct Adam coefficient from 0.001 to 0.01
- Fix 11 bibliography entries with wrong/corrupted data:
  - abelson1996sicp, bruner1960process, hotz2023tinygrad
  - tanenbaum1987minix, perkins1992transfer, papert1980mindstorms
  - vygotsky1978mind, blank2019nbgrader, roberthalf2024talent
  - keller2025ai, pytorch04release, tensorflow20
- Fix organization author names using double braces
- Configure maxbibnames=10 for "et al." truncation in bibliography

All 60 references verified via web search for arXiv submission.
2026-01-27 07:47:24 -05:00
github-actions[bot]
e33747d7b4 chore(tinytorch): bump version to tinytorch-v0.1.5 2026-01-27 01:50:39 +00:00
Vijay Janapa Reddi
849ab0befa fix(ci): only run validate workflow on dev push, not main 2026-01-26 15:14:51 -05:00
Vijay Janapa Reddi
dda4326fd3 fix(ci): use windows-2022 to avoid D: drive issue on windows-latest (2025) 2026-01-26 15:10:09 -05:00
Vijay Janapa Reddi
4cc97325a4 debug(ci): enable runner debug logging to investigate Windows D:\a issue 2026-01-26 15:02:28 -05:00
Vijay Janapa Reddi
70634bcf4c fix(ci): make Windows jobs non-blocking due to infrastructure flakiness 2026-01-26 14:50:13 -05:00
Vijay Janapa Reddi
16430b08e9 fix(ci): use windows-2022 instead of windows-latest
Windows Server 2025 (windows-latest) has path length issues causing
"Could not find a part of the path D:\a" errors during job setup.
Windows Server 2022 is more stable.
2026-01-26 13:29:46 -05:00
Vijay Janapa Reddi
87b082fe0b fix(ci): disable pip caching to avoid Windows failures 2026-01-26 12:03:24 -05:00
Vijay Janapa Reddi
e3c9f0b445 docs: remove redundant Star CTA from README 2026-01-26 10:54:37 -05:00
Vijay Janapa Reddi
25659dddd4 fix(site): revert Star button to direct GitHub link
Deep linking to #why-github-stars-matter created too many hops.
Direct link to repo root puts Star button immediately visible.
2026-01-26 10:53:09 -05:00
Vijay Janapa Reddi
79e850dd2f docs: add direct Star CTA in Why GitHub Stars Matter section
Users landing on #why-github-stars-matter now see a clickable
Star link without needing to scroll back to the top of the page.
2026-01-26 10:52:13 -05:00