Lakshmi (Sanskrit: लक्ष्मी — Hindu goddess of wealth, fortune, prosperity, and abundance) is the comprehensive personal finance intelligence platform of the Oshun ecosystem. Lakshmi unifies every dimension of an individual's or household's financial life into a single AI-powered system — from account aggregation and budgeting through investment analytics, tax optimization, debt management, retirement planning, and estate administration.
Library Prefix#
@lakshmi/*
Domain Vision#
Lakshmi provides the most complete personal finance operating system ever built. Powered by autonomous AI financial agents, privacy-preserving analytics (homomorphic encryption, zero-knowledge proofs, federated learning), and open banking APIs (FDX, PSD2/PSD3, CDR), Lakshmi moves beyond passive dashboards to actively optimize every dollar through real-time tax-loss harvesting, intelligent debt payoff sequencing, credit score simulation, behavioral nudges, and multi-decade financial planning with Monte Carlo projections.
Key Capabilities#
- Open banking account aggregation across 20,000+ institutions (FDX, PSD2/PSD3, CDR compliant)
- ML-powered transaction categorization at 98%+ accuracy with merchant enrichment
- Zero-based, envelope, and cash-flow budgeting with 12-month forecasting
- Institutional-grade portfolio analytics (TWR, IRR, factor exposure, risk metrics, fund X-ray)
- Continuous tax optimization (tax-loss harvesting, Roth conversions, bracket management, asset location)
- AI-driven debt payoff optimization (avalanche, snowball, hybrid) with refinancing detection
- Credit score monitoring, simulation, and active optimization across three bureaus
- Monte Carlo retirement projections with Social Security optimization and withdrawal sequencing
- Insurance portfolio analysis with coverage gap detection and premium optimization
- Estate planning with digital asset inventory, beneficiary tracking, and document vault
- Real estate wealth management with automated valuation, rental analysis, and 1031 exchange planning
- Multi-chain crypto and DeFi position tracking with tax lot management
- Equity compensation optimization (RSU, ISO, NSO, ESPP) with AMT modeling
- Autonomous AI financial agents for scenario modeling, bill negotiation, and proactive recommendations
- Behavioral finance engine with nudges, peer benchmarking, and lifestyle inflation detection
- Household multi-user collaboration with role-based permissions and advisor portal
- Self-employment finance with entity structure optimization and quarterly tax automation
- Zero-knowledge architecture with homomorphic encryption analytics and federated learning
Libraries#
| Package | Description |
|---|---|
@lakshmi/core |
Shared types, Zod schemas, financial primitives, calculation utilities |
@lakshmi/accounts |
Open banking account aggregation, institution connectivity, balance sync |
@lakshmi/transactions |
Transaction ingestion, ML categorization, merchant enrichment, search |
@lakshmi/budgeting |
Zero-based/envelope budgeting, cash-flow forecasting, spending analytics |
@lakshmi/investments |
Portfolio analytics, TWR/IRR, factor exposure, fund X-ray, rebalancing |
@lakshmi/tax |
Tax-loss harvesting, Roth conversion, bracket optimization, asset location |
@lakshmi/debt |
Avalanche/snowball optimization, refinancing detection, payoff projections |
@lakshmi/credit |
Credit score monitoring, simulation, bureau disputes, optimization engine |
@lakshmi/retirement |
Monte Carlo projections, Social Security optimization, RMD, decumulation |
@lakshmi/insurance |
Policy analysis, coverage gap detection, premium optimization, claims |
@lakshmi/estate |
Digital asset inventory, beneficiary tracking, document vault, trust planning |
@lakshmi/real-estate |
AVM, rental analysis, 1031 exchange, HELOC optimization, mortgage tracking |
@lakshmi/crypto |
Multi-chain tracking, DeFi positions, tax lot management, staking rewards |
@lakshmi/income |
Equity compensation (RSU/ISO/NSO/ESPP), AMT modeling, income engineering |
@lakshmi/goals |
Financial goal planning, milestone tracking, scenario modeling |
@lakshmi/ai-engine |
Autonomous AI financial agents, NLP query interface, recommendation engine |
@lakshmi/behavioral |
Behavioral finance engine, nudges, peer benchmarking, lifestyle inflation |
@lakshmi/household |
Multi-user collaboration, RBAC, advisor portal, joint planning |
@lakshmi/business |
Self-employment finance, entity optimization, quarterly tax automation |
@lakshmi/security |
Homomorphic encryption, ZK proofs, federated learning, key management |
@lakshmi/reporting |
Financial reports, tax documents, net worth statements, advisor exports |
@lakshmi/integrations |
Plaid/Yodlee/MX/Finicity/Tink provider abstraction, FDX/PSD2/CDR adapters |
@lakshmi/alerts |
Real-time alerting, budget breach, anomaly detection, milestone notifications |
Technology Stack#
- TypeScript — orchestration, business logic, API layers, financial engines
- Node.js — runtime with native crypto modules for key derivation
- PostgreSQL + pgvector — embedding-based financial similarity search
- TimescaleDB — time-series: balance snapshots, price history, net worth
- Redis — caching, real-time balance tracking, rate limiting, sessions
- Kafka — event streaming (transaction events, market data, alert triggers)
- BullMQ — priority background job processing (sync, categorization, AI)
- Hono — API gateway with JWT auth, RBAC, request validation middleware
- Drizzle ORM — type-safe SQL migrations and query builder
- Zod — runtime validation for all domain types and API contracts
- OpenAI / Anthropic / Google — AI financial agents and NLP query engine
- Plaid / Yodlee / MX / Finicity / Tink — account aggregation providers
- TFHE / OpenFHE — homomorphic encryption for privacy-preserving analytics
- MinIO S3 — document storage (receipts, tax documents, estate files)
- WebSockets — real-time dashboard updates, alerts, price feeds
Architecture Layers#
app (apps/lakshmi/*)
└── feature (@lakshmi/ai-engine, @lakshmi/goals, @lakshmi/household)
└── domain (@lakshmi/accounts, @lakshmi/investments, @lakshmi/tax, ...)
└── core (@lakshmi/core, @lakshmi/security)
Module boundary rule: core → domain → feature → app (unidirectional).
Regulatory & Compliance Context#
- FDX (Financial Data Exchange) — open banking standard for US/Canada
- PSD2 / PSD3 (EU Payment Services Directive) — open banking in Europe
- CDR (Consumer Data Right) — open banking in Australia
- CFPB 1033 — US consumer financial data access rule
- SOC 2 Type II — security and availability controls
- GDPR / CCPA / PIPEDA — data privacy regulations
- IRS / FINRA / SEC — tax and investment regulatory compliance
- FCRA (Fair Credit Reporting Act) — credit data handling requirements
- GLBA (Gramm-Leach-Bliley Act) — financial data privacy protection