diff --git a/README.md b/README.md
new file mode 100644
index 0000000..97aec2c
--- /dev/null
+++ b/README.md
@@ -0,0 +1,14 @@
+# EEE PC Alarm Clock!  
+
+Runs on Debian 12.
+Requires Python 3 and mpg123.
+
+To use, just run `main.py` from the `alert_api/` directory.
+
+It includes:
+- A local ncurses UI.
+- A simple HTTP API (for how to use it, check out `alert_api/tests.sh`).
+
+Put your alarm sounds in `~/alarms/` as MP3 files.
+
+License: MIT
\ No newline at end of file