Skip to content

Talk to your money

Ray is an AI financial advisor that connects to your bank, understands your full picture, and gives real advice—all local on your machine.

1,976 installs this month

Loved by users

Open Source

MIT Licensed · Fully Auditable

ray — zsh

~ $ ray status

tuesday, apr 14

net worth $255,870 +$133

gold card -$1,830 · chase savings $12,500 · total checking $4,200 · 401(k) $67,000 · individual $34,000

spending $3,608 this month · $1,728 more than last month

shopping +$850 · food & drink +$396 · services +$145 · personal care +$130

████████████░░░░ shopping 75%

███████░░░░░░░░░ food & drink 44%

score 76/100 · 3d no dining

ray · synced 1h ago · ctrl+c to exit

What makes Ray different

Tell Ray once. It remembers everything.

Ray keeps a persistent profile of your life — family, income, goals, strategy, and key decisions. When your situation changes, Ray updates it automatically. The advice you get on day 30 is nothing like day one, because Ray knows what happened on days 1 through 29.

Family situation

Married, two kids, one income

Career stage

Just started a new job at $95k

Financial goals

Pay off student loans by 2027

Risk tolerance

Conservative — no crypto

Life events

Baby due in March, buying a house

Past decisions

We cut DoorDash last month

generic AI vs ray

❯ how should I deal with my debt?

chatgpt

You should aim to save 15–20% of your income. Consider building a 3–6 month emergency fund, then focus on paying off high-interest debt.

ray

You've got $34,200 in debt across two cards and a car loan. At $95k with two kids and a baby coming in March, I'd pause the Japan fund and throw that $440/mo at the Chase card — it's at 24.9%. That clears it by September and frees up $340/mo before the baby arrives.

❯ can I take this trip to Tahoe?

chatgpt

A weekend trip can cost $500–$2,000 depending on the destination. Make sure it fits your budget and doesn't derail your savings goals.

ray

Tahoe would run about $1,200 with the Airbnb and gas. You can swing it, but it'll push your 401k contribution below the $23,000 max this year — you'd need to bump it back to 18% in May to catch up. Want me to map that out?

❯ is my rent too high?

chatgpt

It depends on your income, expenses, and financial goals. Generally, you should avoid spending more than 30% of income on housing.

ray

Your rent is $2,400 against $6,100 take-home — that's 39%, which is high. But you told me last week you're planning to move in with your partner in June. Once you split rent, housing drops to 22% and frees up $900/mo for the student loan blitz.

You’ve tried
everything else.

The Apps

Dashboards show you what happened.

Monarch, Copilot, YNAB — they sort your transactions into pie charts and send you notifications. They're good at showing you what you spent. They never tell you what to do about it. And when your subscription expires, so does your data.

The Spreadsheets

Powerful, but you still do all the work.

You built the perfect spreadsheet once. Formulas, projections, a debt payoff timeline. Even with Tiller syncing your data, you're still the one analyzing it, updating formulas, and deciding what it means. The spreadsheet never tells you what to do next.

Then there’s Ray

The advisor you’d hire if they weren’t $200/hour.

Ray remembers your goals, your family, your strategy, and every decision you’ve made together. When you ask “can I afford this?” it doesn’t give generic advice — it factors in your real situation, connects to your bank, queries your actual data, and gives you a real answer. Every conversation builds on the last.

How it works

01

Install in seconds

One npm command. No accounts, no sign-ups, no app store.

$npm install -g ray-finance
02

Connect your bank

Securely link your accounts through Plaid. Bank-level encryption.

$ray link
03

Ask anything

Get instant, AI-powered answers about your spending, savings goals, subscriptions, and financial health.

$Am I on track to save $10k?

What Ray can do

Not a dashboard. Not a chatbot. A financial brain that actually knows your situation.

Ray has 30+ tools that query your real financial data. It looks things up, runs calculations, and takes action.

"Can I afford to take this trip?"

Ray projects your balance forward based on actual income and spending patterns. See the impact before you commit.

"How's my score today?"

A daily 0-100 behavior score with streaks and unlockable achievements. No restaurants for a week? That's Kitchen Hero. Five zero-spend days? Monk Mode. It turns financial discipline into a game you actually want to play.

"What did we decide last time?"

Ray remembers your goals, preferences, life events, and past decisions. Every conversation builds on the last one.

"What's my net worth right now?"

Ray pulls balances across every linked account — checking, savings, credit cards, loans — and gives you one number. Updated every time you ask.

"Did anything unusual hit my account this week?"

Ray scans recent transactions for anomalies — unexpected charges, duplicate payments, amounts that don't match your patterns. Like a financial advisor who actually checks.

"Can you audit to make sure my tenants have paid for the past 12 months?"

Ray searches your real transaction history, flags gaps, and gives you a straight answer. Landlord, freelancer, whatever — if the data is in your bank, Ray can check it.

Privacy

Your financial data is never stored outside your machine.

Ray runs entirely on your computer. There’s no cloud, no account, no server storing your data. Your financial history lives in an encrypted database on your hard drive, and your name is scrubbed before anything reaches the AI.

