{"id":28816786,"url":"https://github.com/marinaredamekhael/financialadvisor","last_synced_at":"2026-05-07T01:07:21.312Z","repository":{"id":298683047,"uuid":"1000757246","full_name":"marinaredamekhael/FinancialAdvisor","owner":"marinaredamekhael","description":"A personalized financial advisory web application that leverages machine learning, sentiment analysis, and real-time market data to recommend smart investment strategies. Built with Flask, PostgreSQL, and integrated with financial APIs like Alpha Vantage, Yahoo Finance, and News API.","archived":false,"fork":false,"pushed_at":"2025-06-12T09:53:33.000Z","size":3915,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-06-19T19:10:56.992Z","etag":null,"topics":["ai","alpha-vantage","dashboard","finance","financial-data","flask","hybrid","investment-recommendation","lstm","machine-learning","newsapi","portfolio-management","postgresql","python","real-time-data","sentiment-analysis","stock-market"],"latest_commit_sha":null,"homepage":"","language":"HTML","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/marinaredamekhael.png","metadata":{"files":{"readme":"README.md","changelog":"news_service.py","contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-06-12T09:21:19.000Z","updated_at":"2025-06-12T09:53:37.000Z","dependencies_parsed_at":"2025-06-12T10:36:50.458Z","dependency_job_id":"ebd0780d-545f-40ba-94cd-d1d987647cdf","html_url":"https://github.com/marinaredamekhael/FinancialAdvisor","commit_stats":null,"previous_names":["marinaredamekhael/financialadvisor"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/marinaredamekhael/FinancialAdvisor","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/marinaredamekhael%2FFinancialAdvisor","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/marinaredamekhael%2FFinancialAdvisor/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/marinaredamekhael%2FFinancialAdvisor/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/marinaredamekhael%2FFinancialAdvisor/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/marinaredamekhael","download_url":"https://codeload.github.com/marinaredamekhael/FinancialAdvisor/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/marinaredamekhael%2FFinancialAdvisor/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":271736812,"owners_count":24812006,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-08-23T02:00:09.327Z","response_time":69,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai","alpha-vantage","dashboard","finance","financial-data","flask","hybrid","investment-recommendation","lstm","machine-learning","newsapi","portfolio-management","postgresql","python","real-time-data","sentiment-analysis","stock-market"],"created_at":"2025-06-18T17:07:01.091Z","updated_at":"2026-05-07T01:07:21.272Z","avatar_url":"https://github.com/marinaredamekhael.png","language":"HTML","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Financial Investment Recommendation System\n\nAn advanced financial investment recommendation platform that leverages machine learning to generate personalized investment strategies. The system integrates real-time market data, historical stock data, user preferences, and predictive analytics to provide intelligent investment guidance.\n![FinancialAdvisor Dashboard](https://github.com/marinaredamekhael/FinancialAdvisor/blob/main/Output/1.jpg)\n![FinancialAdvisor portfolio](https://github.com/marinaredamekhael/FinancialAdvisor/blob/main/Output/4.jpg)\n![FinancialAdvisor recommendation](https://github.com/marinaredamekhael/FinancialAdvisor/blob/main/Output/7.jpg)\n\n## Features\n\n- Personalized stock recommendations based on user preferences\n- Portfolio management and performance tracking\n- Real-time market data integration\n- Historical stock price data and visualization\n- News sentiment analysis\n- Interactive dashboard with charts and analytics\n\n## Database Options\n\nThis project uses PostgreSQL as the database.\n\n## Prerequisites\n\n- Python 3.8 or higher\n- PostgreSQL\n- Git (for cloning the repository)\n\n## Installation\n\n### 1. Clone the repository\n\n```bash\ngit clone https://github.com/marinaredamekhael/FinancialAdvisor.git\ncd FinancialAdvisor\n```\n\n### 2. Create a virtual environment\n\n#### For Windows:\n```bash\npython -m venv venv\nvenv\\Scripts\\activate\n```\n\n#### For macOS/Linux:\n```bash\npython3 -m venv venv\nsource venv/bin/activate\n```\n\n### 3. Install dependencies\n\n```bash\npip install -r project_requirements.txt\n```\n\n### 4. Set up the PostgreSQL database\n\n- Create a PostgreSQL database\n- Note down your database credentials (host, database name, username, password, port)\n\n### 5. Create a .env file\n\nCreate a `.env` file in the root directory with the following variables:\n\n```\n# Database configuration\nDATABASE_URL=postgresql://username:password@host:port/database_name\n\n# API Keys\n# Optional for enhanced functionality\nALPHAVANTAGE_API_KEY=your_alphavantage_api_key\nNEWS_API_KEY=your_newsapi_key\n\n# Flask configuration\nFLASK_SECRET_KEY=your_secret_key\n```\n\n### 6. Initialize the database\n\nYou have two options to set up the database:\n\n#### Option 1: Initialize with sample data (recommended for testing)\n\n```bash\n# Run the setup script to create tables and add sample data\npython setup_local.py\n```\n\nThis will:\n- Create all database tables\n- Add a demo user (username: demo_user, password: password123)\n- Add sample stocks, portfolio items, news, and recommendations\n\n#### Option 2: Initialize empty database\n\n```bash\n# Run the application once to create the database tables only\npython main.py\n```\n\n## Running the Application\n\n```bash\npython main.py\n```\n\nOr with gunicorn (for production):\n\n```bash\ngunicorn --bind 0.0.0.0:5000 main:app\n```\n\nThe application will be available at `http://localhost:5000`\n\n## Initial Setup Steps\n\n1. Register a new user account\n2. Set up your investment preferences\n3. Navigate to `/test/generate-recommendations` to populate sample stocks and recommendations\n4. Add stocks to your portfolio\n5. Explore the dashboard, recommendations, and news features\n\n## Project Structure\n\n- `main.py`: Entry point for the application\n- `app.py`: Flask app configuration\n- `models.py`: Database models\n- `routes.py`: Application routes and views\n- `data_fetcher.py`: Functions to fetch stock and news data\n- `recommendation.py`: Recommendation engine\n- `sentiment_analysis.py`: News sentiment analysis\n- `templates/`: HTML templates\n- `static/`: CSS, JavaScript, and other static files\n\n## Technologies Used\n\n- **Backend**: Python, Flask, SQLAlchemy\n- **Database**: PostgreSQL\n- **Data Processing**: Pandas, NumPy, scikit-learn\n- **Natural Language Processing**: NLTK\n- **Frontend**: HTML, CSS, Bootstrap, Chart.js\n- **APIs**: Yahoo Finance, News API, Alpha Vantage\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmarinaredamekhael%2Ffinancialadvisor","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmarinaredamekhael%2Ffinancialadvisor","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmarinaredamekhael%2Ffinancialadvisor/lists"}