diff --git a/README.md b/README.md
new file mode 100644
index 0000000..0a46be2
--- /dev/null
+++ b/README.md
@@ -0,0 +1,17 @@
+esphome-proto
+=============
+
+[ESPHome native API][native-api] protocol data structures generated from
+[protobuf files] in [the Python client][aioesphomeapi].
+
+## Regenerating
+
+In order to avoid each consumer of this crate having to regenerate the Rust
+source and pull in build-time dependencies on the protobuf code generator the
+generated files are committed into this repository.
+
+To regenerate the files run `make codegen`.
+
+[native-api]: https://esphome.io/components/api.html
+[protobuf files]: https://github.com/esphome/esphome/blob/dev/esphome/components/api/api.proto
+[aioesphomeapi]: https://github.com/esphome/aioesphomeapi