Apian Help

How to dictate an inspection instead of filling in a form

You don’t have to fill in inspection results by hand — you can use voice inspection instead. It works like this: you dictate the results right at the hive, and the phone recognises your speech and converts it to text. Then, if you have downloaded the large language model, the app also finds the inspection data in that text, puts it into the appropriate fields and shows it as chip buttons. All that’s left is to check that the parameters it found are correct and tap “Create inspection”. Both recognition and parsing run locally on your phone — no internet is needed for this.

What to do before your first voice inspection. You need to download two models — one to recognise your voice and another to find the inspection parameters in the transcript of what you said. The recording screen shows banners with a “Download” button, or go to “Settings” → “Voice models”.

Step 1. Open the recording screen. The “Works” section, the add button Add button, then “New inspection (voice)”. When you open this screen for the first time, the app shows detailed help — after that you can bring it up with the question mark in the header.

Step 2. Start recording. Tap the round microphone button Record voice button on the right, or press volume up. The phone vibrates briefly as confirmation and says “Recording started”.

Step 3. Talk. Hive number, queen, brood, stores, colony strength, weather — in your own words and in any order. Here’s an example of a sentence the app can parse in one go:

“Inspecting hive number 24. Saw the queen, eggs present. No queen cells. Four frames of sealed brood, stores are probably good, and I’d say the colony is strong.”

If you have two or more apiaries, don’t forget to say the apiary name or code — otherwise you will have to set it by hand later, because a hive numbered 1 can exist in several apiaries. For the full list of what the app recognises, see What you can say: the full list of parameters.

Step 4. Take photos if you need them. To take a photo, tap the camera button Take photo button on the left of the screen, or press volume down. The photos are attached to the same recording, and the number of photos appears in the corner of the camera button.

Step 5. Stop recording. Tap the “Stop Recording” button Stop recording button, or press the same volume-up button — you’ll hear “Recording saved”, and an inspection draft card with the date and time appears in the list.

One recording, one hive. The next tap of the microphone creates a new inspection draft, so at the next hive you just start recording again. The inspection draft that audio and photos are currently going into is outlined with a contrasting frame and labelled “Current inspection”.

Step 6. Wait for transcription and parsing. The stage is always shown on the card: “Recorded” → “Transcribing…” → “Transcribed” → “Analyzing text…” → “Ready to review”. Which steps happen automatically and which require your action is set by the “Processing” chip button Processing chip button at the top of the screen. Recordings are processed one at a time: while one is being transcribed or analysed, the other cards remain queued and their buttons are disabled. For work at the apiary itself, it is best to use the “Processing: Audio + text” mode and to run the parameter search with the large language model in the evening, as it takes time and drains the battery.

Step 7. Check the parameters it found. Below the text of the recording, a “Found parameters” section appears with chip buttons reading “Parameter: value” — correct anything the app misheard and add anything it missed. For the details, see Checking the parameters before creating the inspection.

Step 8. Tap “Create inspection”. You get an ordinary inspection: using the date and time of the recording, with the parameters found, with the audio and the photos attached, and with the full text of the recording added to the inspection’s notes — so nothing you said is lost. The app shows “Inspection created” and an “Open” button, so you can go straight into it if you need to. The inspection draft then disappears: it has become a permanent inspection record for the colony.

Report an error

Text with the error

We’ll let signed-in users know the outcome. Sign in