Skip to content

DEV Community

abdullah amin

Posted on Oct 25

SlothSurf: The Zero-Effort Autonomous Browser Agent for Lazy Humans 🦥

#ai #agents #opensource #python

This is a submission for the Hacktoberfest Open-Source AI Challenge Week 3: Slow and Steady

What I Built

October 20th is International Sloth Day, and sloths have life figured out: they move at their own pace, conserve energy, and never burn calories unless absolutely necessary.

Meanwhile, humans spend hours every day on tedious digital chores:

Digging through 50 Hacker News or Reddit comments to find the actual point
Checking 3 weather sites to decide whether to get out of bed
Comparing prices across tabs while popups block the screen
Filling out multi-page web forms

SlothSurf is an autonomous browser agent that takes a high-level instruction ("Summarize the top 3 tech discussions today", "Find me a budget coffee maker under $25", "Check the weather and tell me if I have permission to stay in bed") and executes it inside a real Chromium browser: navigating, scrolling, clicking, extracting the key insight, and handing you the answer while you stay on the couch.

It features:

Interactive Sloth CLI with ASCII art, real-time step streaming, and lazy presets
Streamlit web dashboard with a one-click mission launcher plus model and slow-motion sliders
Sloth-tuned prompt that conserves actions, takes the most direct clicks, and delivers the bare minimum needed to keep you informed

Code

algo-abdullah / slothsurf

🦥 SlothSurf — The Zero-Effort Autonomous Web Agent

"Slow and steady wins the race. Doing nothing wins the prize."

Built for the Slow and Steady (International Sloth Day) AI Challenge.
Powered by the open-source browser-use agent harness and xAI Grok (grok-2-vision-1212).

🌟 Overview

SlothSurf is an autonomous browser agent built for when you are simply too lazy to click, scroll, and read through endless websites yourself.

Hands-Free Web Browsing: Watch Chromium navigate, click buttons, and read pages for you.
Open-Source Core: Powered by the open-source browser-use library with zero vendor lock-in.
Grok 2 Vision Integration: Lightning-fast visual grounding and snarky, concise summaries.
Dual Interface: Run it in your terminal with rich ASCII art or launch the interactive Streamlit web dashboard.

🚀 Quickstart

1. Prerequisites & Virtual Environment

Ensure you have Python 3.11+ installed.

# Create and activate virtual environment
python -m venv .venv
# On Windows (PowerShell):
.

…

Run it yourself in 3 steps:

# 1. Clone & install
git clone https://github.com/algo-abdullah/slothsurf.git
cd slothsurf
pip install -r requirements.txt
playwright install chromium

# 2. Add your Grok API key
echo "XAI_API_KEY=your_xai_key_here" > .env

# 3. Launch
python main.py          # Terminal CLI
streamlit run app.py    # Web dashboard

How I Built It

The architecture is clean and decoupled:

[ User (CLI / Streamlit UI) ]
            │
            ▼
   [ Sloth Agent Engine ]
   ├── Agent harness: browser-use (open source)
   ├── Browser controller: Playwright (Chromium)
   └── Vision reasoning: xAI Grok API (grok-2-vision-1212)
            │
            ▼
 [ Live Chromium Browser Navigation ]

Harness: browser-use handles screenshot capture, coordinate mapping, and browser action sequencing.
Brain: grok-2-vision-1212 via the xAI API for fast vision grounding and concise answers.
Interface: a Rich CLI for terminal lovers and Streamlit for visual desktop users.

Why Does Open Innovation Matter?

No lock-in, no license fees. Closed RPA and cloud browser-automation platforms (UiPath, agent SaaS products) charge monthly subscriptions, restrict you to their proprietary cloud browsers, and gate API access. Building on browser-use and open Playwright standards means the whole agent layer is free software that I own, modify, and run on my own machine.

Model agnostic. Because the harness uses the standard OpenAI/LangChain client interface, I connected it to Grok for fast visual reasoning, but I can swap to local open-weight models (Qwen2-VL, Llama-3.2-Vision) with a single environment variable change whenever I need offline privacy. A closed automation bot would have locked me into one model.

Inspectable and private. Web agents touch cookies, tabs, and personal accounts. With an open harness, every DOM extraction, screenshot, and coordinate click is visible in Python code, and nothing phones home telemetry to a corporate vendor.

The Lazy Payoff

The future of AI shouldn't just be about working faster; it should be about working less. SlothSurf turns multi-tab, multi-click chores into one sentence typed from the couch.

Stay slow, stay steady, and happy International Sloth Day! 🦥

Top comments (0)

Subscribe