diff --git a/README.md b/README.md
index f2fb5ea..45c38b8 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,23 @@
 # bitswap-ml
 
-bitswap + ml
+[![](https://img.shields.io/badge/made%20by-Protocol%20Labs-blue.svg?style=flat-square)](http://ipn.io)
+[![](https://img.shields.io/badge/project-IPFS-blue.svg?style=flat-square)](http://ipfs.io/)
+[![](https://img.shields.io/badge/freenode-%23ipfs-blue.svg?style=flat-square)](http://webchat.freenode.net/?channels=%23ipfs)
+[![](https://img.shields.io/badge/discussion_repo-go_to_issues-brightgreen.svg?style=flat-square)](https://github.com/ipfs/bitswap-ml/issues)
+[![standard-readme compliant](https://img.shields.io/badge/standard--readme-OK-green.svg?style=flat-square)](https://github.com/RichardLitt/standard-readme)
+
+> bitswap + ml
+
+This is a **discussion repo**. That means that all of the work gets done in the [issues](https://github.com/ipfs/bitswap-ml/issues).
+
+## Contribute
+
+Feel free to join in. All welcome.
+
+### Want to hack on IPFS?
+
+[![](https://cdn.rawgit.com/jbenet/contribute-ipfs-gif/master/img/contribute.gif)](https://github.com/ipfs/community/blob/master/contributing.md)
+
+## License
+
+MIT