Spaces:
Running
Running
Add: Organization card
Browse files- .gitattributes +1 -0
- README.md +162 -4
- assets/ST_logo_2024_white.png +3 -0
.gitattributes
CHANGED
|
@@ -33,3 +33,4 @@ saved_model/**/* filter=lfs diff=lfs merge=lfs -text
|
|
| 33 |
*.zip filter=lfs diff=lfs merge=lfs -text
|
| 34 |
*.zst filter=lfs diff=lfs merge=lfs -text
|
| 35 |
*tfevents* filter=lfs diff=lfs merge=lfs -text
|
|
|
|
|
|
| 33 |
*.zip filter=lfs diff=lfs merge=lfs -text
|
| 34 |
*.zst filter=lfs diff=lfs merge=lfs -text
|
| 35 |
*tfevents* filter=lfs diff=lfs merge=lfs -text
|
| 36 |
+
assets/ST_logo_2024_white.png filter=lfs diff=lfs merge=lfs -text
|
README.md
CHANGED
|
@@ -1,10 +1,168 @@
|
|
| 1 |
---
|
| 2 |
title: README
|
| 3 |
-
emoji:
|
| 4 |
-
colorFrom:
|
| 5 |
-
colorTo:
|
| 6 |
sdk: static
|
| 7 |
pinned: false
|
| 8 |
---
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 9 |
|
| 10 |
-
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
---
|
| 2 |
title: README
|
| 3 |
+
emoji: ⚡
|
| 4 |
+
colorFrom: gray
|
| 5 |
+
colorTo: gray
|
| 6 |
sdk: static
|
| 7 |
pinned: false
|
| 8 |
---
|
| 9 |
+
<style>
|
| 10 |
+
.st-header-banner {
|
| 11 |
+
width: 100%;
|
| 12 |
+
height: 120px;
|
| 13 |
+
margin: 0 0 12px 0;
|
| 14 |
+
padding: 0 24px;
|
| 15 |
+
box-sizing: border-box;
|
| 16 |
+
background: #03234B;
|
| 17 |
+
display: flex;
|
| 18 |
+
align-items: center;
|
| 19 |
+
justify-content: flex-start;
|
| 20 |
+
}
|
| 21 |
+
.st-logo-right {
|
| 22 |
+
height: 72px;
|
| 23 |
+
width: auto;
|
| 24 |
+
object-fit: contain;
|
| 25 |
+
}
|
| 26 |
+
img.rotating-content {
|
| 27 |
+
width: 300px;
|
| 28 |
+
height: 150px;
|
| 29 |
+
object-fit:cover;
|
| 30 |
+
object-position:center;
|
| 31 |
+
}
|
| 32 |
+
.icon {
|
| 33 |
+
width: 1.5em;
|
| 34 |
+
height: 1.5em;
|
| 35 |
+
vertical-align: -.7em;
|
| 36 |
+
padding: .25em .5em .25em .25em;
|
| 37 |
+
}
|
| 38 |
+
ul.social {
|
| 39 |
+
list-style: none;
|
| 40 |
+
padding-left: 0;
|
| 41 |
+
}
|
| 42 |
+
ul.social li {
|
| 43 |
+
padding-left: .5em;
|
| 44 |
+
display: flex;
|
| 45 |
+
}
|
| 46 |
+
.architectureImage {
|
| 47 |
+
border: 0.5px solid black;
|
| 48 |
+
}
|
| 49 |
+
</style>
|
| 50 |
+
<div class="st-header-banner">
|
| 51 |
+
<img src="assets/ST_logo_2024_white.png" alt="ST Logo" class="st-logo-right"/>
|
| 52 |
+
</div>
|
| 53 |
|
| 54 |
+
|
| 55 |
+
|
| 56 |
+
_**Innovating with edge AI on STM32 and Hugging Face.**_
|
| 57 |
+
|
| 58 |
+
STMicroelectronics is a global semiconductor leader pushing artificial intelligence down to the most resource-constrained microcontrollers. With the **STM32 AI ecosystem**, ST provides an end-to-end pipeline — from pre-trained models in the **Model Zoo** to bare-metal optimized deployment — enabling embedded developers to build intelligent applications without deep ML expertise.
|
| 59 |
+
Models are optimized, quantized and validated to run directly on ST Neural-ART but also Cortex-M4, M7, M85 and M33 cores.
|
| 60 |
+
|
| 61 |
+
---
|
| 62 |
+
## End-to-End AI Pipeline
|
| 63 |
+
```
|
| 64 |
+
┌────────────────────────────┐
|
| 65 |
+
│ EXPLORE │
|
| 66 |
+
├────────────────────────────┤
|
| 67 |
+
│ STM32 AI Model Zoo │
|
| 68 |
+
│ │
|
| 69 |
+
└────────────────────────────┘
|
| 70 |
+
│
|
| 71 |
+
▼
|
| 72 |
+
┌────────────────────────────┐
|
| 73 |
+
│ TRAIN │
|
| 74 |
+
├────────────────────────────┤
|
| 75 |
+
│ STM32 AI Model |
|
| 76 |
+
| Zoo Services │
|
| 77 |
+
└────────────────────────────┘
|
| 78 |
+
│
|
| 79 |
+
▼
|
| 80 |
+
┌────────────────────────────┐
|
| 81 |
+
│ OPTIMIZE / QUANTIZE │
|
| 82 |
+
├────────────────────────────┤
|
| 83 |
+
│ STM32 AI Model |
|
| 84 |
+
| Zoo Services │
|
| 85 |
+
└────────────────────────────┘
|
| 86 |
+
│
|
| 87 |
+
▼
|
| 88 |
+
┌────────────────────────────┐
|
| 89 |
+
│ EVALUATE / PREDICT │
|
| 90 |
+
├────────────────────────────┤
|
| 91 |
+
│ STM32 AI Model |
|
| 92 |
+
| Zoo Services │
|
| 93 |
+
└────────────────────────────┘
|
| 94 |
+
│
|
| 95 |
+
▼
|
| 96 |
+
┌────────────────────────────┐
|
| 97 |
+
│ BENCHMARK │
|
| 98 |
+
├────────────────────────────┤
|
| 99 |
+
│ STM32Cube AI Studio │
|
| 100 |
+
| STM32 Developer Cloud |
|
| 101 |
+
└────────────────────────────┘
|
| 102 |
+
│
|
| 103 |
+
▼
|
| 104 |
+
┌────────────────────────────┐
|
| 105 |
+
│ CONVERT │
|
| 106 |
+
├────────────────────────────┤
|
| 107 |
+
│ STM32Cube AI Studio │
|
| 108 |
+
│ ST Edge AI Core │
|
| 109 |
+
└────────────────────────────┘
|
| 110 |
+
│
|
| 111 |
+
▼
|
| 112 |
+
┌────────────────────────────┐
|
| 113 |
+
│ DEPLOY │
|
| 114 |
+
├────────────────────────────┤
|
| 115 |
+
│ STM32Cube ecosystem │
|
| 116 |
+
│ (tools, middleware, BSP…)│
|
| 117 |
+
└────────────────────────────┘
|
| 118 |
+
```
|
| 119 |
+
|
| 120 |
+
This diagram summarizes the typical STM32 edge AI workflow from model discovery to on-device deployment:
|
| 121 |
+
|
| 122 |
+
1. **Explore**: Start from the STM32 AI Model Zoo to browse available architectures, pretrained checkpoints, and application examples.
|
| 123 |
+
2. **Train**: Use Model Zoo Services to retrain an existing model or build a task-specific pipeline on your own dataset.
|
| 124 |
+
3. **Optimize / Quantize**: Reduce model size and compute cost so the network fits embedded constraints while preserving the best possible accuracy.
|
| 125 |
+
4. **Evaluate / Predict**: Validate accuracy, inspect predictions, and compare tradeoffs before moving to hardware execution.
|
| 126 |
+
5. **Benchmark**: Measure latency, memory footprint, and target compatibility with STM32Cube AI Studio and STM32 Developer Cloud.
|
| 127 |
+
6. **Convert**: Transform the trained model into STM32-ready artifacts using STM32Cube AI Studio and ST Edge AI Core.
|
| 128 |
+
7. **Deploy**: Integrate the generated code into the STM32Cube ecosystem, including firmware, middleware, and board support components.
|
| 129 |
+
|
| 130 |
+
In short, the flow shows how a model moves from selection and training to optimization, hardware validation, and final integration on STM32 devices.
|
| 131 |
+
|
| 132 |
+
## Build, Optimize and Deploy AI/ML on STM32
|
| 133 |
+
|
| 134 |
+
- **STM32 AI Model Zoo**: A GitHub collection of reference machine learning models optimized for STM32 microcontrollers.
|
| 135 |
+
- **Application-Oriented Model Library**: A large set of models ready for re-training across multiple use cases.
|
| 136 |
+
- **Pre-trained Models Across Frameworks**: Reference models variants available for PyTorch, TensorFlow, and ONNX workflows.
|
| 137 |
+
- **End-to-End Scripts & Services**: Tools to retrain, quantize, evaluate, and benchmark models on custom datasets, plus autogenerated application code examples via [stm32ai-modelzoo-services](https://github.com/STMicroelectronics/stm32ai-modelzoo-services/tree/main)
|
| 138 |
+
- **Fast Deployment + Full Customization**: Use pretrained categories for quick deployment, or apply transfer learning / full training from scratch on your own data.
|
| 139 |
+
- **Reference Performance Metrics**: Results provided on STM32 MCU, NPU, and MPU targets for both float and quantized models.
|
| 140 |
+
- **Expanded Framework Support**: Comprehensive PyTorch support complements TensorFlow and ONNX in unified end-to-end workflows (train, evaluate, quantize, benchmark, deploy).
|
| 141 |
+
|
| 142 |
+
---
|
| 143 |
+
|
| 144 |
+
## Key Tools & Ecosystem
|
| 145 |
+
|
| 146 |
+
- **STEdgeAI Core**: Converts trained neural networks into optimized C code for STM32.
|
| 147 |
+
- **STM32 AI Model Zoo services**: This repository provide scripts and workflows to ease end-to-end AI model training and integration on ST devices. They offer a valuable foundation to add AI capabilities to STM32-based projects.
|
| 148 |
+
- **STM32 AI Model Zoo** The repository with a of reference pre-trained machine learning models optimized for STM32 microcontrollers generated thanks to the STM32 AI Model Zoo services.
|
| 149 |
+
- **Integration with Popular Frameworks**:
|
| 150 |
+
- TensorFlow / Keras
|
| 151 |
+
- PyTorch (via ONNX export)
|
| 152 |
+
- ONNX Runtime pipelines
|
| 153 |
+
|
| 154 |
+
---
|
| 155 |
+
|
| 156 |
+
## Links
|
| 157 |
+
- **[STM32 AI Model Zoo services](https://github.com/STMicroelectronics/stm32ai-modelzoo-services/tree/main)**
|
| 158 |
+
- **[STEdgeAI Core](https://www.st.com/en/development-tools/stedgeai-core.html)**
|
| 159 |
+
- **[STM32 Developer Cloud](https://stm32ai-cs.st.com/home)**
|
| 160 |
+
- **[STM32AI Model Zoo](https://github.com/STMicroelectronics/stm32ai-modelzoo/tree/main)**
|
| 161 |
+
- **[STM32AI Cube Studio](https://www.st.com/en/development-tools/stedgeai-cubeai.html)**
|
| 162 |
+
---
|
| 163 |
+
|
| 164 |
+
## 🤝 Contact & Contributions
|
| 165 |
+
|
| 166 |
+
- For technical questions: [ST EdgeAI Community](https://community.st.com/t5/edge-ai/bd-p/edge-ai)
|
| 167 |
+
- For issues or feature requests, use the **Issues** or **Discussions** tabs in the respective repos.
|
| 168 |
+
- Contributions and feedback on models, pipelines, and docs are welcome.
|
assets/ST_logo_2024_white.png
ADDED
|
Git LFS Details
|