vibesurf 0.1.29

VibeSurf: A powerful browser assistant for vibe surfing

VibeSurf: A powerful browser assistant for vibe surfing

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! ⭐

中文 | English

✨ 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

Get VibeSurf up and running in just three simple steps. No complex configuration required.

1. Install uv

Install uv package manager from the official website

MacOS/Linux

curl -LsSf https://astral.sh/uv/install.sh | sh

Windows

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

2. Setup Environment

Install VibeSurf

uv pip install vibesurf -U

3. Launch VibeSurf

Start the VibeSurf browser assistant

uv run vibesurf

👩‍💻 For Contributors

Want to contribute to VibeSurf? Follow these steps to set up your development environment:

1. Clone Repository

git clone https://github.com/vibesurf-ai/VibeSurf.git
cd VibeSurf

2. Setup Environment

MacOS/Linux

uv venv --python 3.12
source .venv/bin/activate
uv pip install -e .

Windows

uv venv --python 3.12
.venv\Scripts\activate
uv pip install -e .

3. Start Debugging

Option 1: Direct Server

uvicorn vibe_surf.backend.main:app --host 127.0.0.1 --port 9335

Option 2: CLI Entry

uv run vibesurf

🗺️ Roadmap

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

• Smart Skills System - Completed Add /search for quick information search and /crawl for automatic website data extraction. Integrated native APIs for Xiaohongshu, Douyin, Weibo, and YouTube.

• Powerful Coding Agent - In Progress Build a comprehensive coding assistant for data processing and analysis directly in your browser

• Agentic Browser Workflow - Planned Create custom drag-and-drop workflows for auto-login, data collection, and complex browser automation tasks

• Third-Party Integrations - Planned Connect with n8n workflows and other tools to combine browsing with automation

• Intelligent Memory & Personalization - Planned Transform VibeSurf into a truly human-like companion with persistent memory that learns your preferences, habits, and browsing patterns over time

🎬 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

This repository is licensed under the VibeSurf Open Source License, based on Apache 2.0 with additional conditions.

👏 Acknowledgments

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

• Browser Use
• LangGraph

Huge thanks to their creators and contributors!