Financial News AI Analysis Notification Service (MarketPulse) addresses the need for timely, actionable insights from financial news. It targets individuals interested in financial markets who require automated analysis and alerts. The service leverages Google Gemini AI to process news, extract key investment indicators, and deliver personalized notifications, enhancing market awareness and decision-making.

How It Works

MarketPulse operates by fetching the latest financial news through the Finnhub API. This news is then processed by Google Gemini AI, which performs intelligent analysis to identify market impact, investment advice, a confidence index, and source reliability, presented as percentages. The analyzed results are formatted and pushed to user devices via the Bark and PushPlus notification services, ensuring real-time delivery of synthesized financial intelligence.

Quick Start & Requirements

• Primary install/run command:
  • Clone repository: git clone https://github.com/T1mn/MarketPulse.git
  • Navigate: cd MarketPulse
  • Install dependencies (using uv): uv venv, source .venv/bin/activate (or Windows equivalent), uv pip install -r requirements.txt, uv pip install -e .
  • Run (debug): python -m MarketPulse.main
  • Run (daemon): python -m MarketPulse.daemon_manager start
• Non-default prerequisites:
  • Python 3.8+ (3.10+ recommended)
  • uv (recommended for environment management)
  • API Keys: FINNHUB_API_KEY, GEMINI_API_KEY
  • Notification Keys: BARK_KEY_1 (at least one), PUSHPLUS_TOKEN (optional)
  • PUSHPLUS_TOPIC (optional)
• Links:
  • English README: README_EN.md
  • PushPlus Demo: img/pushplus.png
  • Bark Demo: Link to img/bark.mp4

Highlighted Details

• AI-driven analysis using Google Gemini for nuanced financial news interpretation.
• Multi-channel push notifications via Bark and PushPlus for real-time alerts across devices.
• Key metrics extraction: investment advice, confidence index, and source reliability (%).
• Configurable trusted news sources, market symbols, and news fetch intervals.
• Daemon management for background operation with logging and process control.
• Automatic deduplication of news to prevent redundant notifications.

Maintenance & Community

The project welcomes community contributions, including issues, documentation improvements, and code submissions. No specific community channels (like Discord or Slack) or roadmap details are provided in the README.

Licensing & Compatibility

The project is licensed under the MIT License, which is permissive for commercial use and integration into closed-source projects.

Limitations & Caveats

The service relies on external API keys for Finnhub, Gemini, Bark, and PushPlus, which may incur costs or be subject to rate limits. Setup requires manual configuration of these keys and environment variables. The quality of analysis is dependent on the capabilities of Google Gemini AI and the curated list of trusted news sources. The project appears to be maintained by a single developer, suggesting a potentially low bus factor.