Market Pulse¶
Personal stock prediction tracker for US and Korean markets.
What it does¶
- Ingests price data and news for ~30 US and KR tickers
- Runs bilingual sentiment analysis (FinBERT for EN and KO; VADER / keyword lexicon fallback)
- Trains a Random Forest model per horizon (1d / 7d / 30d) and produces directional predictions
- Serves everything through a React dashboard with bilingual UI and headline translation
Stack¶
| Layer | Tech |
|---|---|
| Prices | yfinance (US), FinanceDataReader (KR) |
| News | Finnhub API (US), NAVER Finance scraper (KR) |
| Sentiment | FinBERT (ProsusAI/finbert EN, snunlp/KR-FinBert-SC KO); VADER / keyword fallback |
| ML | scikit-learn Random Forest |
| DB | Supabase PostgreSQL (AWS ap-northeast-1) |
| API | FastAPI on port 8000 |
| Frontend | React 19 + TypeScript + Vite + Tailwind CSS on port 5173 |
Docs layout¶
- Spec — what each feature is and why it exists
- Implementation — how things are built, gotchas, how to extend
- Plans — per-feature implementation plans and in-progress work