#!/usr/bin/env python3
"""Expert worker: holds a set of (layer, expert) pairs resident (loaded from its local copy of the checkpoint) and executes them
on activations sent by the coordinator. Exact: the same gather_qmm + swiglu sequence as the local block, per (row, k) slot.
python -m transport.worker --model
--listen 0.0.0.0:9411 --token-file ~/.titan_token [--allow 192.168.2.80]
"""
from __future__ import annotations
import argparse, json, os, socket, sys, threading, time
import numpy as np
import mlx.core as mx
sys.path.insert(0, os.path.dirname(os.path.dirname(os.path.abspath(__file__))))
from mlx_lm.models.activations import swiglu
from titan.registry import load_spec
from titan.store import ExpertStore
from titan.slots import SlotTable
from transport.protocol import Framer
class Worker:
def __init__(self, model_dir, capacity_per_layer=None):
self.spec = load_spec(model_dir)
self.store = ExpertStore(self.spec)
q = self.spec.quantization
self.gs, self.bits = q["group_size"], q["bits"]
self.tables = {}
self.cap = capacity_per_layer or self.spec.num_experts
self.lock = threading.Lock()
self.exec_count = 0; self.exec_time = 0.0
def table(self, l):
if l not in self.tables:
self.tables[l] = SlotTable(l, self.cap, self.store)
return self.tables[l]
def load(self, assignments):
"""assignments: {layer: [experts]} -> make them resident."""
n = 0
for l, es in assignments.items():
t = self.table(int(l)); t.ensure([int(e) for e in es]); n += len(es)
mx.eval(*[b for t in self.tables.values() for b in t.buf.values()])
return n
def execute(self, layer, rows_f16: np.ndarray, pairs):
"""rows_f16: [R, D] activations; pairs: list of (row, expert). Returns [len(pairs), D] float16 outputs."""
t0 = time.perf_counter()
tab = self.table(layer)
experts = [e for _, e in pairs]
slots = tab.ensure(list(dict.fromkeys(experts)))
slot_of = dict(zip(dict.fromkeys(experts), slots))
x = mx.array(rows_f16) # [R, D]
ridx = mx.array([r for r, _ in pairs], dtype=mx.uint32)
sidx = mx.array([slot_of[e] for e in experts], dtype=mx.uint32)
xs = x[ridx] # [P, D]
xe = mx.expand_dims(xs, (-2, -3)) # [P, 1, 1, D]
b = tab.buf
def qmm(h, m):
return mx.gather_qmm(h, b[f"{m}.weight"], b[f"{m}.scales"], b.get(f"{m}.biases"), rhs_indices=sidx.reshape(-1, 1),
transpose=True, group_size=self.gs, bits=self.bits)
up = qmm(xe, "up"); gate = qmm(xe, "gate")
y = qmm(swiglu(gate, up), "down").squeeze(-2).squeeze(-2) # [P, D]
out = np.array(y.astype(mx.float16))
self.exec_count += 1; self.exec_time += time.perf_counter() - t0
return out
def serve(args):
token = open(os.path.expanduser(args.token_file), "rb").read().strip()
allow = set(args.allow.split(",")) if args.allow else None
w = Worker(args.model, args.capacity)
host, port = args.listen.rsplit(":", 1)
srv = socket.socket(socket.AF_INET, socket.SOCK_STREAM); srv.setsockopt(socket.SOL_SOCKET, socket.SO_REUSEADDR, 1)
srv.bind((host, int(port))); srv.listen(4)
print(f"[worker] {socket.gethostname()} listening on {args.listen}, model {w.spec.model_type}, cap {w.cap}", flush=True)
while True:
conn, addr = srv.accept()
if allow and addr[0] not in allow:
print(f"[worker] refused {addr}", flush=True); conn.close(); continue
conn.setsockopt(socket.IPPROTO_TCP, socket.TCP_NODELAY, 1)
conn.settimeout(args.timeout)
threading.Thread(target=handle, args=(conn, addr, token, w), daemon=True).start()
def handle(conn, addr, token, w: Worker):
f = Framer(conn, token)
try:
kind, h, _ = f.recv()
if kind != "hello" or h.get("proto") != "TX1" or h.get("model_type") != w.spec.model_type:
f.send("error", {"msg": "bad hello"}); conn.close(); return
f.send("hello_ack", {"host": socket.gethostname(), "num_layers": w.spec.num_layers, "num_experts": w.spec.num_experts,
"cap": w.cap, "resident": {str(l): t.resident() for l, t in w.tables.items()}})
print(f"[worker] coordinator {addr} connected", flush=True)
while True:
kind, h, payload = f.recv()
if kind == "ping":
f.send("pong", {"t": time.time()})
elif kind == "load":
n = w.load(h["assignments"])
f.send("load_reply", {"loaded": n, "resident": {str(l): t.resident() for l, t in w.tables.items()}})
elif kind == "exec":
R, D = h["rows"], h["dim"]
x = np.frombuffer(payload, dtype=np.float16).reshape(R, D)
out = w.execute(h["layer"], x, [tuple(p) for p in h["pairs"]])
f.send("exec_reply", {"layer": h["layer"], "n": out.shape[0], "exec_ms": w.exec_time * 1e3}, out.tobytes())
else:
f.send("error", {"msg": f"unexpected {kind}"})
except (ConnectionError, socket.timeout, OSError) as e:
print(f"[worker] {addr} closed: {e}", flush=True)
finally:
conn.close()
if __name__ == "__main__":
ap = argparse.ArgumentParser()
ap.add_argument("--model", required=True)
ap.add_argument("--listen", default="0.0.0.0:9411")
ap.add_argument("--token-file", default="~/.titan_token")
ap.add_argument("--allow", default=None, help="comma-separated coordinator IPs allowed to connect")
ap.add_argument("--capacity", type=int, default=None)
ap.add_argument("--timeout", type=float, default=600.0)
serve(ap.parse_args())