change request typehint
minor changes - formatting
update readme