Installation¶

This guide will help you install and set up Scrapazoid on your system.

Prerequisites¶

Python 3.9 or higher
Git
Virtual environment tool (venv or virtualenv)

Installation Steps¶

1. Clone the Repository¶

git clone https://github.com/yourusername/scrapazoid.git
cd scrapazoid

2. Create a Virtual Environment¶

python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

3. Install Dependencies¶

pip install -r requirements.txt

4. Install Playwright Browsers¶

playwright install chromium

5. Initialize the Database¶

flask init_db

6. Run the Application¶

python run.py

The application will be available at http://localhost:5000

Docker Installation (Alternative)¶

If you prefer using Docker:

docker-compose up -d

Environment Variables¶

Create a .env file in the project root:

# Application
FLASK_ENV=development
SECRET_KEY=your-secret-key-here

# Database
DATABASE_URL=sqlite:///scrapazoid_dev.db

# Execution Settings
MAX_EXECUTION_TIME=300
MAX_CONCURRENT_EXECUTIONS_PER_USER=3

Verify Installation¶

Navigate to http://localhost:5000
Register a new account
Go to the Editor and run the example script
Check that screenshots and logs appear

Troubleshooting¶

Playwright Browser Not Found¶

playwright install chromium

Database Errors¶

flask init_db

Port Already in Use¶

Change the port in run.py:

socketio.run(app, port=5001)  # Changed from 5000