diff --git a/README.rst b/README.rst
index f2630b4..5cbfc7d 100644
--- a/README.rst
+++ b/README.rst
@@ -14,6 +14,17 @@
 .. image:: https://travis-ci.org/lehmannro/assert.sh.svg?branch=master
    :target: https://travis-ci.org/lehmannro/assert.sh
 
+Install
+=======
+
+::
+
+  ## as a dependency
+  $ bpkg install lehmannro/assert.sh
+  
+  ## or in your path
+  $ bpkg install lehmannro/assert.sh -g
+
 Example
 =======
 
diff --git a/package.json b/package.json
new file mode 100644
index 0000000..ff09e87
--- /dev/null
+++ b/package.json
@@ -0,0 +1,8 @@
+{
+  "name": "assert",
+  "version": "v1.0.2",
+  "description": "bash unit testing framework",
+  "scripts": [ "assert.sh" ],
+  "install": "chmod +x assert.sh && install assert.sh ${PREFIX:-/usr/local}/bin/assert"
+}
+