Apply the model card standard

README.md

@@ -6,40 +6,51 @@ pipeline_tag: image-classification
 library_name: executorch
 ---
 
-# Introduction
+# efficientnet-v2-s
 
-This repository hosts the
-[efficientnet_v2_s](https://pytorch.org/vision/0.20/models/generated/torchvision.models.efficientnet_v2_s.html#torchvision.models.efficientnet_v2_s)
-models for the [React Native
-ExecuTorch](https://www.npmjs.com/package/react-native-executorch) library. It
-includes model exported for xnnpack, as well as coreml in `.pte` format, ready
-for use in the **ExecuTorch** runtime.
+This repository hosts the **efficientnet-v2-s** models exported for the
+[React Native ExecuTorch](https://www.npmjs.com/package/react-native-executorch)
+library as ExecuTorch `.pte` programs, ready to run on device.
 
-If you'd like to run these models in your own ExecuTorch runtime, refer to the
-[official documentation](https://pytorch.org/executorch/stable/index.html) for
-setup instructions.
+Upstream model: [efficientnet_v2_s](https://pytorch.org/vision/0.20/models/generated/torchvision.models.efficientnet_v2_s.html#torchvision.models.efficientnet_v2_s)
 
-## Compatibility
+## Variants
+
+| Path | Backend | Precision |
+| --- | --- | --- |
+| `coreml/efficientnet_v2_s_coreml_fp16.pte` | coreml | fp16 |
+| `xnnpack/efficientnet_v2_s_xnnpack_fp32.pte` | xnnpack | fp32 |
+| `xnnpack/efficientnet_v2_s_xnnpack_int8.pte` | xnnpack | int8 |
+
+## Unshipped backends
 
-If you intend to use this models outside of React Native ExecuTorch, make sure
-your runtime is compatible with the **ExecuTorch** version used to export the
-`.pte` files. For more details, see the compatibility note in the [ExecuTorch
-GitHub
-repository](https://github.com/pytorch/executorch/blob/11d1742fdeddcf05bc30a6cfac321d2a2e3b6768/runtime/COMPATIBILITY.md?plain=1#L4).
-If you work with React Native ExecuTorch, the constants from the library will
-guarantee compatibility with runtime used behind the scenes.
+A backend directory carrying a `NOTES.md` and no `.pte` was exported and
+not published. Its note records what went wrong.
 
-These models were exported using **ExecuTorch** version 1.1.0 and **no forward
-compatibility** is guaranteed. Older versions of the runtime may not work with
-these files.
+- `mlx` ([why](https://huggingface.co/software-mansion/react-native-executorch-efficientnet-v2-s/blob/main/mlx/NOTES.md))
 
-### Repository Structure
+## Repository structure
 
-The repository is organized into two main directories:
+```
+config.json                                 39 B
+coreml/config.json                          840 B
+coreml/efficientnet_v2_s_coreml_fp16.pte    41.8 MB
+mlx/NOTES.md                                2.5 kB
+xnnpack/config.json                         1.4 kB
+xnnpack/efficientnet_v2_s_xnnpack_fp32.pte  81.7 MB
+xnnpack/efficientnet_v2_s_xnnpack_int8.pte  21.9 MB
+```
+
+## Compatibility
 
-- `xnnpack`
-- `coreml`
+These files are published for the **ExecuTorch v1.4.1** runtime. ExecuTorch
+gives no forward compatibility guarantee, so an older runtime may fail to load
+them.
 
-Each directory contains models exported for the respective backend.
+To use them in React Native ExecuTorch, pass the model constant shipped in the
+library's model registry to the corresponding task pipeline. See the
+[documentation](https://docs.swmansion.com/react-native-executorch/docs/fundamentals/loading-models).
 
-- The `.pte` file should be passed to the `modelSource` parameter.
+To load these files in your own ExecuTorch runtime, read the
+[compatibility note](https://github.com/pytorch/executorch/blob/main/runtime/COMPATIBILITY.md)
+first.