2. Installation

Tiny ML ModelZoo 1.5.0 installs with pip. There are exactly two supported install paths, and neither needs more than one command to get the whole toolchain (tinyml_modelmaker, tinyml_tinyverse and tinyml_torchmodelopt come in automatically as prebuilt wheels from TI’s download server).

Contents

• 2.1. Prerequisites
  • 2.1.1. System Requirements
  • 2.1.2. Python
  • 2.1.3. pip and Git
  • 2.1.4. TI Compiler Tools (for compilation)
  • 2.1.5. Verification Checklist
• 2.2. Wheel Installation
  • 2.2.1. Quick Install
  • 2.2.2. What Is in the Wheel
  • 2.2.3. Running with the Wheel Install
  • 2.2.4. Verifying Installation
  • 2.2.5. Updating and Uninstalling
  • 2.2.6. Limitations of the Wheel Install
  • 2.2.7. Troubleshooting
  • 2.2.8. Next Steps
• 2.3. Clone Installation
  • 2.3.1. Step 1: Clone the Repository
  • 2.3.2. Step 2: Create a Virtual Environment and Install
  • 2.3.3. Step 3: Verify Installation
  • 2.3.4. Step 4: Configure the Compiler
  • 2.3.5. Step 5: Run the Hello World Example
  • 2.3.6. Folder Layout
  • 2.3.7. Common Developer Tasks
  • 2.3.8. Updating
  • 2.3.9. Troubleshooting
  • 2.3.10. Next Steps
• 2.4. Windows Setup
  • 2.4.1. Native Windows
  • 2.4.2. WSL2
  • 2.4.3. Common Windows Issues
  • 2.4.4. Next Steps
• 2.5. Linux Setup
  • 2.5.1. System Preparation
  • 2.5.2. Install Python 3.10
  • 2.5.3. Installation
  • 2.5.4. Verification
  • 2.5.5. GPU Setup (Optional)
  • 2.5.6. Shell Configuration
  • 2.5.7. Troubleshooting
  • 2.5.8. Next Steps
• 2.6. macOS Setup
  • 2.6.1. Supported Hardware
  • 2.6.2. Prerequisites
  • 2.6.3. Installation
  • 2.6.4. Using the Apple GPU (MPS)
  • 2.6.5. Notes
  • 2.6.6. Next Steps
• 2.7. Environment Variables
  • 2.7.1. How the Paths Are Resolved
  • 2.7.2. Which Variable for Which Device
  • 2.7.3. Setting Variables
  • 2.7.4. Installing the Compilers
  • 2.7.5. Verifying
  • 2.7.6. Troubleshooting
  • 2.7.7. Next Steps
• 2.8. Agent Skill (Claude Code)

2.9. Which Install Should I Choose?

Scenario	Use This Install
I want to train and compile with the TI-provided models, using my own config files	Wheel install (Wheel Installation)
I want to use the model zoo as a Python library in my own scripts	Wheel install (Wheel Installation)
I want the ready-to-run examples/ folder and the run_tinyml_modelzoo scripts	Clone install (Clone Installation)
I want to add or change a model architecture	Clone install (Clone Installation)
I want to bring my own model (BYOM)	Clone install (Clone Installation)

2.10. Quick Start

Wheel install (no model changes)Clone install (add or change models)

pip install https://software-dl.ti.com/C2000/esd/mcu_ai/wheel/tinyml_modelzoo-1.5.0-py3-none-any.whl

Note

Starting with 1.5.0 you clone only tinyml-modelzoo. You no longer clone tinyml-tensorlab or the separate modelmaker, tinyverse and modeloptimization repositories, and there is no setup_all script. tinyml-tensorlab is the 1.4.0 entry point and is now deprecated.

After installing, continue with Environment Variables (compiler setup, needed only for compiling to a device) and then Quickstart.