mlx-examples — 읽을 가치가 있는 기준 코드 · MLX Quest

설치하지 말고 읽는 저장소

ml-explore/mlx-examples는 MLX의 표준 코드에 가장 가까운 예제 모음이야. 흔한 모델과 방식을 작고 주석 많은 구현으로 보여주며 일부러 Python 라이브러리로 포장하지 않았어. pip install mlx-examples가 아니라 코드를 읽어.

자연스러운 MLX 코드의 모양을 배우는 데 가장 좋은 한 곳이고 이 퀘스트의 코드 패턴도 여기와 맞춰 확인했어.

기억할 폴더

llms/ — Transformer 언어 모델의 표준 모양
lora/ — 자료 읽기를 포함한 LoRA·QLoRA 파인튜닝 흐름
stable_diffusion/ — 오래됐지만 확산 모델 흐름을 보여주는 이미지 생성 예제
whisper/ — 오디오를 글로 바꾸는 가장 단순한 STT 구현
mnist/ — 약 100줄로 끝나는 최소 학습 흐름
cifar/ — MNIST보다 한 단계 복잡하지만 30분 안에 읽는 이미지 분류 예제
bert/ — 인코더 전용 Transformer 기준 구현

질문을 들고 찾아가

처음부터 끝까지 읽지 마. 조각난 safetensors를 불러오는 표준 방식이나 체크포인트를 넣은 학습 구조처럼 구체적인 질문이 생겼을 때 가장 가까운 예제를 찾아. 파일 하나를 몇 분에 훑을 만큼 작고 패턴은 여러 프로젝트에 재사용할 수 있어.

운영 코드는 없어

mlx-examples는 명확성을 위한 기준 코드이지 운영 코드가 아니야. 서비스의 오류 처리, 기록, 대기열은 빠져 있어. 운영 방식은 Ollama나 LM Studio가 mlx-lm을 감싸는 법을 보거나 prod.lesson1의 FastAPI 계층을 써.

Code

로컬에서 검색할 기준 코드로 mlx-examples 복제하기·bash

# Optional but useful — clone for local browsing.
git clone https://github.com/ml-explore/mlx-examples.git ~/code/mlx-examples
cd ~/code/mlx-examples

# The directory structure (top level):
ls -d */
# bert/  cifar/  cvae/  llms/  lora/  mnist/  musicgen/  stable_diffusion/  whisper/  ...

# When debugging your own MLX code, grep across the examples:
rg "mx.eval" llms/
rg "value_and_grad" lora/

가장 작은 전체 흐름 예제부터 읽기·bash

# MNIST is ~100 lines and shows the full training loop end-to-end.
# Read this one first if any of MLX's training shape feels unclear.
cat ~/code/mlx-examples/mnist/main.py | head -80

mlx-examples — 읽을 가치가 있는 기준 코드

설치하지 말고 읽는 저장소

기억할 폴더

질문을 들고 찾아가

운영 코드는 없어

Code

External links

Exercise

Progress

댓글 0