DEV Community

Anoohya Jagarlamudi
Anoohya Jagarlamudi

Posted on

FriendVault: A Local-First Bill Buddy for the People You Love ๐Ÿ’™

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)