diff --git a/scripts/packages/BUILD b/scripts/packages/BUILD
index a8ce0117c26..743bbad1405 100644
--- a/scripts/packages/BUILD
+++ b/scripts/packages/BUILD
@@ -322,6 +322,7 @@ genrule(
     srcs = [
         "pyheron/requirements.txt", 
         "pyheron/setup.py.template",
+        "pyheron/README.txt",
     ] + generated_release_files,
     outs = generated_pyheron_egg_file,
     stamp = 1,
diff --git a/scripts/packages/pyheron/README.txt b/scripts/packages/pyheron/README.txt
new file mode 100644
index 00000000000..3fb0913dbeb
--- /dev/null
+++ b/scripts/packages/pyheron/README.txt
@@ -0,0 +1,3 @@
+PyHeron is the python API for Heron, the distributed streaming engine.
+The API is based on the streamparse Storm python API from Parsely. More
+details can be found at https://github.com/Parsely/streamparse