Skip to Content
Voice apps

Voice apps

An app is a short script for the model: a routine, a game or a guided exercise. Apps are plain data in firmware/data/assistant.json, so adding one needs no C++.

AppidWhat it does
Morning briefingmorning_newsWeather, the lunar date and a few headlines in about a minute
Bedtime storybedtime_storyVietnamese fairy tales, told in short parts
English practiceenglish_practiceSlow English conversation with corrections in Vietnamese
QuizquizFolk riddles and general knowledge, with a score
BreathingbreathingOne minute of paced breathing to relax
What to eat todaywhat_to_eatVietnamese dishes from what is in your fridge, with steps
Focus 25 minutespomodoroA 25-minute work timer, then a break reminder
Look and telllook_and_tellUses the camera to describe objects, read text and comment
Evening journalevening_journalTell it about your day; it summarizes and saves it
Fun horoscopefun_horoscopeUpbeat wishes by zodiac sign, just for fun
Learn Koreanlearn_koreanThree Korean words at a time, slowly, with repetition

Opening an app

  • Wheel: double-press while resting to open the app list; rotate, then press to open.
  • Menu: hold the wheel → Apps.
  • Voice: “open the quiz”, “tell me a bedtime story”. The app.open tool loads the script.
  • Web settings: the Chat tab lists every app; click one to start it on the device.

The morning briefing also runs by itself: with Morning greeting on, the first time the camera sees someone between 6:00 and 10:00, the character says good morning and reads the briefing (once a day). See Camera and smart features.

Writing an app

{ "id": "riddles", "title": "Riddles", "desc": "Short riddles for kids, with hints.", "prompt": "Ask one short riddle at a time. Wait for the answer, give a hint if needed..." }

id is lowercase [a-z0-9_]; title and desc are shown in the menu and the web settings; prompt is sent to the model when the app opens. Run python3 firmware/scripts/validate_data.py to check the file.