Friends Till Bill

• 

  medium_receipt_indian_foods

• 

  hard_receipt_georgian_language

• 

  easy_receipt_english

QUICK NOTE

The demo has two versions: Terminal version — more accurate core logic (see README for setup) Streamlit version — cleaner UI for easier demo: Streamlit Demo link

Sample receipts (English, Indian, Georgian) are attached for testing. However, Georgian (fully non English is not fully developed yet). Use Streamlit for better UI, Terminal for the more accurate original workflow.

Inspiration

Splitting bills with friends is awkward, especially when receipts contain unclear, abbreviated, or foreign-language food names. This is even harder on group trips abroad, where items may be written in different alphabets or unfamiliar local names. I wanted to make receipt splitting faster, clearer, and less stressful.

What it does

Friends Till Bill is an AI-assisted receipt reader and bill splitter. Users upload a receipt photo, and Claude extracts the merchant, date, currency, items, prices, tax, and total. For foreign-language items, it keeps the original text, adds a Latin reading, and gives a short description so users can recognize the item.

Users then enter the people, tick who ate each item, and the app splits shared items equally. It calculates each person’s total, shows a clear breakdown, sends bunq payment requests by email, verifies requests, and lets users download the result as JSON.

How I built it

I built Friends Till Bill in Python using: Claude AI to interpret unclear receipt items Python logic to track item assignments and calculate splits bunq API to generate payment requests The flow is simple: upload receipt, add people, assign items, review totals, send requests.

Challenges I ran into

The biggest challenge was connecting AI output to real payments. Claude could help simplify unclear receipt item names and calculate who owes what, but I still had to convert that into the format the banking API expects. I also had to learn how the bunq API works from scratch. Since I had never worked with a banking API before, understanding authentication, accounts, and payment requests was one of the biggest challenges.

Accomplishments that I'm proud of

I built a working demo that turns a messy receipt into a clear split. It can read receipt images, handle unclear or foreign-language food names, help users assign items, calculate shared costs, and generate bunq payment requests.

I am proud that it solves a real everyday problem, especially for group dinners and trips abroad.

What I learned

Almost everything in this project was new to me. I learned how to work with external APIs, connect Claude’s output to application logic, and use a banking API to trigger payment requests. More broadly, I learned how to connect different tools into one working product under hackathon time pressure.

What's next for Friends Till Bill

Future features could include voice input, smarter assignment suggestions, pictorial hints for unfamiliar foods, and integration with payment apps like bunq to make shared payments faster and more seamless.

Built With

• bunq
• claude
• python