Self-hosted · Open Source · Privacy First

Take control of your
Israeli finances

Nudlers aggregates transactions from all your Israeli banks and credit cards into one dashboard. Track expenses, categorize spending, set budgets, and get AI-powered insights — all running on your own hardware.

See it in action

A clean, modern interface for managing all your Israeli financial accounts.

Everything you need

A complete personal finance toolkit designed for the Israeli banking ecosystem.

Automated Scraping

Fetches transactions from all major Israeli banks and credit card providers automatically. Set it and forget it with scheduled syncs.

Smart Categorization

Auto-categorize transactions with customizable rules. Create your own categories and let the system learn your spending patterns.

Budget Tracking

Set monthly budgets per category and track spending against them. Visual progress bars show exactly where you stand.

WhatsApp Reports

Get daily or weekly spending summaries delivered straight to your WhatsApp. Stay on top of your finances without opening the app.

AI Assistant

Ask questions about your spending in natural language. Powered by Google Gemini, get insights like "How much did I spend on groceries last month?"

MCP Integration

Model Context Protocol support lets AI tools like Claude interact with your financial data directly. The future of AI-powered finance.

Runs anywhere

Nudlers includes built-in resource optimization with two modes: normal for standard servers, and low for NAS devices, Raspberry Pi, and other minimal hardware. Your finances, your hardware, your choice.

Normal
2GB+ RAM servers
🖩
Low
NAS & Raspberry Pi

Standing on the shoulders of giants

Nudlers wouldn't exist without the incredible open-source community.

israeli-bank-scrapers

A huge thank you to israeli-bank-scrapers — the open-source library that makes it all possible. Thanks to their work, Nudlers supports most Israeli banks and credit card providers out of the box. If you find Nudlers useful, go give them a star too.

israeli-bank-scrapers on GitHub

Get up and running

Nudlers runs with Docker Compose. Here's everything you need.

1

Prerequisites

  • Docker & Docker Compose
  • Node.js 22+ (for local development)
  • PostgreSQL database
2

Clone the repository

git clone https://github.com/enudler/nudlers.git
cd nudlers
3

Configure environment

Create a .env file in the app/ directory:

# Database
NUDLERS_DB_USER=nudlers
NUDLERS_DB_HOST=localhost
NUDLERS_DB_NAME=nudlers
NUDLERS_DB_PASSWORD=your_secure_password
NUDLERS_DB_PORT=5432

# Vault: configured automatically via the UI on first run

# Resource Mode (normal | low)
RESOURCE_MODE=normal

# Optional: AI Assistant
GEMINI_API_KEY=your_gemini_api_key
4

Install and run

cd app
npm install
npm run dev

The app will be available at http://localhost:6969

Configuration

Fine-tune Nudlers to match your setup and preferences.

Resource Modes

Optimize performance based on your hardware:

Mode Target Hardware RAM
normal Standard servers, desktops 2GB+
low NAS, Raspberry Pi 512MB+

Billing Cycle

Israeli credit card billing cycles don't align with calendar months. Nudlers groups transactions by billing cycle (default: 10th of each month) so your spending view matches your actual statements.

Configurable via Settings → Billing Cycle Start Day.

WhatsApp Notifications

Get automated spending summaries delivered to WhatsApp:

  • Daily or weekly summary modes
  • Configurable send time
  • Category breakdown included

Scheduled Sync

Set up automatic transaction fetching on a schedule. Configure sync frequency, days to look back, and which accounts to include. Credentials are encrypted at rest with AES-256.

Built with

Next.js
TypeScript
PostgreSQL
Material UI
Puppeteer
Pino
Vitest
Docker

Frequently Asked Questions

Got questions? We've got answers.

Why would I need Nudlers?

If you have multiple bank accounts or multiple credit cards in your household, things get complicated fast. You want to coordinate spending across all of them, set budgets, and understand how your bank accounts are going to look at a specific date after all pending credit card charges settle.

Nudlers gives you a single, unified view of all your accounts — even when you have several credit cards and bank accounts spread across the family. One dashboard, full visibility.

How does the data get into the app?

Nudlers uses the open-source israeli-bank-scrapers library. You provide your bank and credit card credentials, and the library logs into your accounts to fetch your transactions automatically. The scraping runs locally on your own machine — no third-party servers involved.

Is my data safe? Who can see it?

Nobody can see your data. Nudlers is a fully self-hosted, local-only application. Your financial data never leaves your machine. There are no cloud servers, no analytics, no external data transmission. It's your data on your hardware — period.

How are my bank credentials stored?

Your credentials are stored encrypted in the database using AES-256-GCM encryption. Nudlers uses a two-layer encryption model: a random master key encrypts your credentials, and that master key is itself encrypted by a key derived from your vault passphrase. Even if your database is compromised, credentials remain secure because the master key is never stored in plain form — only its encrypted version is.

What does the vault passphrase protect, and is it stored anywhere?

The passphrase is never stored. Instead, it is used to derive a wrapping key (via scrypt, a memory-hard key derivation function) that encrypts the master key. The full chain looks like this:

Passphrase ──scrypt──▶ Wrapping Key
Wrapping Key ─AES-256-GCM─▶ Master Key (stored encrypted in DB)
Master Key ─AES-256-GCM─▶ Your credentials (stored encrypted in DB)

Once you unlock the vault, the master key is decrypted into server memory only — it is never written to disk. It is cleared automatically when the server restarts, requiring you to unlock again. If you forget your passphrase, the master key (and everything it protects) becomes permanently inaccessible.

Do I need to have an API key for Gemini?

No, the Gemini API key is optional. Gemini is used only for two features: chatting with AI about your own data in the app, and preparing the WhatsApp daily message. If you don't plan to use these features, you don't need an API key.

In the future, we will support other AI models. However, the recommended approach is to use Nudlers through MCP (Model Context Protocol), which allows AI tools like Claude to interact with your financial data directly.

Why am I getting Isracard scraping errors?

Isracard has rate-limiting mechanisms that detect automated access. The scraper can fetch your transactions list, but to retrieve the category for each transaction, it needs to query them one by one. When you scrape a large date range, there are many transactions, and the category lookups can trigger rate limiting.

Tip: When you start seeing errors, minimize the date range you're scraping. Shorter periods mean fewer transactions and fewer category requests, which keeps you under the rate limit.

Nudlers also maintains a prefilled card that caches business-to-category mappings, so matching happens faster and reduces the number of requests needed over time.

How are WhatsApp messages sent?

Nudlers uses the whatsapp-web.js package. Under the hood, it runs a headless browser that connects to WhatsApp Web and utilizes your session to send messages. You scan a QR code once to link it, and then reports are delivered automatically.

Who is behind Nudlers?

It's just me, Eli Nudler. I built Nudlers to scratch my own itch managing finances across multiple Israeli bank accounts and credit cards. It's open source and free to use.