Skip to content

setup.md

Latest commit

 

History

History
116 lines (82 loc) · 1.44 KB

setup.md

File metadata and controls

116 lines (82 loc) · 1.44 KB

Setup

Requirements

  • Node.js 20+
  • npm or yarn
  • Chrome/Chromium (for local mode)

Install dependencies

git clone <repo-url>
cd idea-ai
npm install

Environment setup

cp .env.example .env

Operating modes

1. Mock mode (for testing)

No API keys required, uses pre-defined sample data.

# .env
MOCK_MODE=true
npm run mine

2. Local mode (LOCAL)

Uses local Chrome and OpenAI API.

# .env
MOCK_MODE=false
STAGEHAND_ENV=LOCAL
OPENAI_API_KEY=sk-...
npm run mine

3. Cloud mode (BROWSERBASE)

Uses Browserbase cloud browser.

# .env
MOCK_MODE=false
STAGEHAND_ENV=BROWSERBASE
BROWSERBASE_API_KEY=...
BROWSERBASE_PROJECT_ID=...
OPENAI_API_KEY=sk-...

Getting API keys

OpenAI

  1. Go to https://platform.openai.com/api-keys
  2. Create a new key
  3. Add to .env: OPENAI_API_KEY=sk-...

Browserbase (optional)

  1. Go to https://browserbase.com
  2. Create a project
  3. Copy API Key and Project ID
  4. Add to .env: 
    BROWSERBASE_API_KEY=...
BROWSERBASE_PROJECT_ID=...

Verify installation

# Type check
npm run typecheck

# Run in mock mode
npm run mine

# Check results
ls -la out/

Troubleshooting

Chrome not found

Install Chrome or Chromium:

# Ubuntu/Debian
sudo apt install chromium-browser

# macOS
brew install --cask google-chrome

Playwright error

npx playwright install chromium