Raw financial data

Sarah Chen earns $85k at Acme Corp.

James manages the household budget.

Checking balance: $4,802

Visa balance: -$1,200 @ 22.99% APR

PII in local databaseWhat the AI receives

Encrypted at rest

Your data is encrypted on disk with the same standard used by banks. No one else can read it.

view source

No cloud storage

Everything stays in ~/.ray on your machine. No servers or security breaches to worry about.

Fully auditable

Every AI tool call is logged locally. You can see exactly what data was accessed and when.

view source

Two outbound calls

Plaid for bank sync, your AI provider for chat (PII-masked). That's it. No telemetry. No analytics.

view source

Integrations

Works with your bank, brokerage, and lender.

Ray connects to 12,000+ financial institutions through Plaid — from major banks to local credit unions.

Chase
Bank of America
Wells Fargo
Capital One
American Express
Fidelity
Charles Schwab
Robinhood
Vanguard
SoFi
Ally
PayPal
Venmo
Discover

And 12,000+ more institutions supported via Plaid

Pricing

Free forever. Or skip the setup.

Two ways to run Ray. Both keep your data local.

full control

Bring Your Own Keys

Free and open source forever

$0/forever

  • Open source, MIT licensed
  • Your own AI key (Anthropic, OpenAI, Ollama, etc.)
  • Your own Plaid credentials
  • Full model selection
  • All features included
View source on GitHub
Steps to self-host~2 weeks

Get an AI API key (Anthropic, OpenAI, or run Ollama locally)

~5 min

Create Plaid developer account

~5 min

Apply for Plaid production access

1-2 weeks

Run ray setup, paste keys

~5 min

Run ray link to connect bank

~2 min

~20 min of work + 1-2 week wait for Plaid approval

most popular

Ray Pro

Just install and go

$10/month

  • AI and bank connection included
  • Connect your accounts in seconds
  • Your data stays on your machine
  • All features, no limits
  • Cancel anytime
Steps to sign up~5 min

Run ray setup to get your key

~2 min

Run ray link to connect bank

~1 min

Total: ~3 minutes

FAQ

Common questions about Ray

What does Ray do?

Ray is an AI financial advisor that learns your full situation — your family, income, goals, strategy, and key decisions — and keeps a persistent profile that evolves over time. It connects to your bank via Plaid and answers questions like "can I afford this trip?" and "should I pay off debt or invest?" using your actual financial data. Instead of generic advice, Ray gives answers grounded in your specific context. It gets smarter the more you use it.

How does Ray keep my financial data private?

Ray runs entirely on your computer. Your financial data is stored in an encrypted SQLite database on your machine — there's no cloud account, no server, and no company storing your bank data. When Ray uses AI, it strips personally identifiable information before sending anything to the AI model. It's open source (MIT licensed) so you can verify this yourself.

How is Ray different from Monarch, Copilot, or YNAB?

Those apps sort your transactions into categories and show you dashboards. Ray takes a different approach: it's a conversational AI advisor that answers financial questions using your real data. Ask "how many months of runway do I have?" and Ray queries your actual bank data, runs the math, and gives you a direct answer. Ray also keeps all data local on your machine instead of on cloud servers, and can be self-hosted for free — because a tool that helps you manage your money shouldn't be another expense you have to budget for.

What can I ask Ray?

Anything about your finances. Example questions: "Can I afford to take this trip?", "Am I on track to save $10k by December?", "What's my monthly burn rate?", "Did anything unusual hit my account this week?", and "How much should I set aside for quarterly taxes?" Ray has 30+ tools that query your real financial data to give accurate answers. See more example prompts →

How much does Ray cost?

Ray has two plans. The free plan is fully open source (MIT licensed) — you install it with npm, bring your own AI provider (Anthropic, OpenAI, Ollama, or any OpenAI-compatible endpoint) and your own Plaid credentials for bank access. You pay your provider directly for AI usage, which is typically $1–3/month. The tradeoff is setup: Plaid production access requires a business entity, isn't guaranteed, and takes 1–2 weeks if approved. Ray Pro is $10/month and includes everything — AI and bank connectivity are built in, so you just install and connect your accounts in minutes. Both plans are the same app with the same features, and both keep all your financial data local on your machine. The only difference is whether you manage your own API keys or let Ray handle it.

Which banks does Ray work with?

Ray connects to 12,000+ financial institutions through Plaid — including Chase, Bank of America, Wells Fargo, Capital One, American Express, Fidelity, Schwab, Robinhood, Vanguard, SoFi, Ally, and thousands more. If your bank works with Plaid, it works with Ray.

Feel in control of your money again.

Ray is free, open source, and takes five minutes to set up. Your data never leaves your machine.

View on GitHubCompare plans

“I tried every finance app, built every spreadsheet, and talked to a financial advisor who charged $200/hr to tell me things I already knew. Nothing actually helped me make better decisions with my own money. So I built the thing I wanted — an advisor that knows my real numbers, runs locally, and is honest enough to open‑source.”

— Clark Dinnison, creator of Ray