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

4. Start to Use

1017-2.mp4

👩‍💻 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, /crawl for automatic website data extraction and /code for webpage js code execution. Integrated native APIs for Xiaohongshu, Douyin, Weibo, and YouTube.

• Third-Party Integrations - Completed Connect with hundreds of popular tools including Gmail, Notion, Google Calendar, Slack, Trello, GitHub, and more through Composio integration to combine browsing with powerful automation capabilities

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

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

• 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?

0831-1-ff.mp4

Dozens of agent running in on browser

0901.mp4

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