git404hub

what is qr-ai-chat fr?

agarwalpranav0711/qr-ai-chat — explained in plain English

Analysis updated 2026-05-18

11JavaScriptAudience · vibe coderComplexity · 3/5LicenseSetup · moderate

tl;dr

An entire AI chat interface compressed to fit inside one QR code, so scanning it runs the chat live with no separate webpage.

vibe map

mindmap
  root((QR AI Chat))
    What it does
      Packs chat UI into QR code
      Runs interface on scan
      Talks to real AI backend
    Tech stack
      Vanilla JavaScript
      Cloudflare Worker
      Gzip and base64
    Use cases
      Digital business card
      Personal AI chat demo
      Portfolio conversation piece
    Audience
      Vibe coders
      Developers
    Notes
      Hard 2953 byte limit
      MIT licensed

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

what do people make with this?

VIBE 1

Create a personal digital business card that opens an AI chat about yourself when someone scans it.

VIBE 2

Build a portfolio conversation piece that lets visitors ask an AI questions about your projects.

VIBE 3

Learn how to compress and embed an entire web app inside a URL's hash fragment.

VIBE 4

Deploy a lightweight, serverless AI chat demo without hosting a traditional backend.

what's the stack?

JavaScriptHTMLCSSCloudflare Workers

how it stacks up fr

agarwalpranav0711/qr-ai-chat100/tab-organizeraddyosmani/devtools-snippets
Stars111111
LanguageJavaScriptJavaScriptJavaScript
Last pushed2021-03-012013-09-22
MaintenanceDormantDormant
Setup difficultymoderateeasyeasy
Complexity3/51/51/5
Audiencevibe codergeneraldeveloper

Figures from each repo's GitHub metadata at analysis time.

how do i run it?

Difficulty · moderate time til it works · 30min

Requires deploying a Cloudflare Worker and providing your own AI API key.

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

in plain english

This project fits an entire working AI chat interface inside a single QR code. Most QR codes that claim to offer an AI chat just contain a link to a normal website, but this one is different: the whole interface, meaning the page's HTML, CSS, and JavaScript, along with some personal context about the person it represents, is shrunk down and stored directly in the QR code itself. When someone scans it, their phone's browser decompresses that data on the spot and runs the chat interface live, without loading anything from a server first. To make this fit, the code goes through a compression pipeline. First the interface's code is minified, meaning whitespace and comments are stripped and variable names are shortened. Then it is compressed with gzip, and finally encoded in base64 so it can safely travel inside a web address. The result has to squeeze under about 2,953 bytes, which is the maximum amount of data a QR code can hold at its largest standard size and lowest error correction level. The compressed data lives in the part of the web address after the hash symbol, a part browsers never send to a server, so the page that reads and decompresses it can be a simple static file. Once the interface loads, sending a chat message still requires a real network call to an actual AI model, since AI models themselves are far too large to fit in a QR code. That call goes through a Cloudflare Worker, a small serverless function that keeps the AI provider's API key hidden from anyone inspecting the code, limits how many messages each visitor or the whole system can send, checks that incoming messages are valid, and does not log conversations. The author is upfront that scanning such a dense QR code can be unreliable with some phone cameras, and suggests using a dedicated scanning app or an online QR reader if the default camera fails. The project is meant to be forked: someone can swap in their own name and background details, deploy their own Cloudflare Worker with their own AI API key, run a build script to generate their own compressed link and QR code, and host the resulting page anywhere that serves static files. It is released under the MIT license.

prompts (copy fr)

prompt 1
Help me fork this project and swap in my own identity details in widget/index.html.
prompt 2
Walk me through deploying the Cloudflare Worker in the worker folder with my own AI API key.
prompt 3
Explain how the compression pipeline in this project shrinks the chat interface to fit a QR code.
prompt 4
Help me run widget/build.js to generate my own compressed payload and check it against the byte budget.

Frequently asked questions

what is qr-ai-chat fr?

An entire AI chat interface compressed to fit inside one QR code, so scanning it runs the chat live with no separate webpage.

What language is qr-ai-chat written in?

Mainly JavaScript. The stack also includes JavaScript, HTML, CSS.

What license does qr-ai-chat use?

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is qr-ai-chat to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is qr-ai-chat for?

Mainly vibe coder.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.