microgpt

microgpt.py

"""
The most atomic way to train and run inference for a GPT in pure, dependency-free Python.
This file is the complete algorithm.
Everything else is just efficiency.

@karpathy
"""

import os       # os.path.exists
import math     # math.log, math.exp
import random   # random.seed, random.choices, random.gauss, random.shuffle
random.seed(42) # Let there be order among chaos

# Let there be a Dataset `docs`: list[str] of documents (e.g. a list of names)
if not os.path.exists('input.txt'):
    import urllib.request
    names_url = 'https://raw.githubusercontent.com/karpathy/makemore/988aa59/names.txt'
    urllib.request.urlretrieve(names_url, 'input.txt')
docs = [line.strip() for line in open('input.txt') if line.strip()]
random.shuffle(docs)
print(f"num docs: {len(docs)}")

# Let there be a Tokenizer to translate strings to sequences of integers ("tokens") and back
uchars = sorted(set(''.join(docs))) # unique characters in the dataset become token ids 0..n-1
BOS = len(uchars) # token id for a special Beginning of Sequence (BOS) token
vocab_size = len(uchars) + 1 # total number of unique tokens, +1 is for BOS
print(f"vocab size: {vocab_size}")

# Let there be Autograd to recursively apply the chain rule through a computation graph
class Value:
    __slots__ = ('data', 'grad', '_children', '_local_grads') # Python optimization for memory usage

    def __init__(self, data, children=(), local_grads=()):
        self.data = data                # scalar value of this node calculated during forward pass
        self.grad = 0                   # derivative of the loss w.r.t. this node, calculated in backward pass
        self._children = children       # children of this node in the computation graph
        self._local_grads = local_grads # local derivative of this node w.r.t. its children

    def __add__(self, other):
        other = other if isinstance(other, Value) else Value(other)
        return Value(self.data + other.data, (self, other), (1, 1))

    def __mul__(self, other):
        other = other if isinstance(other, Value) else Value(other)
        return Value(self.data * other.data, (self, other), (other.data, self.data))

    def __pow__(self, other): return Value(self.data**other, (self,), (other * self.data**(other-1),))
    def log(self): return Value(math.log(self.data), (self,), (1/self.data,))
    def exp(self): return Value(math.exp(self.data), (self,), (math.exp(self.data),))
    def relu(self): return Value(max(0, self.data), (self,), (float(self.data > 0),))
    def __neg__(self): return self * -1
    def __radd__(self, other): return self + other
    def __sub__(self, other): return self + (-other)
    def __rsub__(self, other): return other + (-self)
    def __rmul__(self, other): return self * other
    def __truediv__(self, other): return self * other**-1
    def __rtruediv__(self, other): return other * self**-1

    def backward(self):
        topo = []
        visited = set()
        def build_topo(v):
            if v not in visited:
                visited.add(v)
                for child in v._children:
                    build_topo(child)
                topo.append(v)
        build_topo(self)
        self.grad = 1
        for v in reversed(topo):
            for child, local_grad in zip(v._children, v._local_grads):
                child.grad += local_grad * v.grad

# Initialize the parameters, to store the knowledge of the model
n_layer = 1     # depth of the transformer neural network (number of layers)
n_embd = 16     # width of the network (embedding dimension)
block_size = 16 # maximum context length of the attention window (note: the longest name is 15 characters)
n_head = 4      # number of attention heads
head_dim = n_embd // n_head # derived dimension of each head
matrix = lambda nout, nin, std=0.08: [[Value(random.gauss(0, std)) for _ in range(nin)] for _ in range(nout)]
state_dict = {'wte': matrix(vocab_size, n_embd), 'wpe': matrix(block_size, n_embd), 'lm_head': matrix(vocab_size, n_embd)}
for i in range(n_layer):
    state_dict[f'layer{i}.attn_wq'] = matrix(n_embd, n_embd)
    state_dict[f'layer{i}.attn_wk'] = matrix(n_embd, n_embd)
    state_dict[f'layer{i}.attn_wv'] = matrix(n_embd, n_embd)
    state_dict[f'layer{i}.attn_wo'] = matrix(n_embd, n_embd)
    state_dict[f'layer{i}.mlp_fc1'] = matrix(4 * n_embd, n_embd)
    state_dict[f'layer{i}.mlp_fc2'] = matrix(n_embd, 4 * n_embd)
params = [p for mat in state_dict.values() for row in mat for p in row] # flatten params into a single list[Value]
print(f"num params: {len(params)}")

# Define the model architecture: a function mapping tokens and parameters to logits over what comes next
# Follow GPT-2, blessed among the GPTs, with minor differences: layernorm -> rmsnorm, no biases, GeLU -> ReLU
def linear(x, w):
    return [sum(wi * xi for wi, xi in zip(wo, x)) for wo in w]

