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 bash setup.sh. 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: xcode-select --install

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

   Copy
2. 2

   Install the required tools

   Python 3, Node.js

   brew install python
   brew install node

   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

   cp .env.example .env

   Copy
4. 4

   Follow the README: Quick Start

   In the maintainers' order. Do the README instructions above first — they cover steps outside the terminal.

   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