A comprehensive stock market portfolio analysis tool that helps users identify undervalued & overvalued stocks, track performance, and leverage AI-powered insights.
- 📊 Portfolio Management: Users can create stock lists, track investments, and analyze stock fundamentals.
- 🤖 AI-Powered Insights: ML models predict stock valuations, detect trends, and assess risk.
- 🏛 Company Earnings Call Summaries: LLMs extract key takeaways and financial indicators.
- 🔍 Stock Screening: Identify undervalued & overvalued stocks based on financial history.
- 📈 Custom KPI Calculations: Users define custom ratios and financial indicators.
By contributing to this project, you will gain hands-on experience with:
- ✅ Best coding practices (structured repo, Python packaging, modular code design)
- ✅ End-to-end ML project setup (data ingestion, feature engineering, model training & deployment)
- ✅ Collaboration (GitHub PRs, issue tracking, code reviews, forks, branching strategies)
- ✅ Python packaging (
pyproject.toml,setup.py,requirements.txt,pip install -e .) - ✅ ML & LLMs (financial modeling, company earnings call summarization, AI-driven KPI indicators)
- ✅ Data Analysis (fundamental analysis, feature engineering, valuation models)
- ✅ Databases (PostgreSQL, MongoDB, MinIO for storage, MLflow for experiments)
- ✅ MLOps & CI/CD (model tracking, automation, Dockerized services, API deployment)
| Category | Technologies |
|---|---|
| Frontend | Dash |
| Backend | FastAPI |
| Databases | PostgreSQL, MongoDB, MinIO (Object Storage) |
| ML Models | Scikit-learn, PyTorch, TensorFlow |
| Experiment Tracking | MLflow (for local experiments only) |
| Deployment | Docker, Docker Compose |
| CI/CD | GitHub Actions |
| Data Processing | Pandas, NumPy, SQLAlchemy |
| NLP for Summarization | OpenAI GPT, NLTK, Hugging Face |
We follow a Git branching strategy for organized development:
main→ Stable production branchdevelop→ Active development branchfeature/*→ Individual feature brancheshotfix/*→ Quick bug fixesdocs→ Documentation updates
💡 Contributors should fork the repo & create pull requests for merging!
git clone https://github.com/RaghavaAlajangi/StockPulse.git
cd stockplusepython -m venv venv
pip install -r requirements.txtpython -m src.app --local- Frontend (Dash):
http://localhost:8050
Want to contribute? 🎉 Follow these steps:
- Fork the repository.
- Create a new feature branch.
- Commit your changes with descriptive messages.
- Submit a pull request.
🚀 Let’s build an amazing stock analysis tool together!
💡 After your first PR, your name will be added to the contributers list!
This project is licensed under the MIT License 📜.