From your point of view, everything is clear, because you are the author: you know what you are doing, why, etc.

But for a visitor of your github like me, even if I do a lot of Python, it's hard to understand quickly what it's about.

As I don't have 10 minutes to spend for each ShowHN, a video would be great to understand what it's about :)