> ## Documentation Index
> Fetch the complete documentation index at: https://docs.threetone.in/llms.txt
> Use this file to discover all available pages before exploring further.

# Raspberry Pi

> Prepare a controlled device prototype with tested audio, restricted credentials, and explicit offline and restart behavior.

Prepare a Raspberry Pi prototype that can test its microphone and speaker locally, show whether it is recording, and recover predictably after a restart. Keep the device test separate from a future agent connection.

<Note>
  No Threetone Raspberry Pi runtime package or released live voice walkthrough is verified. Local audio and server-side API reads can be tested independently; they do not start a Threetone conversation.
</Note>

## Before you begin

Record the board model, Raspberry Pi OS release, power supply, network, and audio devices. Use a controlled location and test audio without bystanders' conversations. Decide how a user can stop capture physically or through the device interface.

<Steps>
  <Step title="Prepare the operating system and access" id="pi-cookbook-system">
    Follow Raspberry Pi's [operational security guidance](https://www.raspberrypi.com/documentation/security/operational-security.html) for maintained software, limited user permissions, and SSH access. Give the application only the device access it needs. Keep remote administration separate from the public user interface.
  </Step>

  <Step title="Verify the actual audio route" id="pi-cookbook-audio">
    Record and play a short local sample with the selected input and output. Check clipping, speaker feedback, and device removal. Raspberry Pi's [audio documentation](https://www.raspberrypi.com/documentation/accessories/audio.html) explains the available audio frameworks; verify the stack installed on your OS image instead of assuming desktop and headless images match.
  </Step>

  <Step title="Define the server boundary" id="pi-cookbook-server">
    For a shared kiosk, keep workspace API keys on an application backend and give the device a narrowly scoped application identity. Use the [server-side quickstart](/agents-platform/guides/quickstarts/server-side) for authorized configuration reads. Do not place secrets in an image distributed to multiple devices.
  </Step>

  <Step title="Exercise offline and restart cases" id="pi-cookbook-recovery">
    Test unplugged audio, network loss, restart, and user cancellation. Show an offline state, bound any local queue, and start with capture stopped after reboot. Do not replay recorded speech or external actions after reconnect without a supported replay contract and current user intent.
  </Step>
</Steps>

Keep the resulting device inventory and recovery behavior with your [custom-channel design](/agents-platform/configure/integrations/custom-channel). A future release still needs session authorization, supported audio transport, and end-to-end execution verification.

## Frequently asked questions

<AccordionGroup>
  <Accordion title="Can I run a Threetone agent entirely on the device?" id="faq-pi-cookbook-local-runtime">No local Threetone agent runtime is documented. This guide prepares device input, output, and an application boundary.</Accordion>
  <Accordion title="Should the device record while offline?" id="faq-pi-cookbook-offline-recording">Choose an explicit product policy. The default preparation workflow stops capture and does not retain a backlog of speech for automatic upload.</Accordion>
</AccordionGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.