clarify python and add usage examples