Jump to content

How Chuk Chat Works

From Chuk Wiki

How Chuk Chat Works

[edit]

This page explains the full Chuk Chat flow in plain language.

The short version

[edit]

When you send a message, Chuk Chat sends your request through a secure backend, routes it to an open-weight AI model, streams the answer back in real time, and stores your chat history in encrypted form.

Step-by-step message flow

[edit]
  1. You type a message in the app (web, desktop, or mobile).
  2. Your app session is authenticated with your account.
  3. The request goes to the Chuk Chat backend (api.chuk.chat).
  4. The backend routes the request through OpenRouter to an allowed open-weight provider/model.
  5. The AI response is streamed back chunk-by-chunk, so you can read it live.
  6. Your conversation is saved in encrypted form and synced between your devices.

Why responses appear live

[edit]

Chuk Chat uses streaming protocols so text appears while it is generated, instead of waiting for a full final answer.

What happens when you use voice

[edit]
  • Your recorded audio is sent for transcription.
  • Transcription is handled by Groq Whisper.
  • The transcribed text is then sent as a normal chat message.

What happens when you attach files/images

[edit]
  • Attachments are prepared and sent with your message.
  • Vision-capable models can use attached images for context.
  • In chat history, file/image references are preserved so conversations remain understandable.

What happens when you are offline

[edit]
  • The app can show cached chat history.
  • Once online again, sync services update your data.
[edit]