This is the backend service for the Financial Sentiment & Budget Analyzer application. It provides APIs for financial news analysis, stock predictions, and budget management.

• Financial news sentiment analysis using Gemini API
• Stock prediction based on market sentiment and risk tolerance
• Budget management and tracking
• Bill scheduling and shortfall detection
• Transaction tracking with credit/debit differentiation
• Purchase evaluation with AI-powered recommendations
• Custom financial advice based on personal financial context
• Bill payment risk assessment and prioritization

• Node.js
• Express.js
• MongoDB
• Google's Gemini API
• Winston (logging)

• Node.js (v14 or higher)
• MongoDB instance
• Gemini API key

1. Clone the repository
2. Install dependencies:

   npm install

3. Create a .env file in the root directory with the following variables:

   PORT=3000
   MONGODB_URI=your_mongodb_connection_string
   GEMINI_API_KEY=your_gemini_api_key
   NODE_ENV=development
   

Development mode:

npm run dev

Production mode:

npm start

Fetches recent financial news with sentiment analysis.

Provides stock predictions based on sentiment and risk tolerance.

Retrieves current budget details.

Updates budget information.

Lists all scheduled bills.

Retrieves user transactions with optional filtering by date, category, or type.

Adds a new transaction with automatic credit/debit classification.

Gets current balance based on all transactions.

Predicts if user will miss upcoming bill payments and provides risk analysis.

Analyzes if a potential purchase is a good financial decision.

Provides customized financial advice based on the user's specific situation and question.

For detailed API documentation and implementation details, see DEVELOPMENT.md.

1. Fork the repository
2. Create a feature branch
3. Commit your changes
4. Push to the branch
5. Create a Pull Request