Equilibrium Agent

Financial Concierge

Equilibrium Agent is an intelligent financial assistant designed to help balancing meaningful expenses with personal financial stability.

🌟 Key Features

• Multi-Agent Intelligence:
  • Solvency Strategist: Analyzes your finances against ONS data benchmarks to determine risk.
  • Corridor Optimizer: Monitors GBP/NGN FX rates to suggest the best time to send money.
  • Cultural Diplomat: Crafts empathetic, culturally nuanced negotiation scripts to help you set boundaries.
• Real-Time Goals Tracking: Visualize the impact of every remittance request on your long-term savings goals (e.g., "House Deposit").
• Smart Dashboard: Real-time websocket updates, risk scoring, and interactive agent timelines.

🏗️ Architecture (Monorepo)

• Frontend: Next.js, Tailwind CSS, Glassmorphism UI, Recharts.
• Backend: Python, FastAPI, LangGraph (Agentic Workflow), WebSockets.
• Integrations:
  • Google Gemini 1.5 Flash: Cognitive reasoning and drafting.
  • ONS Data: UK financial profiling benchmarks (cached).
  • Flutterwave v4: Remittance payout simulation (OAuth2 + Direct Transfers).
  • Opik: Observability and tracing.

🚀 Getting Started

Prerequisites

• Node.js (v18+)
• Python (v3.11+)
• uv (Python package manager)

1. Setup Backend

cd backend
cp .env.example .env  # (Or create .env with required keys: GEMINI_API_KEY, FLW_*, OPIK_*)
uv sync
uv run uvicorn app.main:app --reload

2. Setup Frontend

cd frontend
npm install
npm run dev

3. Usage

Navigate to http://localhost:3000/dashboard to access the Equilibrium dashboard.

🧪 Testing

• Backend E2E: cd backend && uv run test_e2e.py
• ONS Verification: cd backend && uv run test_ons.py

🛡️ License

MIT