Editing How Chuk Chat Works (section)

= How Chuk Chat Works =

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

== The short version ==
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 ==
# You type a message in the app (web, desktop, or mobile).
# Your app session is authenticated with your account.
# The request goes to the Chuk Chat backend (api.chuk.chat).
# The backend routes the request through OpenRouter to an allowed open-weight provider/model.
# The AI response is streamed back chunk-by-chunk, so you can read it live.
# Your conversation is saved in encrypted form and synced between your devices.

== Why responses appear live ==
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 ==
* 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 ==
* 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 ==
* The app can show cached chat history.
* Once online again, sync services update your data.

== Related pages ==
* [[Chuk Chat Architecture]]
* [[Chuk Chat AI Providers and Services]]
* [[Chuk Chat Backend and API]]
* [[Chuk Chat Privacy and Security]]

[[Category:Chuk Chat]]
[[Category:Architecture]]