AlphaDesk is a terminal-based stock dashboard built with Python. It allows you to search, track, and analyze stocks with a modern UI, live price updates, and advanced features.

• Global stock search with live suggestions
• Sidebar watchlist for quick access
• Real-time price updates and alerts
• Interactive ASCII/plot charts
• Export watchlist to CSV
• Compare multiple stocks
• Historical stats
• News feed for selected stocks
• Notes for each stock
• Dark/light theme toggle

1. Clone the repository:

git clone https://github.com/adhyys07/AlphaDesk
cd folder_name/Alphadesk

2. Install dependencies:

pip install -r requirements.txt

Run the dashboard:

python app.py

• Search stocks: Type a ticker or company name in the search bar. Suggestions will appear as you type.
• Add to watchlist: Press Enter or click Add to add a stock.
• Sidebar: Click a stock to view details, chart, stats, and news.
• Set alerts: Enter a price threshold in the alert input (e.g., >150).0).
• Add notes: Enter notes for each stock.
• Export: Click Export to save your watchlist as CSV.
• Compare: Enter multiple tickers (comma-separated) to compare charts.
• Theme: Toggle between dark and light modes.

• US large caps: AAPL, MSFT, GOOGL, AMZN, NVDA, TSLA
• Financials and energy: JPM, V, XOM, CVX
• ETFs: SPY, QQQ, DIA
• International ADRs: BABA, TM, SAP

To enable stock news in the dashboard:

1. Sign up at https://newsapi.org/ and get your free API key.
2. Create a .env file in your project root and add:

NEWSAPI_KEY=your_actual_newsapi_key_here

3. Restart your dashboard and select a popular stock (e.g., AAPL, MSFT) to see news.

The news panel will show headlines, source, date, and summary for the selected stock.

• app.py - Executes full project
• ui/dashboard.py - Main UI and logic
• api/market.py - Market data functions
• data/ - Watchlist and chart cache

I have used AI in this project in debugging and fixing features for this dashboard. Also took suggestions from AI to add new features.