From e4333a3325fbda1d8df28efaae0a35cc7437ec89 Mon Sep 17 00:00:00 2001
From: Awni Hannun <awni@apple.com>
Date: Tue, 5 Dec 2023 11:58:58 -0800
Subject: [PATCH] update readme

---
 README.md | 15 +++++++++++++--
 1 file changed, 13 insertions(+), 2 deletions(-)

diff --git a/README.md b/README.md
index 3b67ffc8..adcdc45e 100644
--- a/README.md
+++ b/README.md
@@ -1,6 +1,17 @@
-# mlx-examples
+# MLX Examples
 
-Examples using the MLX framework.
+This repo contains a variety of standalone examples using the [MLX
+framework](https://github.com/ml-explore/mlx).
+
+The [MNIST](mnist) example is a good starting point to learn how to use MLX.
+
+Some more useful examples include:
+
+- [Transformer language model](transformer_lm) training.
+- Large scale text generation with [LLaMA](llama) or [Mistral](mistral)
+- Parameter efficient fine-tuning with [LoRA](lora).
+- Generating images with [Stable Diffusion](stable_diffusion).
+- Speech recognition with [OpenAI's Whisper](whisper).
 
 ## Contributing