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

🤖 Agent Enhancements

  • VibeSurf Agent Refactoring: Remove LangGraph framework dependency to make the agent more flexible and powerful
  • Advanced Coding Agent: Design a powerful coding agent capable of handling and analyzing complex data, generating charts and visualizations. Combined with VibeSurf agent, this will create a "local Manus" experience
  • Enhanced Report Writer Agent: Optimize the report writer to generate more visually appealing reports with rich graphics and illustrations
  • Global Memory System: Implement global memory capabilities to make VibeSurf understand and adapt to user preferences better

🧩 Extension Features

  • Enhanced Tab Management: Add @specific tab handling with /research and /deep_research specialized task commands
  • Smart Text Processing: Implement word/paragraph translation, summarization, and explanation features for selected content
  • Local Credential Management: Add secure credential configuration system to keep your privacy data stored locally

🎬 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.16.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.16-py3-none-any.whl (2.4 MB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: vibesurf-0.1.16.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.16.tar.gz
Algorithm Hash digest
SHA256 bef2c6e6f5b6639c81f92807b810cbda229d0c5faba8a6ca61cefb87f87da9b5
MD5 69e1512156431930f3b86ec63a10c90e
BLAKE2b-256 a64b91f0f64af7814ef1498cc91eaebeab12145a95ebe70122137b1af7909c4e

See more details on using hashes here.

File details

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

File metadata

  • Download URL: vibesurf-0.1.16-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.16-py3-none-any.whl
Algorithm Hash digest
SHA256 ae484f18f41447a7a2dbe4f89abe13ef9776a46be9bd114eb97754add2982b83
MD5 7a23bacdf2e1413e7c4ea9d3754b0e4f
BLAKE2b-256 1619f9aeb6d73044c9060fe12c0a4c3fc61b553d17517ab31cc3c35ec5ad7fc8

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