# VibeSurf: A powerful browser assistant for vibe surfing
VibeSurf is an open-source AI agentic browser that revolutionizes browser automation and research.
## ✨ 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/](https://docs.astral.sh/uv/getting-started/installation/):
```bash
# 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
```bash
uv venv --python 3.12
uv pip install vibesurf
```
### Step 3: Launch
```bash
vibesurf
```
## 🎬 Demo
<video src="https://github.com/user-attachments/assets/0a4650c0-c4ed-423e-9e16-7889e9f9816d" controls="controls">Your browser does not support playing this video!</video>
## 📝 License
Licensed under the [Apache License 2.0](LICENSE).
## 👏 Acknowledgments
VibeSurf builds on top of other awesome open-source projects:
- [Browser Use](https://github.com/browser-use/browser-use)
- [LangGraph](https://github.com/langchain-ai/langgraph)
Huge thanks to their creators and contributors!
Raw data
{
"_id": null,
"home_page": null,
"name": "vibesurf",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.11",
"maintainer_email": null,
"keywords": "browser use, browser automation, browser assistant, agentic browser, vibe surf, AI browser",
"author": "Shao Warm",
"author_email": null,
"download_url": "https://files.pythonhosted.org/packages/44/7f/207ab509a4bbced77884001f68a98664f638b680aa959b4ee2d27fc5fab6/vibesurf-0.1.3.tar.gz",
"platform": null,
"description": "# VibeSurf: A powerful browser assistant for vibe surfing\n\nVibeSurf is an open-source AI agentic browser that revolutionizes browser automation and research.\n\n## \u2728 Key Features\n\n- \ud83e\udde0 **Advanced AI Automation**: Beyond browser automation, VibeSurf performs deep research, intelligent crawling, content summarization, and more to exploration.\n\n- \ud83d\ude80 **Multi-Agent Parallel Processing**: Run multiple AI agents simultaneously in different browser tabs, enabling both deep research and wide research with massive efficiency gains.\n\n- \ud83e\udd77 **Stealth-First Architecture**: Uses Chrome DevTools Protocol (CDP) instead of Playwright for superior stealth capabilities, preventing bot detection.\n\n- \ud83c\udfa8 **Seamless Chrome Extension UI**: Native browser integration without switching applications, providing an intuitive interface that feels like part of your browser.\n\n- \ud83d\udd12 **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.\n\n## \ud83d\udee0\ufe0f Installation\n\n### Step 1: Install uv\nInstall uv from [https://docs.astral.sh/uv/getting-started/installation/](https://docs.astral.sh/uv/getting-started/installation/):\n\n```bash\n# On macOS and Linux\ncurl -LsSf https://astral.sh/uv/install.sh | sh\n\n# On Windows\npowershell -ExecutionPolicy ByPass -c \"irm https://astral.sh/uv/install.ps1 | iex\"\n```\n\n### Step 2: Setup and Install\n```bash\nuv venv --python 3.12\nuv pip install vibesurf\n```\n\n### Step 3: Launch\n```bash\nvibesurf\n```\n\n## \ud83c\udfac Demo\n\n<video src=\"https://github.com/user-attachments/assets/0a4650c0-c4ed-423e-9e16-7889e9f9816d\" controls=\"controls\">Your browser does not support playing this video!</video>\n\n\n## \ud83d\udcdd License\n\nLicensed under the [Apache License 2.0](LICENSE).\n\n## \ud83d\udc4f Acknowledgments\n\nVibeSurf builds on top of other awesome open-source projects:\n\n- [Browser Use](https://github.com/browser-use/browser-use)\n- [LangGraph](https://github.com/langchain-ai/langgraph)\n\nHuge thanks to their creators and contributors!\n\n",
"bugtrack_url": null,
"license": "Apache-2.0",
"summary": "VibeSurf: A powerful browser assistant for vibe surfing",
"version": "0.1.3",
"project_urls": {
"Repository": "https://github.com/vvincent1234/VibeSurf"
},
"split_keywords": [
"browser use",
" browser automation",
" browser assistant",
" agentic browser",
" vibe surf",
" ai browser"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "d8a47b726830caf41ed671a7f6b7fd1cf61c97f0d8b52ef2c55b4dcc660d9940",
"md5": "6eb200ab342a8a83441f56dacf56c361",
"sha256": "d685a9fac6da8a0593e49b7f5623251541fb32d3684b8de4bbd629ca63c99576"
},
"downloads": -1,
"filename": "vibesurf-0.1.3-py3-none-any.whl",
"has_sig": false,
"md5_digest": "6eb200ab342a8a83441f56dacf56c361",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.11",
"size": 874249,
"upload_time": "2025-08-31T08:14:00",
"upload_time_iso_8601": "2025-08-31T08:14:00.023668Z",
"url": "https://files.pythonhosted.org/packages/d8/a4/7b726830caf41ed671a7f6b7fd1cf61c97f0d8b52ef2c55b4dcc660d9940/vibesurf-0.1.3-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "447f207ab509a4bbced77884001f68a98664f638b680aa959b4ee2d27fc5fab6",
"md5": "c43d09115ea27802b1c05bd69dd08fb5",
"sha256": "e750495b02fc637b0b400defd937b9ae23a4c8fe932f9607eaafd88ef8300074"
},
"downloads": -1,
"filename": "vibesurf-0.1.3.tar.gz",
"has_sig": false,
"md5_digest": "c43d09115ea27802b1c05bd69dd08fb5",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.11",
"size": 871027,
"upload_time": "2025-08-31T08:14:01",
"upload_time_iso_8601": "2025-08-31T08:14:01.559322Z",
"url": "https://files.pythonhosted.org/packages/44/7f/207ab509a4bbced77884001f68a98664f638b680aa959b4ee2d27fc5fab6/vibesurf-0.1.3.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-08-31 08:14:01",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "vvincent1234",
"github_project": "VibeSurf",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "vibesurf"
}
JSON
