{"id":15159909,"url":"https://github.com/roialfassi/stock_comparator","last_synced_at":"2026-01-21T15:32:40.418Z","repository":{"id":253774065,"uuid":"844468643","full_name":"Roialfassi/Stock_Comparator","owner":"Roialfassi","description":"Comparing Stocks over time (good for ETF's vs SPY)","archived":false,"fork":false,"pushed_at":"2024-08-22T18:57:02.000Z","size":13,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-02-13T19:45:39.027Z","etag":null,"topics":["finance","python","stocks","streamlit","yahoo-finance"],"latest_commit_sha":null,"homepage":"https://stock-comparator.streamlit.app/","language":"Python","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/Roialfassi.png","metadata":{"files":{"readme":"README.md","changelog":null,"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}},"created_at":"2024-08-19T10:22:30.000Z","updated_at":"2024-08-22T18:57:05.000Z","dependencies_parsed_at":"2024-08-22T20:41:19.759Z","dependency_job_id":null,"html_url":"https://github.com/Roialfassi/Stock_Comparator","commit_stats":{"total_commits":8,"total_committers":1,"mean_commits":8.0,"dds":0.0,"last_synced_commit":"afe3102621560c7e5e0b4d43478e927b117647b6"},"previous_names":["roialfassi/stock_comparator"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Roialfassi%2FStock_Comparator","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Roialfassi%2FStock_Comparator/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Roialfassi%2FStock_Comparator/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Roialfassi%2FStock_Comparator/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Roialfassi","download_url":"https://codeload.github.com/Roialfassi/Stock_Comparator/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247699694,"owners_count":20981591,"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","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":["finance","python","stocks","streamlit","yahoo-finance"],"created_at":"2024-09-26T22:01:55.430Z","updated_at":"2026-01-21T15:32:40.412Z","avatar_url":"https://github.com/Roialfassi.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Stock Performance Comparison App\n\n📈 **Stock Performance Comparison** is a Streamlit application that allows users to compare the historical performance of two stock tickers, including stocks, ETFs, or index funds. The app visualizes key metrics such as yearly returns, cumulative returns, and stock price history over the last 10 years (or since the latest existence of either stock). It also provides general information about the selected stocks, including market cap, sector, and more.\n\n## Features\n\n- **Yearly Performance Comparison**: Compare the yearly percentage returns of two stock tickers. The app highlights the better-performing stock each year and displays the results in a color-coded grid.\n- **Cumulative Returns**: Visualize the cumulative returns of both tickers over the selected period.\n- **Stock Price History**: View a line chart of the closing prices of both stocks over time.\n- **General Information**: Access key details about each stock, such as market cap, sector, P/E ratio, and dividend yield.\n- **Recent News**: Stay informed with the latest news related to the selected stock tickers.\n\n## Installation\n\nTo run this app locally, you'll need to have Python installed. Follow these steps:\n\n1. **Clone the repository**:\n    ```bash\n    git clone https://github.com/Roialfassi/Stock_Comparator.git\n    cd stock-performance-comparison\n    ```\n\n2. **Install the required packages**:\n    ```bash\n    pip install -r requirements.txt\n    ```\n\n3. **Run the Streamlit app**:\n    ```bash\n    streamlit run main.py\n    ```\n\n## Usage\n\n1. **Enter Stock Tickers**: Use the sidebar to input the ticker symbols of the two stocks you want to compare (e.g., `AAPL` for Apple and `MSFT` for Microsoft).\n2. **Select Start Date**: Choose the starting date for the comparison.\n3. **View Results**: Click the \"Compare Tickers\" button to view the comparison results, including:\n   - Yearly performance\n   - Cumulative returns\n   - Stock price history\n   - General information about each stock\n   - Recent news\n\n## Deployment\n\nThis app is deployed on Streamlit Community Cloud. You can access it directly via this link:\n\n[https://stock-comparator.streamlit.app/](https://stock-comparator.streamlit.app/)\n\n## Contributing\n\nContributions are welcome! If you have suggestions for new features or improvements, feel free to open an issue or submit a pull request.\n\n## License\n\nThis project is licensed under the MIT License. See the [LICENSE](LICENSE) file for more details.\n\n## Acknowledgements\n\n- [Streamlit](https://streamlit.io/) - For providing an amazing platform to build and share data apps.\n- [yFinance](https://pypi.org/project/yfinance/) - For making it easy to retrieve stock data.\n\n## Contact\n\nFor any inquiries or feedback, feel free to reach out at [roialfassi+stock_app@gmail.com](mailto:roialfassi+stock_app@gmail.com).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Froialfassi%2Fstock_comparator","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Froialfassi%2Fstock_comparator","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Froialfassi%2Fstock_comparator/lists"}