Skip to main content

VibeSurf: A powerful browser assistant for vibe surfing

Project description

VibeSurf: A powerful browser assistant for vibe surfing

Discord WarmShao

VibeSurf is an open-source AI agentic browser that revolutionizes browser automation and research.

If you're as excited about open-source AI browsing as I am, give it a star! ⭐

✨ Key Features

  • 🧠 Advanced AI Automation: Beyond browser automation, VibeSurf performs deep research, intelligent crawling, content summarization, and more to exploration.

  • 🚀 Multi-Agent Parallel Processing: Run multiple AI agents simultaneously in different browser tabs, enabling both deep research and wide research with massive efficiency gains.

  • 🥷 Stealth-First Architecture: Uses Chrome DevTools Protocol (CDP) instead of Playwright for superior stealth capabilities, preventing bot detection.

  • 🎨 Seamless Chrome Extension UI: Native browser integration without switching applications, providing an intuitive interface that feels like part of your browser.

  • 🔒 Privacy-First LLM Support: Supports local LLMs (Ollama, etc.) and custom LLM APIs to ensure your browsing data stays private and secure during vibe surfing.

🛠️ Installation

Step 1: Install uv

Install uv from https://docs.astral.sh/uv/getting-started/installation/:

# On macOS and Linux
curl -LsSf https://astral.sh/uv/install.sh | sh

# On Windows
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

Step 2: Setup and Install

uv venv --python 3.12
uv pip install vibesurf -U

Step 3: Launch

uv run vibesurf

🗺️ Roadmap

We're building VibeSurf to be your ultimate AI browser companion. Here's what's coming next:

  • Smart Skills System: Add /search for quick information search and /crawl for automatic website data extraction
  • Powerful Coding Agent: Build a comprehensive coding assistant for data processing and analysis directly in your browser
  • Third-Party Integrations: Connect with n8n workflows and other tools to combine browsing with automation
  • Custom Workflow Templates: Create reusable templates for auto-login, data collection, and complex browser automation
  • Smart Interaction Features: Text selection for translation/Q&A, screenshot analysis, and voice reading capabilities
  • Real-Time Conversation & Memory: Add persistent chat functionality with global memory to make VibeSurf truly understand you

🎬 Demo

How to use?

Your browser does not support playing this video!

Dozens of agent running in on browser

Your browser does not support playing this video!

📝 License

Licensed under the Apache License 2.0.

👏 Acknowledgments

VibeSurf builds on top of other awesome open-source projects:

Huge thanks to their creators and contributors!

Project details


Release history Release notifications | RSS feed

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

vibesurf-0.1.23.tar.gz (2.4 MB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

vibesurf-0.1.23-py3-none-any.whl (2.4 MB view details)

Uploaded Python 3

File details

Details for the file vibesurf-0.1.23.tar.gz.

File metadata

  • Download URL: vibesurf-0.1.23.tar.gz
  • Upload date:
  • Size: 2.4 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for vibesurf-0.1.23.tar.gz
Algorithm Hash digest
SHA256 23d74c860c3bb834aecbac6a3b9cbc80a0e0403e1e1acf0f1b74347c5d679025
MD5 77d2f09096775780ac558c6c4c26cdc0
BLAKE2b-256 f1d8f7b73d2b698f667e5fc027c86d5a09539c87922c351b2c9bdd6c57747f8a

See more details on using hashes here.

File details

Details for the file vibesurf-0.1.23-py3-none-any.whl.

File metadata

  • Download URL: vibesurf-0.1.23-py3-none-any.whl
  • Upload date:
  • Size: 2.4 MB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for vibesurf-0.1.23-py3-none-any.whl
Algorithm Hash digest
SHA256 f0e814daf7b59fa731856354cf783cec7d96d4363edc2bafb7caadfdc2ef0691
MD5 1507ce1e53bf2db76749fb4079b60d5c
BLAKE2b-256 2f82b2e3dbfc86fc6ecd2a363f78c1edfcc767b8655d1638bdf712201d634aed

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page