https://github.com/himuike/stock_portfolio_tracker

A Core Python project utilizing Object-Oriented Programming (OOP) and file handling.
https://github.com/himuike/stock_portfolio_tracker

data-science python stock-market

Last synced: 9 months ago
JSON representation

A Core Python project utilizing Object-Oriented Programming (OOP) and file handling.

• Host: GitHub
• URL: https://github.com/himuike/stock_portfolio_tracker
• Owner: Himuike
• License: gpl-3.0
• Created: 2025-03-28T12:16:22.000Z (over 1 year ago)
• Default Branch: main
• Last Pushed: 2025-03-28T13:23:41.000Z (over 1 year ago)
• Last Synced: 2025-06-05T10:12:22.896Z (about 1 year ago)
• Topics: data-science, python, stock-market
• Language: Python
• Homepage:
• Size: 1.69 MB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# 📈 Stock Portfolio Tracker

![Project Screenshot](screenshots/admin_menu.png)  

*Main menu interface of the application*

A console-based stock portfolio management system with admin/user roles, built with Python.

## 🌟 Features

### Admin Features

- 🛠️ Add/remove stocks

- 📊 Update stock prices

- 👥 View all user portfolios

- 📜 View transaction history

### User Features

- 💰 Buy/sell stocks

- 📊 View portfolio with profit/loss calculations

- 🕰️ Transaction history

- 📈 Portfolio performance summary

## 🛠️ Technologies Used

- Python 3

- `tabulate` for beautiful console tables

- File-based data persistence

- OOP principles

## 📦 Installation

1. Clone the repository:

   ```bash

   git clone https://github.com/yourusername/stock-portfolio-tracker.git

   cd stock-portfolio-tracker

2. Install dependencies:

   bash

   pip install -r requirements.txt

3. Run the application:

   bash

   python main.py

🖥️ Usage

## First Run

Initial setup screen

Register as a new user or login as admin:

Default admin credentials: admin/admin

Admin Panel

## Admin Menu

Admin management interface

Manage stocks and view all transactions

User Interface

## User Portfolio

User portfolio view with profit/loss

Buy/sell stocks and track your investments

## 🚀 Future Enhancements

- Real-time stock price integration

- Graphical portfolio visualization

- Email notifications

- Multi-user support

## 🤝 Contributing

- Fork the project

- Create your feature branch (git checkout -b feature/AmazingFeature)

- Commit your changes (git commit -m 'Add some AmazingFeature')

- Push to the branch (git push origin feature/AmazingFeature)

- Open a Pull Request

## 📝 License

Distributed under the MIT License. See LICENSE for more information.



    Made with ❤️ and Python