diff --git a/README.md b/README.md
index 8db6360ba6593356d3b3398bba3d868638df62e1..56835a3d2d17d642a1401e7c7341063c091b9a62 100644
--- a/README.md
+++ b/README.md
@@ -1 +1,8 @@
-Making spiking neural models expressed in Julia amenable to python sciunit testing.
+# A Julia port of [NeuronUnitOpt](https://github.com/russelljjarvis/NeuronunitOpt)
+
+This project glues together three repositories (two Julia, one python) with the result that spiking neural [models expressed in Julia](https://github.com/AStupidBear/SpikingNeuralNetworks.jl) to facilitate python neuronunit/sciunit testing of neuron model fitness and julia genetic algorith optimization.
+
+[![Build Status](https://travis-ci.org/russelljjarvis/SpikingNeuralNetworks.jl.svg?branch=master)](https://travis-ci.org/russelljjarvis/SpikingNeuralNetworks.jl)
+
+
+[![Binder](https://mybinder.org/badge_logo.svg)](https://mybinder.org/v2/gh/russelljjarvis/SpikingNeuralNetworks.jl/master)