Connect an Arm-based Android phone and run TinySD Studio

Connect an Android phone

Enable Developer options and USB debugging on the phone. Connect the phone to your development computer with USB, unlock it, and accept the debugging authorization prompt.

Verify that the phone is listed in adb:

    

        
        
adb devices -l

    

The output lists the authorized phone and its device serial. If the phone reports unauthorized, unlock it and accept the debugging prompt. If the phone doesn’t appear, see Run apps on a hardware device .

Confirm that the phone uses the Arm64 ABI and runs Android 9 (API 28) or later:

    

        
        
adb shell getprop ro.product.cpu.abi
adb shell getprop ro.build.version.sdk

    

The first command should print arm64-v8a. The second should print 28 or greater. TinySD Studio also requires Android to expose at least 7 GB of memory to the application.

Clone the application repository

Clone the repository with Git, then enter the project directory:

    

        
        
git clone https://github.com/arm-education/ai-portal-android-app-image-generation.git
cd ai-portal-android-app-image-generation

    

Run the remaining terminal commands from this project directory.

Prepare the Arm AI Portal model downloader

The sample repository includes a downloader for its supported Arm AI Portal model package. Create a Python virtual environment and install the Hugging Face Hub package used by the downloader:

    

        
        

python3 -m venv .hf-venv
.hf-venv/bin/python -m pip install --upgrade pip huggingface_hub
  

    

    

        
        

python -m venv .hf-venv
.\.hf-venv\Scripts\python.exe -m pip install --upgrade pip huggingface_hub
  

    

The later commands invoke the environment’s Python executable directly, so the PowerShell script-execution policy doesn’t need to be changed.

If Python reports that venv is unavailable on Debian or Ubuntu, install the python3-venv package and rerun the command.

Build and run the TinySD Studio application

Use the Gradle wrapper to build and lint the debug Android package (APK):

    

        
        

chmod +x gradlew
./gradlew :app:assembleDebug :app:lintDebug
  

    

    

        
        

.\gradlew.bat :app:assembleDebug :app:lintDebug
  

    

You don’t need to install Gradle separately because the repository includes the wrapper.

Install the APK and start TinySD Studio with the commands used on every operating system:

    

        
        
adb install -r app/build/outputs/apk/debug/app-debug.apk
adb shell am start -n org.arm.learningpath.tinysdstudio/.MainActivity

    

TinySD Studio opens without a model. Generate image remains unavailable until you import the model package. Installing with adb install -r preserves a model package imported previously.

TinySD Studio before a model package is imported

What you’ve accomplished and what’s next

You’ve connected an Arm-based Android phone, prepared the model downloader, and confirmed that TinySD Studio builds and starts.

Next, you’ll download an optimized TinySD model from the Arm AI Portal and generate an image locally.