Storage Boxx is an open-source PHP Inventory Management System. With a built-in webcam QR scanner, NFC scanner, passwordless login, and an optional experimental AI assistant.
TABLE OF CONTENTS
DOWNLOAD & INSTALLATION
First, here are the download links for the impatient folks who don’t want to read through everything.
SYSTEM REQUIREMENTS
- LAMP/WAMP/MAMP/XAMPP
- Apache Mod Rewrite
- PHP MYSQL PDO Extension
- PHP OpenSSL Extension
- At least PHP 8.0
- Take note – Webcam, NFC and Passwordless (Web Authentication) support depends on the user’s device and browser.
LICENSE & DOWNLOAD
GitHub | GitHub – AI Assistant | SourceForge
Storage Boxx is released under the MIT License. You are free to use it for personal and commercial projects, and modify it as you see fit. On the condition that the software is provided “as-is”. There are no warranties provided and “no strings attached”. Code Boxx and the authors are not liable for any claims, damages, or liabilities.
INSTALLATION
- Download from GitHub/Sourceforge into your HTTP folder.
- Access
http://your-site.com
in the browser and walk through the installer.
SORRY FOR THE ADS...
But someone has to pay the bills, and sponsors are paying for it. I insist on not turning Code Boxx into a "paid scripts" business, and I don't "block people with Adblock". Every little bit of support helps.
Buy Me A Coffee Code Boxx eBooks
HOW TO USE
So far so good? Let us now go through a quick crash course on how to use Storage Boxx.
QUICKSTART GUIDE
EQUIPMENT RECOMMENDATIONS
- Webcam – If you are using a desktop without a webcam, a simple one only costs about $20~30.
- USB QR Code scanner – Alternatively, a “dedicated barcode scanner” will cost about $30~40 bucks.
- NFC tags – 10 pieces of Ntag213 only cost 2-3 bucks. Buy them in bulk, and one piece will only cost a few cents.
- Fingerprint sensors – These are kind of expensive… But I got lucky with a $25 “Made in China” that works just fine.
- Label printer – Print your QR codes. There are Bluetooth ones that can pair with smartphones.
FOR THE DEVELOPERS
This section is for the developers, with a couple of development notes for customization.
FAQ
“AJAX error”? Migrating to another domain? NFC “not working”? Check out the FAQ section.
BUILT ON CORE BOXX
- At least go through the very short tutorial.
- Thereafter, go into the deeper concepts:
- Storage Boxx has also adopted the following modules:
AI ASSISTANT
So, you may have noticed that the AI Assistant is “missing” or “not working” out of the box. It’s a long story.
REQUIREMENTS
- Python – Yes, Python. Not PHP. Version 3.9 to 3.10 seems to work fine at the time of writing.
- Microsoft C++ Build Tools
- CMake
- Nvidia CUDA Toolkit – If you have an Nvidia graphics card.
- An Nvidia graphics card with at least 8GB VRAM is highly recommended. You can TRY to run on CPU, but it is painfully slow and practically useless.
INSTALLATION
- Copy/unzip this module into your existing Storage Boxx folder.
- I have tried multiple AI models, codellama-7b-instruct.Q5_K_M.gguf is the only one that produced decent(ish) results – Download that into
chatbot/models
or choose a better/larger/smarter model on your own. - Edit
chatbot/a_settings.py
, change themodel_name
to your own. - BE WARNED, GIGABYTES WORTH OF DOWNLOAD! –
0-setup.bat
(Windows)0-setup.sh
(Linux).
LAUNCH
- Run
1-bot.bat
(Windows)1-bot.sh
(Linux/Mac), this will deploy the bot athttp://your-site.com:8008
. - Just access
http://your-site.com/ai
(must be signed in).
Hi, It’s working fine but i’m facing a little problem while tracking the inventory. Whenever i update the current stock it shows Date and time. The problem I’m facing is that , I’m living in India and the tracking time doesn’t match with IST [ Indian Standard Time] ie.. GMT +5:30 hours. Is their any way of getting it correct, yes then it would be really helpful for me.
Thanks.
https://www.php.net/manual/en/function.date-default-timezone-set.php
https://phoenixnap.com/kb/change-mysql-time-zone
Hi, thanks for the reply, it worked, but i also found 1 more problem is that when we log out it shows – ” AJAX ERROR Failed to parse JSON data.” on first time and it will logged out on second time.
Thanks for reporting! But “AJAX error” is too generic – Open the developer’s console and see what the server is complaining about. Good luck.
I’m a small printshop owner from Rotterdam, the Netherlands
and I would like to keep track of my paper and office supplies.
Recently I discovered Storage Boxx and it really looks simple to use,
and efficient for working with by scanning QR-codes.
Is it possible to add extra fields for Items, like ‘price’ or ‘product-image’.
I also tried making by own stock management system in PHP,
but it’s not efficient to work with.
Of course. See “Developing Storage Boxx” above.
Hi there,
I have checked and debugged as best i can but i am not seeing what the problem is.
I have also made sure that PHP 7.4 is installed. I am getting the following error when installing:
Fatal error: Uncaught Error: Call to undefined function apache_get_version() in /home/ccmuhahx/public_html/ua/lib/CORE-install.php:72 Stack trace: #0 /home/ccmuhahx/public_html/ua/index.php(2): require() #1 {main} thrown in /home/ccmuhahx/public_html/ua/lib/CORE-install.php on line 72
any assistance would be greatly appreciated
Garth
undefined function apache_get_version() > PHP is not installed as a module of Apache
Installer updated. Nothing is wrong if you are running Apache. It’s just running in another manner. Follow up with an “apache cgi vs module” search on the Internet if you wish to learn more.
Thank you, however the new installer is throwing the following error:
Fatal error: Uncaught Error: Call to undefined function str_contains() in E:\Software\wamp\www\php\Storage-Boxx-2022-05-05-a\lib\CORE-install.php on line 72
Error: Call to undefined function str_contains() in E:\Software\wamp\www\php\Storage-Boxx-2022-05-05-a\lib\CORE-install.php on line 72
Regards
Garth
Of course.
str_contains()
only exists in PHP 8+.1) Updated installer to use
strpos
instead.2) Required PHP version has been updated to 8.0. Reason – PHP 7.4 will come to its end of life in Nov 2022. A gentle reminder to update your server soon. https://www.php.net/supported-versions.php
3) If you still want to continue with 7.4, edit lib/CORE-install.php C1 – change I_MIN_PHP back to 7.4.0
Hi there, works perfectly. Only problem is, it does not scan any barcode or QR code.
Error always says: Invalid SKU
Any ideas?
Thanks
Garth
Please do your own basic troubleshooting first (has SKU been registered, open developer’s console), and provide more details.
https://code-boxx.com/faq/#help “Unclear question and request”
https://code-boxx.com/faq/#notwork
Hi W.S. TOH,
I succeeded.
Thank you for your patience and please allow me to continue learning with your help.
projects seem to me the best way to really learn!
all good,