feat: Complete README

[msramalho]

I'd suggest adding these to the readme file:

• installation instructions (maybe some badges too, eg here)
• development setup (or a link to info on how to setup a poetry project)
• any other cleanup like my addition of the deployment instructions

[msramalho]

Also, replacing the instructions from using main.py to pypi package