Turn device manuals into QR-code AI assistants for hotels, rentals, offices, and real-world equipment.
A guest should not read a 100-page PDF to use an air conditioner. A new employee should not call a manager to understand a printer. A customer should not wait for support to decode a blinking error light.
GuideAI lets you upload a manual, attach it to a device, generate a QR code, and give people instant answers exactly where the problem happens.
Live demo: guide-ai-gold.vercel.app
Most manuals are written for storage, not for use.
They sit in drawers, inboxes, PDF folders, hotel binders, and forgotten support pages. But people need help while standing in front of the device.
GuideAI turns those manuals into scannable AI helpers.
Upload manual -> Create device -> Generate QR code -> Scan and ask
Instead of searching through pages, users can ask:
- "How do I reset this device?"
- "What does this error code mean?"
- "How do I connect it to Wi-Fi?"
- "How do I clean it safely?"
- "Why is this light blinking?"
- "How do I use this machine for the first time?"
GuideAI is designed for environments where the same questions repeat every day.
Place QR codes near devices in rooms:
- air conditioners
- coffee machines
- safes
- TVs
- washing machines
- smart locks
- heating panels
Guests scan the QR code and get device-specific help without messaging reception.
Attach QR assistants to:
- printers
- scanners
- meeting room equipment
- access systems
- kitchen devices
- internal tools
Employees get answers without interrupting someone else.
Use GuideAI for equipment that customers or staff need to operate correctly:
- rental devices
- workshop machines
- gym equipment
- self-service stations
- onboarding materials
- technical documentation
Add a manual, guide, instruction sheet, or technical document.
Give the manual a real-world identity:
Room 204 - Air Conditioner
Office Printer - 2nd Floor
Apartment A3 - Washing Machine
Workshop - Laser Cutter
GuideAI creates a QR code that can be printed, placed near the device, or shared digitally.
The user scans the QR code and asks natural-language questions based on the uploaded manual.
PDF manuals are technically available.
That does not mean they are usable.
GuideAI is built around a simple belief:
The best manual is the one that answers the exact question at the exact place where the user needs it.
No searching. No scrolling through 100 pages. No generic chatbot guessing from the internet. No "please contact support" for every basic question.
Just the right answer, from the right manual, attached to the right device.
- PDF manual upload
- AI-powered manual chat
- Device management
- QR code generation
- Persistent device records
- User dashboard
- Email authentication
- Google OAuth
- English and Polish interface
- Dark mode
- Hosted live on Vercel
- Supabase-backed storage and authentication
GuideAI is built with a modern web stack:
| Layer | Technology |
|---|---|
| Frontend | React 19, Vite |
| Styling | Tailwind CSS |
| Auth & Database | Supabase |
| AI | Groq API / Llama 3.1 |
| Hosting | Vercel |
| Language support | EN / PL |
| QR flow | Device-linked QR generation |
Add screenshots or GIFs here to make the repository instantly understandable.
Recommended visuals:
- Landing page
- PDF upload flow
- Device dashboard
- Generated QR code
- AI chat answering a manual-specific question
A small hotel has 20 rooms.
Each room has:
- a TV
- an air conditioner
- a safe
- a coffee machine
- a heating controller
Instead of leaving paper instructions or answering the same messages every week, the hotel creates QR assistants for each device.
A guest scans the code next to the air conditioner and asks:
How do I switch this to cooling mode?
GuideAI answers from the actual manual.
The hotel gets fewer repeated questions. The guest gets help instantly. The staff stays focused on real problems.
GuideAI is in active development.
Current version:
v1.1.8
Recent work includes:
- Supabase authentication
- Google OAuth integration
- user profiles
- dashboard foundation
- device management
- QR generation flow
- session persistence
- improved landing page
- FAQ section
- footer and UI polish
Next focus areas:
- stronger QR persistence
- improved database structure
- better PDF processing pipeline
- production-ready device sharing
- cleaner onboarding for business users
- demo flows for hotels, rentals, and offices
git clone https://github.com/HuckleR2003/guide-ai.git
cd guide-ainpm installCreate a .env file:
VITE_SUPABASE_URL=your-supabase-url
VITE_SUPABASE_ANON_KEY=your-supabase-anon-keyDepending on your current AI provider setup, also configure the required API key for the AI chat backend.
npm run devThe app should be available at:
http://localhost:5173
GuideAI uses Supabase for authentication, user data, and device persistence.
See:
SUPABASE_SETUP.md
for database schema and configuration notes.
- Business-ready demo mode
- Public device assistant pages
- Shareable QR assistant links
- Better onboarding for hotels and rentals
- Device groups / locations
- Organization accounts
- Usage analytics
- Custom branding for businesses
- Improved PDF parsing
- Better source-grounded answers
- Manual section references
- Multi-document device knowledge
- Safer fallback when the manual does not contain an answer
- More reliable long-manual handling
- Production database cleanup
- Better error handling
- Rate limit protection
- Billing-ready architecture
- Exportable QR sheets
- Admin tools for managing devices
GuideAI is not trying to replace support teams.
It is trying to remove the questions that should never have reached support in the first place.
If the answer is already buried inside a manual, GuideAI should make it available in seconds.
Built by Marcin Firmuga / HCK_Labs.
GuideAI is part of the HCK_Labs build-in-public journey: practical tools, real users, and software that solves annoying everyday problems.
MIT License.
Copyright © 2026 HCK_Labs.