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/saranghaeyong/bitchordweb.git
   cd bitchordweb

   Copy
2. 2

   Install the required runtimes

   Node.js LTS (no version pinned), Bun, Python 3.x (no version pinned)

   # needs nvm: brew install nvm (or https://github.com/nvm-sh/nvm)
   nvm install --lts
   curl -fsSL https://bun.sh/install | bash
   brew install python

   Copy
3. 3

   Configure environment variables

   Fill in secrets: GEMINI_API_KEY

   cp .env.example .env

   Copy
4. 4

   Install dependencies

   bun install
   python -m venv .venv
   source .venv/bin/activate
   pip install -r requirements.txt

   Copy
5. 5

   Run it

   bun run dev

   Copy

npm install

npm run dev

npm run build
npm start