Eve library

Lakshmi — Comprehensive Personal Finance Intelligence Platform

Other

Revision 1

On this page

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#

text
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