git404hub

what is internals-series fr?

suryals/internals-series — explained in plain English

Analysis updated 2026-05-18

0PythonAudience · researcherComplexity · 2/5Setup · moderate

tl;dr

A code companion repo for the Internals blog series, holding runnable scripts that verify how AI systems work using MLX on Apple Silicon Macs.

vibe map

mindmap
  root((internals-series))
    What it does
      Code for Internals blog
      Verifies AI internals
      Runs on real models
    Tech stack
      Python
      MLX
      Apple Silicon
    Use cases
      Reproduce blog experiments
      Run forward pass demo
      Swap in larger models
    Audience
      Blog readers
      Researchers

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

what do people make with this?

VIBE 1

Run the same verification scripts referenced in the Internals blog posts to see AI model internals firsthand.

VIBE 2

Download a small quantized model and reproduce the forward pass experiments locally on a Mac.

VIBE 3

Swap in a larger model from the mlx-community collection to explore beyond the default example.

what's the stack?

PythonMLXApple Silicon

how it stacks up fr

suryals/internals-series0xallam/my-recipe0xhassaan/nn-from-scratch
Stars00
LanguagePythonPythonPython
Last pushed2022-11-22
MaintenanceDormant
Setup difficultymoderatemoderatemoderate
Complexity2/52/54/5
Audienceresearchergeneraldeveloper

Figures from each repo's GitHub metadata at analysis time.

how do i run it?

Difficulty · moderate time til it works · 30min

Requires an Apple Silicon Mac to run MLX.

in plain english

This repository is the code companion to a blog post series called Internals, published at suryal.dev. The series explains how AI systems actually work under the hood, and this repo holds the runnable scripts that back up the claims made in each post. The author states that every claim in the writing is verified against a real model, so if a script reports that its numbers match, those numbers were produced by actually running a model at the time the post was written. The README is short and describes the project at a high level rather than going into deep detail. It lists the posts in the series alongside links to their matching code folders. So far there is one entry: a post called Inside the Forward Pass, with its code kept in the 01-forward-pass folder. The scripts run models locally using MLX, a machine learning framework built for Apple Silicon chips. This means the project is meant to be used on a Mac with an Apple Silicon processor, such as an M1, M2, M3, or M4 chip, rather than on other hardware. Setup is a single pip install command that pulls in mlx and mlx-lm. By default the scripts use a small model called Qwen3-0.6B in a 4-bit quantized form, which is about 350 megabytes to download, so trying the code does not require a large amount of disk space or a long wait. A command line option lets you swap in a larger model from the mlx-community collection on Hugging Face if you want to experiment further. Overall this is a small, focused reference project for readers following along with the Internals blog series who want to run the same experiments described in the posts themselves, rather than a general purpose tool or library.

prompts (copy fr)

prompt 1
Explain what the Inside the Forward Pass script in this repo is checking about how the model works.
prompt 2
Walk me through installing mlx and mlx-lm so I can run the scripts in this repo on my Mac.
prompt 3
How do I pass a different model from mlx-community to these scripts instead of the default Qwen3-0.6B?
prompt 4
Summarize what this repo's code proves about AI system internals compared to just reading the blog post.

Frequently asked questions

what is internals-series fr?

A code companion repo for the Internals blog series, holding runnable scripts that verify how AI systems work using MLX on Apple Silicon Macs.

What language is internals-series written in?

Mainly Python. The stack also includes Python, MLX, Apple Silicon.

How hard is internals-series to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is internals-series for?

Mainly researcher.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.