I built FriendVault, a local-first bill and receipt assistant for a friend who was overwhelmed by rent, utilities, subscriptions, and the pile of digital and paper receipts that always seemed to show up at the worst time.
This wasnโt just a โfinance appโ demo; it was a real problem for a real person. The pain point wasnโt only tracking totals; it was the mental load of remembering what was due, when it was due, and what had already been paid. Small missed bills create stress fast
FriendVault helps someone:
- upload a receipt or bill photo ๐ธ
- extract the vendor, date, and amount locally with OCR ๐
- detect grocery items from receipts ๐
- generate reminders for recurring expenses โฐ
- review monthly summaries ๐
- keep data on their own device instead of sharing it with a remote service ๐
The goal was simple: turn a messy, stressful workflow into something calmer, private, and genuinely useful.
Demo
App setup:
- install Tesseract
- create a virtual environment
- install requirements
- run:
streamlit run app/main.py
The app is designed to run entirely on a laptop, with local OCR and local storage. Itโs meant to work without internet access and without sending receipts to a third-party service.
Code
Repository: https://github.com/Anyaxx/friendvault-hacktober
How I Built It
I built FriendVault around open-source local tooling instead of relying on a hosted AI API.
Tech stack:
- Streamlit for the UI
- Tesseract OCR for local text extraction
- OpenCV for image preprocessing
- SQLite for local persistence
- Python for automation and reminder logic
The important part is that the appโs โAIโ is not a cloud black box. It runs locally on the machine, which means:
- no internet required ๐
- no need to send sensitive receipts to a vendor โ๏ธ
- no recurring API costs ๐ธ
- easier customization and experimentation ๐ง
That makes it a practical, privacy-first tool instead of just a flashy prototype.
Why Does Open Innovation Matter?
Open innovation matters for this project because the best part of it is that it stays under the userโs control.
A closed AI service would have required sending private household billing data to a remote platform. Thatโs a trust problem, especially for something personal like rent, utilities, and grocery receipts. With open-source tools, the app can run entirely on a laptop, work offline, and stay local-first.
That gave me several practical advantages:
- The app can run with no internet connection ๐
- Private data never has to leave the device ๐
- The OCR and extraction logic can be modified locally ๐งฉ
- The app remains cheap and flexible to iterate on ๐
This is exactly where open-source AI helps: it makes privacy-first, offline-first software not just possible, but practical.
Conclusion
FriendVault is a small project, but it solves a real everyday problem in a way that is useful, private, and practical. I built it for someone I care about because the best software is the kind that quietly makes life easier without adding more stress.
Thatโs where open-source AI really mattered: local OCR, offline-first workflows, and full control over personal data made this possible without sending sensitive receipts to a cloud service. Itโs a simple tool, but itโs a useful one, and thatโs what I hope to keep building: software that helps people, respects their privacy, and works without locking them into a closed system.


Top comments (0)