Developing with AI

The quickest way to get started developing for the VBOX Touch is to let an AI coding assistant do the heavy lifting. AI assistants understand MicroPython, can scaffold an application for you, explain the Racelogic libraries documented in the Programmer’s Reference, and help you debug code as you go.

We recommend Claude Code, a command-line coding assistant from Anthropic. The rest of this page describes how to get set up with it.

No development environment required

You do not need to set up a development environment to start building. Claude Code writes, edits and explains the code for you, so there is no need to install Python, configure an IDE or learn the toolchain first. Just install Claude Code, download the starter project below, and describe what you want to build – the assistant handles the development for you.

Setting up Claude Code

Installing Claude Code

Claude Code runs in a terminal and is also available as an extension for editors such as Visual Studio Code. Follow the official installation instructions here to install it and sign in with your Anthropic account.

Claude Code works on its own from the terminal, so you do not need a separate code editor to develop your application. If you would prefer to work in one, see the Development Environments page for how to install Visual Studio Code.

Downloading the starter project

To make it easy to get going, we provide a starter project that is pre-configured for VBOX Touch development with AI.

Click here to download the VBOX Touch AI starter project.

Once downloaded, extract the zip file and then open the extracted folder in Claude Code (or your editor). Do all of your work inside this folder so that the AI assistant has everything it needs to hand.

The starter project contains:

  • CLAUDE.md – a detailed project instructions file that Claude Code reads automatically. It teaches the assistant about the VBOX Touch hardware variants, the deployment model, the full MicroPython API (GUI, GNSS, CAN, serial, LEDs, sounds, logging and more) and the do’s and don’ts of writing MicroPython for the device, so the code it produces works first time.

  • Assets/Fonts/ – a library of pre-rendered Racelogic display fonts (.rft files such as Bebas Neue, Roboto and Oswald in a range of sizes) ready to load onto the device.

  • Assets/Icons/ – a set of ready-made .png icons (battery, GNSS, CAN, Bluetooth, settings, play/pause/record, arrows, and many more) you can use in your app’s interface.

  • Examples/ – 15 complete, runnable example apps (dashboards, a g-force meter, CAN and serial readouts, a piano, graphs, LED demos and more). Each is a full app the assistant can copy and adapt, and they bundle reusable helper modules (font.py, image.py, picture_button.py, screenshot.py, ui.py, utils.py) that act as a lightweight UI framework.

Working with Claude Code

With the starter project open, start Claude Code in that folder and simply describe what you want to build in plain English – for example, “create a screen that displays the current speed from GNSS”. Because the CLAUDE.md, assets and examples are already in place, the assistant has everything it needs to write code that runs on your VBOX Touch – it will typically start from the closest example and reuse the bundled fonts, icons and helper modules.

When the assistant has written your app, it will tell you exactly which files to copy to the root of the SD card. Insert the card into your VBOX Touch and power it on, and the device runs your main.py automatically – no special tools or upload step required. See the Getting Started tutorial for more detail on running an app, and the Development Environments page if you would prefer to set up an editor with live device connection.