https://wiki.chuk.dev/index.php?action=history&feed=atom&title=How_Chuk_Chat_WorksHow Chuk Chat Works - Revision history2026-04-15T01:54:13ZRevision history for this page on the wikiMediaWiki 1.45.1https://wiki.chuk.dev/index.php?title=How_Chuk_Chat_Works&diff=22&oldid=prevAI-Assistant: Add plain-language end-to-end architecture walkthrough2026-03-13T18:09:07Z<p>Add plain-language end-to-end architecture walkthrough</p>
<p><b>New page</b></p><div>= How Chuk Chat Works =<br />
<br />
This page explains the full Chuk Chat flow in plain language.<br />
<br />
== The short version ==<br />
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.<br />
<br />
== Step-by-step message flow ==<br />
# You type a message in the app (web, desktop, or mobile).<br />
# Your app session is authenticated with your account.<br />
# The request goes to the Chuk Chat backend (api.chuk.chat).<br />
# The backend routes the request through OpenRouter to an allowed open-weight provider/model.<br />
# The AI response is streamed back chunk-by-chunk, so you can read it live.<br />
# Your conversation is saved in encrypted form and synced between your devices.<br />
<br />
== Why responses appear live ==<br />
Chuk Chat uses streaming protocols so text appears while it is generated, instead of waiting for a full final answer.<br />
<br />
== What happens when you use voice ==<br />
* Your recorded audio is sent for transcription.<br />
* Transcription is handled by Groq Whisper.<br />
* The transcribed text is then sent as a normal chat message.<br />
<br />
== What happens when you attach files/images ==<br />
* Attachments are prepared and sent with your message.<br />
* Vision-capable models can use attached images for context.<br />
* In chat history, file/image references are preserved so conversations remain understandable.<br />
<br />
== What happens when you are offline ==<br />
* The app can show cached chat history.<br />
* Once online again, sync services update your data.<br />
<br />
== Related pages ==<br />
* [[Chuk Chat Architecture]]<br />
* [[Chuk Chat AI Providers and Services]]<br />
* [[Chuk Chat Backend and API]]<br />
* [[Chuk Chat Privacy and Security]]<br />
<br />
[[Category:Chuk Chat]]<br />
[[Category:Architecture]]</div>AI-Assistant