diff --git a/README.md b/README.md
index 8b13789..79704da 100644
--- a/README.md
+++ b/README.md
@@ -1 +1,33 @@
+market-agents
+====
+
+[![Build Status](https://travis-ci.org/DrPaulBrewer/market-agents.svg?branch=master)](https://travis-ci.org/DrPaulBrewer/market-agents)
+[![Coverage Status](https://coveralls.io/repos/github/DrPaulBrewer/market-agents/badge.svg?branch=master)](https://coveralls.io/github/DrPaulBrewer/market-agents?branch=master)
+
+
+## Provides EventEmitter Agent framework for robot trading in economic and financial simulations
+
+### Warning: versions less than 1.0.0 are pre-release/experimental, may be subject to massive change without notice or not work 
+
+##Installation
+
+    npm install market-agents --save
+
+##Initialization
+
+    var MarketAgents = require('market-agents');
+ 
+##Usage
+
+    var myAgent = new MarketAgents.Agent();
+    var myZIAgent = new MarketAgents.ziAgent();
+    myAgent.on('some-event', function(...){...});
+
+##Events
+
+TBA
+
+##Functions     
+
+TBA