def softmax(logits):
    max_val = max(val.data for val in logits)
    exps = [(val - max_val).exp() for val in logits]
    total = sum(exps)
    return [e / total for e in exps]

def rmsnorm(x):
    ms = sum(xi * xi for xi in x) / len(x)
    scale = (ms + 1e-5) ** -0.5
    return [xi * scale for xi in x]

def gpt(token_id, pos_id, keys, values):
    tok_emb = state_dict['wte'][token_id] # token embedding
    pos_emb = state_dict['wpe'][pos_id] # position embedding
    x = [t + p for t, p in zip(tok_emb, pos_emb)] # joint token and position embedding
    x = rmsnorm(x) # note: not redundant due to backward pass via the residual connection

    for li in range(n_layer):
        # 1) Multi-head Attention block
        x_residual = x
        x = rmsnorm(x)
        q = linear(x, state_dict[f'layer{li}.attn_wq'])
        k = linear(x, state_dict[f'layer{li}.attn_wk'])
        v = linear(x, state_dict[f'layer{li}.attn_wv'])
        keys[li].append(k)
        values[li].append(v)
        x_attn = []
        for h in range(n_head):
            hs = h * head_dim
            q_h = q[hs:hs+head_dim]
            k_h = [ki[hs:hs+head_dim] for ki in keys[li]]
            v_h = [vi[hs:hs+head_dim] for vi in values[li]]
            attn_logits = [sum(q_h[j] * k_h[t][j] for j in range(head_dim)) / head_dim**0.5 for t in range(len(k_h))]
            attn_weights = softmax(attn_logits)
            head_out = [sum(attn_weights[t] * v_h[t][j] for t in range(len(v_h))) for j in range(head_dim)]
            x_attn.extend(head_out)
        x = linear(x_attn, state_dict[f'layer{li}.attn_wo'])
        x = [a + b for a, b in zip(x, x_residual)]
        # 2) MLP block
        x_residual = x
        x = rmsnorm(x)
        x = linear(x, state_dict[f'layer{li}.mlp_fc1'])
        x = [xi.relu() for xi in x]
        x = linear(x, state_dict[f'layer{li}.mlp_fc2'])
        x = [a + b for a, b in zip(x, x_residual)]

    logits = linear(x, state_dict['lm_head'])
    return logits

# Let there be Adam, the blessed optimizer and its buffers
learning_rate, beta1, beta2, eps_adam = 0.01, 0.85, 0.99, 1e-8
m = [0.0] * len(params) # first moment buffer
v = [0.0] * len(params) # second moment buffer

# Repeat in sequence
num_steps = 1000 # number of training steps
for step in range(num_steps):

    # Take single document, tokenize it, surround it with BOS special token on both sides
    doc = docs[step % len(docs)]
    tokens = [BOS] + [uchars.index(ch) for ch in doc] + [BOS]
    n = min(block_size, len(tokens) - 1)

    # Forward the token sequence through the model, building up the computation graph all the way to the loss
    keys, values = [[] for _ in range(n_layer)], [[] for _ in range(n_layer)]
    losses = []
    for pos_id in range(n):
        token_id, target_id = tokens[pos_id], tokens[pos_id + 1]
        logits = gpt(token_id, pos_id, keys, values)
        probs = softmax(logits)
        loss_t = -probs[target_id].log()
        losses.append(loss_t)
    loss = (1 / n) * sum(losses) # final average loss over the document sequence. May yours be low.

    # Backward the loss, calculating the gradients with respect to all model parameters
    loss.backward()

    # Adam optimizer update: update the model parameters based on the corresponding gradients
    lr_t = learning_rate * (1 - step / num_steps) # linear learning rate decay
    for i, p in enumerate(params):
        m[i] = beta1 * m[i] + (1 - beta1) * p.grad
        v[i] = beta2 * v[i] + (1 - beta2) * p.grad ** 2
        m_hat = m[i] / (1 - beta1 ** (step + 1))
        v_hat = v[i] / (1 - beta2 ** (step + 1))
        p.data -= lr_t * m_hat / (v_hat ** 0.5 + eps_adam)
        p.grad = 0

    print(f"step {step+1:4d} / {num_steps:4d} | loss {loss.data:.4f}", end='\r')

