A dry-humored, over-engineered POS (Piece Of Shit) inventory system for software engineers who scan too many snacks. Uses a hardware barcode scanner (via Serial) or a phone to manage products with real-time UI updates.

🚀 Features

Real-time Inventory: Instant UI updates using WebSockets (Socket.IO).
Auto-Discovery: Fetches product names and images from Open Food Facts API.
Image Caching: Locally stores product images to prevent IP bans and broken links.
Chilean Formatting: Native CLP currency support ($1.234).
Security: Session-based authentication (Flask-Login) with hashed passwords.
Hardware Bridge: A dedicated script to bridge Serial (COM) scanners to the web server.

🛠️ Tech Stack

Backend: Python 3.x, Flask, SQLite
Frontend: Vanilla JS, Socket.IO, HTML5/CSS3
Communication: HTTP REST + WebSockets

📦 Installation

Clean your messy environment:

pip install Flask Flask-Login Flask-SocketIO pyserial requests eventlet

Releases 3

gui scanner v3 + assets Latest

2026-03-17 17:24:14 -03:00

Languages

HTML 61.6%

Python 19.8%

Go 6.4%

C++ 6%

CSS 2.6%

Other 3.6%