diff --git a/README.txt b/README.txt
new file mode 100644
index 0000000000000000000000000000000000000000..3b83b2d27bbb88673436cf471319f4af15d600a5
--- /dev/null
+++ b/README.txt
@@ -0,0 +1,27 @@
+
+Rattail
+=======
+
+Rattail is a retail software framework based on `edbob `_,
+and released under the GNU Affero General Public License.
+
+This is the core ``rattail`` package.
+
+Please see Rattail's `home page `_ for more
+information.
+
+
+Installation
+------------
+
+Install the software with::
+
+ $ pip install rattail
+
+
+Usage
+-----
+
+Built-in help can be seen with::
+
+ $ rattail help