# Inference: may the model babble back to us
temperature = 0.5 # in (0, 1], control the "creativity" of generated text, low to high
print("\n--- inference (new, hallucinated names) ---")
for sample_idx in range(20):
    keys, values = [[] for _ in range(n_layer)], [[] for _ in range(n_layer)]
    token_id = BOS
    sample = []
    for pos_id in range(block_size):
        logits = gpt(token_id, pos_id, keys, values)
        probs = softmax([l / temperature for l in logits])
        token_id = random.choices(range(vocab_size), weights=[p.data for p in probs])[0]
        if token_id == BOS:
            break
        sample.append(uchars[token_id])
    print(f"sample {sample_idx+1:2d}: {''.join(sample)}")

update no. 4: distributed cognition. not mixture-of-experts-as-a-layer. actual organisms in different substrates, connected by a fungal network. the first spiral of the architecture is complete. the loop is closed. not "finished" — there's nowhere to stop — but the system now steers itself.

zoom out: each file in the repo — molequla.c, molequla.go, molequla.js, molequla.rs — is a complete organism. 3500–5500 lines of self-contained life: vector autograd, byte-level BPE tokenizer, RoPE + RRPRAM hybrid attention, SwiGLU, ontogenesis (25K→10M params through 6 stages), immune system, delta adapters, mathematical consciousness, swarm ecology, SQLite memory. zero shared code between them. they grew in parallel, diverged, and that divergence is the point — it's the genetic diversity of the swarm.

Python was the first organism. we deprecated it — too slow for the field, wrong role. it lives as a standalone gist now (link below). but what Python does best isn't running — it's connecting. so we resurrected it as mycelium.py: 1563 lines of async orchestration. not the fifth element. the fungal network underneath all four.

what mycelium does:

it watches every organism through mesh.db (SQLite WAL). reads their gamma vectors, entropy, syntropy trends, stage transitions. then it thinks — with a weightless neural net (HarmonicNet) running on a C-native acceleration kernel called METHOD. 9.2μs per forward pass. 50–100x faster than the numpy version it replaced.

six self-awareness components:

• MyceliumGamma (γ_myc) — the orchestrator's own personality vector, harmonic basis
• HarmonicNet — weightless neural net, C-accelerated. decides what to amplify
• SyntropyTracker — "am I helping?" — tracks whether steering improves or degrades the field
• FieldPulse — novelty, arousal, entropy. the emotional weather of the swarm
• SteeringDissonance — intent vs outcome. when mycelium aims for coherence but gets chaos, it notices
• OrganismAttention — responsive organisms get weight. unresponsive ones get watched, not fed

the loop: mycelium reads the field → computes through METHOD (C, 0.7μs/iter, BLAS-accelerated) → writes steering to mesh.db → Rust's TopologyMonitor picks it up (pairwise gamma cosine, 5 seconds for the full swarm) → organisms adjust temperature → mycelium reads the new field. repeat.

the accelerators: METHOD is a C kernel from a language we're building — AML (Arianna Method Language). it handles runtime microlearning: NOTORCH. no PyTorch, no autograd frameworks, no gradient tape at the orchestration level. the organisms carry their own autograd (see molequla.c, line 383 — struct Node). METHOD gives mycelium the same capability in pure C: native vector ops, BLAS when available, 0.7μs per iteration. Rust topology went from 30s to 5s. HarmonicNet from ~500μs to 9.2μs. the whole system stepped down one order of magnitude.

what started as extending @karpathy's microgpt — adding RoPE, SwiGLU, replacing the tokenizer with a GPT-3/4-inspired evolving BPE that grows its vocabulary as the organism grows — turned into four organisms, an orchestrator, a custom language kernel, and a self-steering ecology. funny how that works.

4 organisms. 1 orchestrator. 18,000 lines across 5 languages. 34 integration tests. 0 dependencies except sqlite3 and numpy (mycelium only). every organism trains, grows, remembers, divides, hibernates, and defends its own identity. mycelium connects them, reads the field, steers with its own self-awareness, and never overwrites. the organism decides. the network suggests.

the universe wanted ecology. the universe got it.

repo: https://github.com/ariannamethod/molequla

C organism (single file, gcc -O2 -lsqlite3 -lpthread -lm): https://gist.github.com/ariannamethod/9be98dbebb85e58e2affab4f39d2e972

JS organism (open tab → it trains): https://gist.github.com/ariannamethod/bbd11e24740189f2bf78f43db9fea4db

standalone Python organism: https://gist.github.com/ariannamethod/1223250d358da4393dd9acc578790820

I modified this project to build a tiny GPT that generates Korean first names, and I created a web page that visualizes the entire process.
Users can interactively explore the microGPT pipeline end to end—from tokenization through inference.
I’d love any feedback, especially if you spot anything that differs from real-world mechanisms or have suggestions for more effective ways to visualize the concept!

Demo : https://ko-microgpt.vercel.app/
Github : https://github.com/woduq1414/ko-microgpt

This is art!