VibeSurf is an open-source AI agentic browser assistant designed for advanced automation, deep research, and intelligent crawling. It targets users seeking to streamline repetitive browser tasks, enhance research efficiency, and maintain data privacy through local LLM support. The primary benefit is revolutionizing browser automation by combining deterministic workflows with AI intelligence for significant efficiency and cost savings.

How It Works

VibeSurf employs multi-agent parallel processing, allowing simultaneous operation across different browser tabs for efficient deep and wide research. Its core innovation lies in the agentic browser workflow system, which enables users to create custom, drag-and-drop or conversation-based workflows. This approach prioritizes efficiency and speed by separating deterministic, token-free repetitive tasks from dynamic AI-driven actions, ensuring consistent results and cost savings. Privacy is maintained through support for local LLMs like Ollama and custom API integrations.

Quick Start & Requirements

Installation involves three main steps:

1. Install uv package manager (cross-platform script provided).
2. Install VibeSurf using uv pip install vibesurf -U.
3. Launch VibeSurf using uv run vibesurf.

Requirements: Python 3.12 is recommended for development. A manual Chrome extension installation is required for Chrome versions 142 and later due to the removal of the --load-extension flag.

Highlighted Details

• Advanced AI automation capabilities include deep research, intelligent crawling, and content summarization.
• Multi-agent parallel processing enables simultaneous execution of tasks across multiple tabs.
• Agentic browser workflows combine deterministic automation with AI for repetitive tasks like auto-login and data collection.
• Native Chrome Extension UI offers seamless integration within the browser.
• Privacy-first LLM support includes local LLMs (Ollama) and custom API configurations.
• Completed roadmap items include a Smart Skills System with native APIs (Xiaohongshu, Douyin, Weibo, YouTube) and Third-Party Integrations via Composio.

Maintenance & Community

The project welcomes contributors with setup instructions for development environments. Community discussion is primarily facilitated through a WeChat group.

Licensing & Compatibility

The project is licensed under the "VibeSurf Open Source License," which is based on Apache 2.0 but includes additional conditions. Compatibility for commercial use or closed-source linking requires careful review of these additional conditions.

Limitations & Caveats

Due to Chrome version 142 changes, manual installation of the VibeSurf extension is necessary, adding a setup hurdle. A "Powerful Coding Agent" is currently in progress, suggesting this capability may be limited in the current release. The custom license terms may impose restrictions beyond standard Apache 2.0.