{"id":28424477,"url":"https://github.com/himuike/stock_portfolio_tracker","last_synced_at":"2025-10-23T18:04:09.694Z","repository":{"id":284937179,"uuid":"956533903","full_name":"Himuike/stock_portfolio_tracker","owner":"Himuike","description":"A Core Python project utilizing Object-Oriented Programming (OOP) and file handling.","archived":false,"fork":false,"pushed_at":"2025-03-28T13:23:41.000Z","size":1776,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-06-05T10:12:22.896Z","etag":null,"topics":["data-science","python","stock-market"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Himuike.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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":"2025-03-28T12:16:22.000Z","updated_at":"2025-03-28T13:30:19.000Z","dependencies_parsed_at":"2025-03-28T13:41:18.511Z","dependency_job_id":"f0f921c4-204b-41a9-84c8-6c69511d5b89","html_url":"https://github.com/Himuike/stock_portfolio_tracker","commit_stats":null,"previous_names":["himuike/stock_portfolio_tracker"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/Himuike/stock_portfolio_tracker","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Himuike%2Fstock_portfolio_tracker","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Himuike%2Fstock_portfolio_tracker/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Himuike%2Fstock_portfolio_tracker/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Himuike%2Fstock_portfolio_tracker/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Himuike","download_url":"https://codeload.github.com/Himuike/stock_portfolio_tracker/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Himuike%2Fstock_portfolio_tracker/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":261891665,"owners_count":23225768,"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":["data-science","python","stock-market"],"created_at":"2025-06-05T10:12:22.788Z","updated_at":"2025-10-23T18:04:09.607Z","avatar_url":"https://github.com/Himuike.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 📈 Stock Portfolio Tracker\n\n![Project Screenshot](screenshots/admin_menu.png)  \n*Main menu interface of the application*\n\nA console-based stock portfolio management system with admin/user roles, built with Python.\n\n## 🌟 Features\n\n### Admin Features\n- 🛠️ Add/remove stocks\n- 📊 Update stock prices\n- 👥 View all user portfolios\n- 📜 View transaction history\n\n### User Features\n- 💰 Buy/sell stocks\n- 📊 View portfolio with profit/loss calculations\n- 🕰️ Transaction history\n- 📈 Portfolio performance summary\n\n## 🛠️ Technologies Used\n\n- Python 3\n- `tabulate` for beautiful console tables\n- File-based data persistence\n- OOP principles\n\n## 📦 Installation\n\n1. Clone the repository:\n   ```bash\n   git clone https://github.com/yourusername/stock-portfolio-tracker.git\n   cd stock-portfolio-tracker\n\n2. Install dependencies:\n   bash\n   pip install -r requirements.txt\n\n3. Run the application:\n   bash\n   python main.py\n\n🖥️ Usage\n\n## First Run\n\nInitial setup screen\n\nRegister as a new user or login as admin:\nDefault admin credentials: admin/admin\nAdmin Panel\n\n## Admin Menu\nAdmin management interface\n\nManage stocks and view all transactions\nUser Interface\n\n## User Portfolio\nUser portfolio view with profit/loss\n\nBuy/sell stocks and track your investments\n\n\n## 🚀 Future Enhancements\n\n- Real-time stock price integration\n- Graphical portfolio visualization\n- Email notifications\n- Multi-user support\n\n## 🤝 Contributing\n\n- Fork the project\n- Create your feature branch (git checkout -b feature/AmazingFeature)\n- Commit your changes (git commit -m 'Add some AmazingFeature')\n- Push to the branch (git push origin feature/AmazingFeature)\n- Open a Pull Request\n\n## 📝 License\n\nDistributed under the MIT License. See LICENSE for more information.\n\n\u003cdiv align=\"center\"\u003e\n    Made with ❤️ and Python\n\u003c/div\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhimuike%2Fstock_portfolio_tracker","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhimuike%2Fstock_portfolio_tracker","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhimuike%2Fstock_portfolio_tracker/lists"}