Quick Start

Getting Started with Damru

Follow this guide to get your first stealth browser automation session running in minutes.

---

Prerequisites

Before starting, ensure your system meets the following requirements:

• OS: Ubuntu 24.04 LTS (Native or WSL2)
• Docker: Installed and running
• Python: python3.10 or higher

---

Step 1: Install Damru

Install the package directly from git:

pip install git+https://github.com/akwin1234/damru.git

---

Step 2: Run Guided Setup

Initialize your configuration folder and setup dependencies using the built-in setup assistant:

python -m damru setup

The assistant will guide you through directory creation, configuration writing, and verify system compatibilities.

---

Step 3: Install OS Image & APK Assets

Download the optimized Redroid OS container and Chrome/WebView split-APKs bundle:

# 1. Download and load the pre-baked Redroid image
python -m damru install-image --download

# 2. Download raw APK assets for Chrome rotation
python -m damru install-apks --download

---

Step 4: Run Environment Checks

Verify that everything is configured correctly:

python -m damru check-env

Ensure all items (ADB, Docker, Binderfs, Playwright patches) report a green PASS.

---

Step 5: Run Your First Script

Create a script named quick_test.py and run a secure, anti-detect browser session:

import asyncio
from damru.pool import WorkerPool

async def main():
    async with WorkerPool(capacity=1) as pool:
        # Request a worker with an Adreno GPU profile
        async with pool.borrow_worker(gpu_brand="adreno") as worker:
            print(f"Acquired active worker: {worker.serial}")
            
            # Start Playwright automation session
            async with worker.stealth_session() as context:
                page = await context.new_page()
                await page.goto("https://bot.sannysoft.com")
                
                # Take a screenshot to inspect anti-bot results
                await page.screenshot(path="sannysoft_result.png")
                print("Screenshot saved to sannysoft_result.png")

if __name__ == "__main__":
    asyncio.run(main())

Run the script:

python quick_test.py

Check the saved image sannysoft_result.png. Your session has passed the Sannysoft stealth checks!