README improvements
deprecate (but still support) herokai_only