vibesurf 0.1.27

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

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

👩‍💻 For Contributors

Want to contribute to VibeSurf? Here are two ways to set up your development environment:

Method 1: Direct Server Run

Run the backend server directly using uvicorn:

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

Method 2: Editable Installation

Install the package in editable mode and run using the CLI:

uv pip install -e .
uv run vibesurf

Choose the method that works best for your development workflow!

�️ 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

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!