Replace gh readme with model card

fix: code review improvements - error handling, validation, and safety

initial commit

initial commit