diff --git a/CONTRIBUTORS.rst b/CONTRIBUTORS.rst
index 292d05e..d46127c 100644
--- a/CONTRIBUTORS.rst
+++ b/CONTRIBUTORS.rst
@@ -1,5 +1,19 @@
-==============================
- Contributors to ``pgtricks``
-==============================
+==========================
+ Contributors to Pgtricks
+==========================
 
+(in alphabetic order and with GitHub handles)
+
+.. This file is automatically generated. Please update ``contributors.yaml``
+   instead and see ``CONTRIBUTING.rst`` for instructions on how to update
+   this file.
+
+- Albert Cai (@oldcai)
 - Antti Kaihola (@akaihola)
+- Connor Sherson (@connorsherson)
+- Jonathan (@jomonson)
+- Jose Luis (@jescobar87)
+- mihuman (@mihuman)
+- Phil Ayres (@philayres)
+- Seweryn Niemiec (@thugcee)
+- tyctor (@tyctor)
diff --git a/README.rst b/README.rst
index d6b2298..22370bd 100644
--- a/README.rst
+++ b/README.rst
@@ -100,3 +100,127 @@ Usage::
     optional arguments:
       -h, --help            show this help message and exit
       --output-dir OUTPUT_DIR, -o OUTPUT_DIR
+
+
+Contributors ✨
+===============
+
+Thanks goes to these wonderful people (`emoji key`_):
+
+.. raw:: html
+
+   <!-- ALL-CONTRIBUTORS-LIST:START - Do not remove or modify this section
+        This is automatically generated. Please update `contributors.yaml` and
+        see `CONTRIBUTING.rst` for how to re-generate this table. -->
+   <table>
+     <tr>
+       <td align="center">
+         <a href="https://github.com/oldcai">
+           <img src="https://avatars.githubusercontent.com/u/1150130?v=3" width="100px;" alt="@oldcai" />
+           <br />
+           <sub>
+             <b>Albert Cai</b>
+           </sub>
+         </a>
+         <br />
+         <a href="https://github.com/akaihola/pgtricks/issues?q=author%3Aoldcai" title="Bug reports">🐛</a>
+       </td>
+       <td align="center">
+         <a href="https://github.com/akaihola">
+           <img src="https://avatars.githubusercontent.com/u/13725?v=3" width="100px;" alt="@akaihola" />
+           <br />
+           <sub>
+             <b>Antti Kaihola</b>
+           </sub>
+         </a>
+         <br />
+         <a href="https://github.com/akaihola/pgtricks/pulls?q=is%3Apr+author%3Aakaihola" title="Code">💻</a>
+       </td>
+       <td align="center">
+         <a href="https://github.com/connorsherson">
+           <img src="https://avatars.githubusercontent.com/u/59890055?v=3" width="100px;" alt="@connorsherson" />
+           <br />
+           <sub>
+             <b>Connor Sherson</b>
+           </sub>
+         </a>
+         <br />
+         <a href="https://github.com/akaihola/pgtricks/pulls?q=is%3Apr+author%3Aconnorsherson" title="Code">💻</a>
+       </td>
+       <td align="center">
+         <a href="https://github.com/jomonson">
+           <img src="https://avatars.githubusercontent.com/u/5840967?v=3" width="100px;" alt="@jomonson" />
+           <br />
+           <sub>
+             <b>Jonathan</b>
+           </sub>
+         </a>
+         <br />
+         <a href="https://github.com/akaihola/pgtricks/pulls?q=is%3Apr+author%3Ajomonson" title="Code">💻</a>
+       </td>
+       <td align="center">
+         <a href="https://github.com/jescobar87">
+           <img src="https://avatars.githubusercontent.com/u/4821014?v=3" width="100px;" alt="@jescobar87" />
+           <br />
+           <sub>
+             <b>Jose Luis</b>
+           </sub>
+         </a>
+         <br />
+         <a href="https://github.com/akaihola/pgtricks/issues?q=author%3Ajescobar87" title="Bug reports">🐛</a>
+       </td>
+       <td align="center">
+         <a href="https://github.com/philayres">
+           <img src="https://avatars.githubusercontent.com/u/294874?v=3" width="100px;" alt="@philayres" />
+           <br />
+           <sub>
+             <b>Phil Ayres</b>
+           </sub>
+         </a>
+         <br />
+         <a href="https://github.com/akaihola/pgtricks/issues?q=author%3Aphilayres" title="Bug reports">🐛</a>
+       </td>
+     </tr>
+     <tr>
+       <td align="center">
+         <a href="https://github.com/thugcee">
+           <img src="https://avatars.githubusercontent.com/u/20202?v=3" width="100px;" alt="@thugcee" />
+           <br />
+           <sub>
+             <b>Seweryn Niemiec</b>
+           </sub>
+         </a>
+         <br />
+         <a href="https://github.com/akaihola/pgtricks/issues?q=author%3Athugcee" title="Bug reports">🐛</a>
+       </td>
+       <td align="center">
+         <a href="https://github.com/mihuman">
+           <img src="https://avatars.githubusercontent.com/u/16466143?v=3" width="100px;" alt="@mihuman" />
+           <br />
+           <sub>
+             <b>mihuman</b>
+           </sub>
+         </a>
+         <br />
+         <a href="https://github.com/akaihola/pgtricks/pulls?q=is%3Apr+author%3Amihuman" title="Code">💻</a>
+       </td>
+       <td align="center">
+         <a href="https://github.com/tyctor">
+           <img src="https://avatars.githubusercontent.com/u/44854182?v=3" width="100px;" alt="@tyctor" />
+           <br />
+           <sub>
+             <b>tyctor</b>
+           </sub>
+         </a>
+         <br />
+         <a href="https://github.com/akaihola/pgtricks/issues?q=author%3Atyctor" title="Bug reports">🐛</a>
+       </td>
+     </tr>
+   </table>   <!-- ALL-CONTRIBUTORS-LIST:END -->
+
+This project follows the all-contributors_ specification.
+Contributions of any kind are welcome!
+
+.. _README.rst: https://github.com/akaihola/pgtricks/blob/master/README.rst
+.. _emoji key: https://allcontributors.org/docs/en/emoji-key
+.. _all-contributors: https://allcontributors.org
diff --git a/contributors.yaml b/contributors.yaml
new file mode 100644
index 0000000..f714c21
--- /dev/null
+++ b/contributors.yaml
@@ -0,0 +1,19 @@
+---
+akaihola:
+  - {link_type: pulls-author, type: Code}
+connorsherson:
+  - {link_type: pulls-author, type: Code}
+jescobar87:
+  - {link_type: issues, type: Bug reports}
+jomonson:
+  - {link_type: pulls-author, type: Code}
+mihuman:
+  - {link_type: pulls-author, type: Code}
+oldcai:
+  - {link_type: issues, type: Bug reports}
+philayres:
+  - {link_type: issues, type: Bug reports}
+thugcee:
+  - {link_type: issues, type: Bug reports}
+tyctor:
+  - {link_type: issues, type: Bug reports}