liang9733/finance_monitor

bash start.sh

# 1. Clone and enter directory
cd finance_monitor

# 2. Copy environment config
cp .env.example .env
# Edit .env with your credentials

# 3. One-command startup
chmod +x start.sh
./start.sh

# Backend
python3 -m venv venv
source venv/bin/activate
pip install -r backend/requirements.txt
cd backend && python main.py

# Frontend (new terminal)
cd frontend
npm install
npm run dev

Then run powershell -ExecutionPolicy Bypass -File .\setup.ps1. It stops at the first error and is safe to run again. Servers and tests aren't started; it lists them at the end. Read it first.

1. 1

   Clone the repository

   Needs Git: winget install Git.Git

   git clone https://github.com/liang9733/finance_monitor.git
   cd finance_monitor

   Copy
2. 2

   Install the required tools

   Python 3, Node.js

   winget install Python.Python.3.12
   winget install OpenJS.NodeJS.LTS

   Copy
3. 3

   Configure environment variables

   Fill in secrets: TELEGRAM_BOT_TOKEN, OPENAI_API_KEY, FINNHUB_API_KEY, ALPHAVANTAGE_API_KEY, TWELVEDATA_API_KEY, TUSHARE_TOKEN, TIINGO_API_KEY

   Copy-Item .env.example .env

   Copy
4. 4

   Follow the README: Quick Start

   Run these in Git Bash (installed with Git) or WSL — not PowerShell. Do the README instructions above first.

   cp .env.example .env
   chmod +x start.sh
   ./start.sh
   python3 -m venv venv
   source venv/bin/activate
   pip install -r backend/requirements.txt
   cd backend && python main.py
   npm install
   npm run dev

   Copy

The steps run shell scripts (.sh). Use Git Bash (winget install Git.Git) or WSL2 (wsl --install).