diff --git a/README.md b/README.md
new file mode 100644
index 0000000..9e41dc6
--- /dev/null
+++ b/README.md
@@ -0,0 +1,17 @@
+# TCGA Downloader
+
+Python package + CLI to query public TCGA files and download via gdc-client.
+
+## Install
+
+```bash
+pip install -e .
+```
+
+## Example
+
+```bash
+tcga-downloader query --project TCGA-BRCA --data-type "Gene Expression" --out manifest.tsv
+
+tcga-downloader download --manifest manifest.tsv --out-dir ./data
+```
diff --git a/tests/test_readme.py b/tests/test_readme.py
new file mode 100644
index 0000000..72e1935
--- /dev/null
+++ b/tests/test_readme.py
@@ -0,0 +1,5 @@
+from pathlib import Path
+
+
+def test_readme_present():
+    assert Path("README.md").exists()