diff --git a/README.md b/README.md
new file mode 100644
index 0000000..6495d98
--- /dev/null
+++ b/README.md
@@ -0,0 +1,6 @@
+python-sample
+=============
+
+A 'hello world' web app written in Python using the [Flask](http://flask.pocoo.org/) microframework.
+
+[![Deploy](https://www.herokucdn.com/deploy/button.png)](https://heroku.com/deploy)
diff --git a/app.json b/app.json
new file mode 100644
index 0000000..74a2815
--- /dev/null
+++ b/app.json
@@ -0,0 +1,6 @@
+{
+  "name": "Python Flask sample",
+  "description": "A 'hello world' Python app using the Flask framework",
+  "repository": "https://github.com/heroku/python-sample",
+  "keywords": ["python", "flask"]
+}