Installation Guide

How to set up the Hippopotamoose environment from source.

Prerequisites

• Python 3.11+ (Ensure it is added to your PATH)
• Node.js (Required for Wrangler and Claude CLI)
• Cyotek WebCopy (Required for the Lead Evaluation 'Copy' step to scrape websites)

Step 1 — Download the Code

Clone or extract the source code into a dedicated directory on your machine (e.g., E:\All In One App\).

Step 2 — Install Python Dependencies

Open a terminal (PowerShell or Command Prompt) and install the required Python packages:

cd "E:\All In One App"
pip install -r requirements.txt

Step 3 — Install Global NPM Dependencies

The app relies on two globally installed NPM packages to handle AI site generation and deployment. Run the following commands in your terminal:

npm install -g @anthropic-ai/claude-cli
npm install -g wrangler

Step 4 — Install Playwright Browsers

Playwright is used to run headless browser instances for certain scraping and validation steps. Install its Chromium binary by running:

playwright install chromium

Uninstalling

Because the app runs directly from source, there is no system uninstaller. To remove the app, simply delete the source code folder. Keep in mind that doing so will also delete your downloaded_sites/ and edited_sites/ directories.