vibesurf 0.1.28__tar.gz → 0.1.29__tar.gz

{vibesurf-0.1.28 → vibesurf-0.1.29}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: vibesurf
-Version: 0.1.28
+Version: 0.1.29
 Summary: VibeSurf: A powerful browser assistant for vibe surfing
 Author: Shao Warm
 License: Apache-2.0
@@ -71,56 +71,88 @@ If you're as excited about open-source AI browsing as I am, give it a star! ⭐
 
 ## 🛠️ Installation
 
-### Step 1: Install uv
-Install uv from [https://docs.astral.sh/uv/getting-started/installation/](https://docs.astral.sh/uv/getting-started/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**
 ```bash
-# On macOS and Linux
 curl -LsSf https://astral.sh/uv/install.sh | sh
+```
 
-# On Windows
+**Windows**
+```bash
 powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
 ```
 
-### Step 2: Setup and Install
+### 2. Setup Environment
+Install VibeSurf
+
 ```bash
-uv venv --python 3.12
 uv pip install vibesurf -U
 ```
 
-### Step 3: Launch
+### 3. Launch VibeSurf
+Start the VibeSurf browser assistant
+
 ```bash
 uv run vibesurf
 ```
 
 ## 👩‍💻 For Contributors
 
-Want to contribute to VibeSurf? Here are two ways to set up your development environment:
+Want to contribute to VibeSurf? Follow these steps to set up your development environment:
 
-### Method 1: Direct Server Run
-Run the backend server directly using uvicorn:
+### 1. Clone Repository
 ```bash
-uvicorn vibe_surf.backend.main:app --host 127.0.0.1 --port 9335
+git clone https://github.com/vibesurf-ai/VibeSurf.git
+cd VibeSurf
 ```
 
-### Method 2: Editable Installation
-Install the package in editable mode and run using the CLI:
+### 2. Setup Environment
+**MacOS/Linux**
 ```bash
+uv venv --python 3.12
+source .venv/bin/activate
 uv pip install -e .
-uv run vibesurf
 ```
 
-Choose the method that works best for your development workflow!
-## �️ Roadmap
+**Windows**
+```bash
+uv venv --python 3.12
+.venv\Scripts\activate
+uv pip install -e .
+```
+
+### 3. Start Debugging
+**Option 1: Direct Server**
+```bash
+uvicorn vibe_surf.backend.main:app --host 127.0.0.1 --port 9335
+```
+
+**Option 2: CLI Entry**
+```bash
+uv run vibesurf
+```
+## 🗺️ Roadmap
 
 We're building VibeSurf to be your ultimate AI browser companion. Here's what's coming next:
 
-- [x] **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
+- [x] **Smart Skills System** - *Completed*
+  Add `/search` for quick information search and `/crawl` for automatic website data extraction. Integrated native APIs for Xiaohongshu, Douyin, Weibo, and YouTube.
+
+- [ ] **Powerful Coding Agent** - *In Progress*
+  Build a comprehensive coding assistant for data processing and analysis directly in your browser
+
+- [ ] **Agentic Browser Workflow** - *Planned*
+  Create custom drag-and-drop workflows for auto-login, data collection, and complex browser automation tasks
+
+- [ ] **Third-Party Integrations** - *Planned*
+  Connect with n8n workflows and other tools to combine browsing with automation
+
+- [ ] **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

{vibesurf-0.1.28 → vibesurf-0.1.29}/README.md

@@ -22,56 +22,88 @@ If you're as excited about open-source AI browsing as I am, give it a star! ⭐
 
 ## 🛠️ Installation
 
-### Step 1: Install uv
-Install uv from [https://docs.astral.sh/uv/getting-started/installation/](https://docs.astral.sh/uv/getting-started/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**
 ```bash
-# On macOS and Linux
 curl -LsSf https://astral.sh/uv/install.sh | sh
+```
 
-# On Windows
+**Windows**
+```bash
 powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
 ```
 
-### Step 2: Setup and Install
+### 2. Setup Environment
+Install VibeSurf
+
 ```bash
-uv venv --python 3.12
 uv pip install vibesurf -U
 ```
 
-### Step 3: Launch
+### 3. Launch VibeSurf
+Start the VibeSurf browser assistant
+
 ```bash
 uv run vibesurf
 ```
 
 ## 👩‍💻 For Contributors
 
-Want to contribute to VibeSurf? Here are two ways to set up your development environment:
+Want to contribute to VibeSurf? Follow these steps to set up your development environment:
 
-### Method 1: Direct Server Run
-Run the backend server directly using uvicorn:
+### 1. Clone Repository
 ```bash
-uvicorn vibe_surf.backend.main:app --host 127.0.0.1 --port 9335
+git clone https://github.com/vibesurf-ai/VibeSurf.git
+cd VibeSurf
 ```
 
-### Method 2: Editable Installation
-Install the package in editable mode and run using the CLI:
+### 2. Setup Environment
+**MacOS/Linux**
 ```bash
+uv venv --python 3.12
+source .venv/bin/activate
 uv pip install -e .
-uv run vibesurf
 ```
 
-Choose the method that works best for your development workflow!
-## �️ Roadmap
+**Windows**
+```bash
+uv venv --python 3.12
+.venv\Scripts\activate
+uv pip install -e .
+```
+
+### 3. Start Debugging
+**Option 1: Direct Server**
+```bash
+uvicorn vibe_surf.backend.main:app --host 127.0.0.1 --port 9335
+```
+
+**Option 2: CLI Entry**
+```bash
+uv run vibesurf
+```
+## 🗺️ Roadmap
 
 We're building VibeSurf to be your ultimate AI browser companion. Here's what's coming next:
 
-- [x] **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
+- [x] **Smart Skills System** - *Completed*
+  Add `/search` for quick information search and `/crawl` for automatic website data extraction. Integrated native APIs for Xiaohongshu, Douyin, Weibo, and YouTube.
+
+- [ ] **Powerful Coding Agent** - *In Progress*
+  Build a comprehensive coding assistant for data processing and analysis directly in your browser
+
+- [ ] **Agentic Browser Workflow** - *Planned*
+  Create custom drag-and-drop workflows for auto-login, data collection, and complex browser automation tasks
+
+- [ ] **Third-Party Integrations** - *Planned*
+  Connect with n8n workflows and other tools to combine browsing with automation
+
+- [ ] **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

{vibesurf-0.1.28 → vibesurf-0.1.29}/README_zh.md

@@ -23,57 +23,89 @@ VibeSurf 是一个开源的 AI 代理浏览器，它革新了浏览器自动化
 
 ## 🛠️ 安装
 
-### 第一步：安装 uv
-从 [https://docs.astral.sh/uv/getting-started/installation/](https://docs.astral.sh/uv/getting-started/installation/) 安装 uv：
+仅需三个简单步骤即可启动并运行 VibeSurf。无需复杂配置。
 
+### 1. 安装 uv
+从官方网站安装 uv 包管理器
+
+**MacOS/Linux**
 ```bash
-# 在 macOS 和 Linux 上
 curl -LsSf https://astral.sh/uv/install.sh | sh
+```
 
-# 在 Windows 上
+**Windows**
+```bash
 powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
 ```
 
-### 第二步：设置和安装
+### 2. 设置环境
+安装 VibeSurf
+
 ```bash
-uv venv --python 3.12
 uv pip install vibesurf -U
 ```
 
-### 第三步：启动
+### 3. 启动 VibeSurf
+启动 VibeSurf 浏览器助手
+
 ```bash
 uv run vibesurf
 ```
 
-## 👩‍💻 对贡献者
+## 👩‍💻 贡献者指南
 
-想为 VibeSurf 做贡献？以下是设置开发环境的两种方法：
+想为 VibeSurf 做贡献？请按照以下步骤设置您的开发环境：
 
-### 方法 1：直接运行服务器
-使用 uvicorn 直接运行后端服务器：
+### 1. 克隆仓库
 ```bash
-uvicorn vibe_surf.backend.main:app --host 127.0.0.1 --port 9335
+git clone https://github.com/vibesurf-ai/VibeSurf.git
+cd VibeSurf
 ```
 
-### 方法 2：可编辑安装
-以可编辑模式安装包并使用 CLI 运行：
+### 2. 设置环境
+**MacOS/Linux**
 ```bash
+uv venv --python 3.12
+source .venv/bin/activate
 uv pip install -e .
-uv run vibesurf
 ```
 
-选择最适合您开发工作流程的方法！
+**Windows**
+```bash
+uv venv --python 3.12
+.venv\Scripts\activate
+uv pip install -e .
+```
+
+### 3. 开始调试
+**选项 1：直接服务器**
+```bash
+uvicorn vibe_surf.backend.main:app --host 127.0.0.1 --port 9335
+```
+
+**选项 2：CLI 入口**
+```bash
+uv run vibesurf
+```
 
 ## 🗺️ 路线图
 
 我们正在构建 VibeSurf，使其成为您终极的 AI 浏览器伴侣。以下是接下来的计划：
 
-- [x] **智能技能系统**：添加 `/search` 用于快速信息搜索，`/crawl` 用于自动网站数据提取
-- [ ] **强大的编码代理**：构建一个全面的编码助手，用于在浏览器中直接进行数据处理和分析
-- [ ] **第三方集成**：与 n8n 工作流和其他工具连接，将浏览与自动化结合
-- [ ] **自定义工作流模板**：创建可重用的模板，用于自动登录、数据收集和复杂的浏览器自动化
-- [ ] **智能交互功能**：文本选择用于翻译/问答、截图分析和语音阅读功能
-- [ ] **实时对话和记忆**：添加持久聊天功能和全局记忆，使 VibeSurf 真正理解您
+- [x] **智能技能系统** - *已完成*
+  添加 `/search` 用于快速信息搜索，`/crawl` 用于自动网站数据提取。集成了小红书、抖音、微博和 YouTube 的原生 API。
+
+- [ ] **强大的编码代理** - *进行中*
+  构建一个全面的编码助手，用于在浏览器中直接进行数据处理和分析
+
+- [ ] **智能浏览器工作流** - *计划中*
+  创建自定义拖拽式工作流，用于自动登录、数据收集和复杂的浏览器自动化任务
+
+- [ ] **第三方集成** - *计划中*
+  与 n8n 工作流和其他工具连接，将浏览与自动化结合
+
+- [ ] **智能记忆与个性化** - *计划中*
+  将 VibeSurf 转变为真正的人性化伴侣，具备持久记忆功能，能够学习您的偏好、习惯和浏览模式
 
 ## 🎬 演示
 

{vibesurf-0.1.28 → vibesurf-0.1.29}/vibe_surf/_version.py

@@ -28,7 +28,7 @@ version_tuple: VERSION_TUPLE
 commit_id: COMMIT_ID
 __commit_id__: COMMIT_ID
 
-__version__ = version = '0.1.28'
-__version_tuple__ = version_tuple = (0, 1, 28)
+__version__ = version = '0.1.29'
+__version_tuple__ = version_tuple = (0, 1, 29)
 
-__commit_id__ = commit_id = 'gf16277cb8'
+__commit_id__ = commit_id = 'g468e636fb'

{vibesurf-0.1.28 → vibesurf-0.1.29}/vibe_surf/backend/shared_state.py

@@ -353,13 +353,13 @@ async def initialize_vibesurf_components():
         browser_execution_path = os.getenv("BROWSER_EXECUTION_PATH", "")
         assert os.path.exists(browser_execution_path), "Please set the BROWSER_EXECUTION_PATH environment variable"
         browser_user_data = os.getenv("BROWSER_USER_DATA", "")
-        if not browser_user_data:
+        if not browser_user_data or not os.path.exists(browser_user_data):
             browser_user_data = os.path.join(workspace_dir, "browser_user_data",
                                              f"{os.path.basename(browser_execution_path)}-profile")
 
         # Get VibeSurf extension path
         vibesurf_extension = os.getenv("VIBESURF_EXTENSION", "")
-        if not vibesurf_extension.strip():
+        if not vibesurf_extension.strip() or not os.path.exists(vibesurf_extension):
             current_file = Path(__file__)
             project_root = current_file.parent.parent.absolute()
             vibesurf_extension = str(project_root / "chrome_extension")

{vibesurf-0.1.28 → vibesurf-0.1.29}/vibe_surf/chrome_extension/config.js

@@ -27,6 +27,14 @@ const VIBESURF_CONFIG = {
     autoScroll: true,
     compactMode: false
   },
+
+  // Social media links
+  SOCIAL_LINKS: {
+    github: "https://github.com/vibesurf-ai/VibeSurf",
+    discord: "https://discord.gg/EZ2YnUXP",
+    x: "https://x.com/warmshao",
+    website: "https://vibe-surf.com/"
+  },
   
   // Debug mode
   DEBUG: false

{vibesurf-0.1.28 → vibesurf-0.1.29}/vibe_surf/chrome_extension/scripts/ui-manager.js

@@ -31,6 +31,7 @@ class VibeSurfUIManager {
     this.initializeManagers();
     this.bindEvents();
     this.setupSessionListeners();
+    this.initializeSocialLinks();
   }
 
   bindElements() {
@@ -3468,6 +3469,151 @@ class VibeSurfUIManager {
     return skills.length > 0 ? skills : null;
   }
 
+  // Initialize social links from config
+  initializeSocialLinks() {
+    const socialLinksContainer = document.getElementById('social-links-container');
+    if (!socialLinksContainer) {
+      console.warn('[UIManager] Social links container not found');
+      return;
+    }
+
+    // Get social links from config
+    const socialLinks = window.VIBESURF_CONFIG?.SOCIAL_LINKS;
+    if (!socialLinks) {
+      console.warn('[UIManager] Social links not found in config');
+      return;
+    }
+
+    // Clear existing content
+    socialLinksContainer.innerHTML = '';
+
+    // Handle website link separately by making VibeSurf logo/text clickable
+    const websiteUrl = socialLinks.website;
+    if (websiteUrl) {
+      this.initializeVibeSurfWebsiteLink(websiteUrl);
+    }
+
+    // Create social link elements (excluding website)
+    Object.entries(socialLinks).forEach(([platform, url]) => {
+      if (platform !== 'website') {
+        const link = this.createSocialLink(platform, url);
+        if (link) {
+          socialLinksContainer.appendChild(link);
+        }
+      }
+    });
+  }
+
+  // Make VibeSurf text clickable to link to website
+  initializeVibeSurfWebsiteLink(websiteUrl) {
+    // Only find elements that contain "VibeSurf" text specifically
+    const allElements = document.querySelectorAll('*');
+    const vibeSurfTextElements = [];
+    
+    allElements.forEach(element => {
+      // Only target elements that contain "VibeSurf" text and are likely text elements
+      if (element.textContent &&
+          element.textContent.trim() === 'VibeSurf' &&
+          element.children.length === 0) { // Only leaf text nodes, not containers
+        vibeSurfTextElements.push(element);
+      }
+    });
+    
+    // Make only VibeSurf text elements clickable
+    vibeSurfTextElements.forEach(element => {
+      if (element && !element.querySelector('a')) { // Don't double-wrap already linked elements
+        element.style.cursor = 'pointer';
+        element.style.transition = 'opacity 0.2s ease';
+        element.setAttribute('title', 'Login to early access alpha features');
+        
+        // Add hover effect
+        element.addEventListener('mouseenter', () => {
+          element.style.opacity = '0.8';
+        });
+        
+        element.addEventListener('mouseleave', () => {
+          element.style.opacity = '1';
+        });
+        
+        // Add click handler
+        element.addEventListener('click', (e) => {
+          e.preventDefault();
+          e.stopPropagation();
+          this.openWebsiteLink(websiteUrl);
+        });
+      }
+    });
+  }
+
+  // Open website link in new tab
+  async openWebsiteLink(url) {
+    try {
+      console.log('[UIManager] Opening VibeSurf website:', url);
+      
+      const result = await chrome.runtime.sendMessage({
+        type: 'OPEN_FILE_URL',
+        data: { fileUrl: url }
+      });
+      
+      if (!result || !result.success) {
+        throw new Error(result?.error || 'Failed to open website');
+      }
+      
+      console.log('[UIManager] Successfully opened website tab:', result.tabId);
+    } catch (error) {
+      console.error('[UIManager] Error opening website:', error);
+      this.showNotification(`Failed to open website: ${error.message}`, 'error');
+    }
+  }
+
+  // Create individual social link element
+  createSocialLink(platform, url) {
+    const link = document.createElement('a');
+    link.href = url;
+    link.className = 'social-link';
+    link.setAttribute('data-platform', platform);
+    link.setAttribute('target', '_blank');
+    link.setAttribute('rel', 'noopener noreferrer');
+
+    // Set title and tooltip based on platform
+    let title = '';
+    let svg = '';
+
+    switch (platform.toLowerCase()) {
+      case 'github':
+        title = 'GitHub';
+        svg = `<svg width="16" height="16" viewBox="0 0 24 24" fill="none" xmlns="http://www.w3.org/2000/svg">
+          <path d="M12 0C5.374 0 0 5.373 0 12c0 5.302 3.438 9.8 8.207 11.387.599.111.793-.261.793-.577v-2.234c-3.338.726-4.033-1.416-4.033-1.416-.546-1.387-1.333-1.756-1.333-1.756-1.089-.745.083-.729.083-.729 1.205.084 1.839 1.237 1.839 1.237 1.07 1.834 2.807 1.304 3.492.997.107-.775.418-1.305.762-1.604-2.665-.305-5.467-1.334-5.467-5.931 0-1.311.469-2.381 1.236-3.221-.124-.303-.535-1.524.117-3.176 0 0 1.008-.322 3.301 1.23A11.509 11.509 0 0112 5.803c1.02.005 2.047.138 3.006.404 2.291-1.552 3.297-1.23 3.297-1.23.653 1.653.242 2.874.118 3.176.77.84 1.235 1.911 1.235 3.221 0 4.609-2.807 5.624-5.479 5.921.43.372.823 1.102.823 2.222v3.293c0 .319.192.694.801.576C20.566 21.797 24 17.3 24 12c0-6.627-5.373-12-12-12z" fill="currentColor"/>
+        </svg>`;
+        break;
+      
+      case 'discord':
+        title = 'Discord';
+        svg = `<svg width="16" height="16" viewBox="0 0 24 24" fill="none" xmlns="http://www.w3.org/2000/svg">
+          <path d="M20.317 4.37a19.791 19.791 0 00-4.885-1.515.074.074 0 00-.079.037c-.21.375-.444.864-.608 1.25a18.27 18.27 0 00-5.487 0 12.64 12.64 0 00-.617-1.25.077.077 0 00-.079-.037A19.736 19.736 0 003.677 4.37a.07.07 0 00-.032.027C.533 9.046-.32 13.58.099 18.057a.082.082 0 00.031.057 19.9 19.9 0 005.993 3.03.078.078 0 00.084-.028c.462-.63.874-1.295 1.226-1.994a.076.076 0 00-.041-.106 13.107 13.107 0 01-1.872-.892.077.077 0 01-.008-.128 10.2 10.2 0 00.372-.292.074.074 0 01.077-.01c3.928 1.793 8.18 1.793 12.062 0a.074.074 0 01.078.01c.12.098.246.198.373.292a.077.077 0 01-.006.127 12.299 12.299 0 01-1.873.892.077.077 0 00-.041.107c.36.698.772 1.362 1.225 1.993a.076.076 0 00.084.028 19.839 19.839 0 006.002-3.03.077.077 0 00.032-.054c.5-5.177-.838-9.674-3.549-13.66a.061.061 0 00-.031-.03zM8.02 15.33c-1.183 0-2.157-1.085-2.157-2.419 0-1.333.956-2.419 2.157-2.419 1.21 0 2.176 1.096 2.157 2.42 0 1.333-.956 2.418-2.157 2.418zm7.975 0c-1.183 0-2.157-1.085-2.157-2.419 0-1.333.955-2.419 2.157-2.419 1.21 0 2.176 1.096 2.157 2.42 0 1.333-.946 2.418-2.157 2.418z" fill="currentColor"/>
+        </svg>`;
+        break;
+      
+      case 'x':
+      case 'twitter':
+        title = 'X (Twitter)';
+        svg = `<svg width="16" height="16" viewBox="0 0 24 24" fill="none" xmlns="http://www.w3.org/2000/svg">
+          <path d="M18.244 2.25h3.308l-7.227 8.26 8.502 11.24H16.17l-5.214-6.817L4.99 21.75H1.68l7.73-8.835L1.254 2.25H8.08l4.713 6.231zm-1.161 17.52h1.833L7.084 4.126H5.117z" fill="currentColor"/>
+        </svg>`;
+        break;
+      
+      
+      default:
+        console.warn(`[UIManager] Unknown social platform: ${platform}`);
+        return null;
+    }
+
+    link.setAttribute('title', title);
+    link.innerHTML = svg;
+
+    return link;
+  }
+
   // Export for use in other modules
   static exportToWindow() {
     if (typeof window !== 'undefined') {

{vibesurf-0.1.28 → vibesurf-0.1.29}/vibe_surf/chrome_extension/sidepanel.html

@@ -36,22 +36,8 @@
                         <div class="logo-brand">
                             <img src="icons/logo.png" alt="VibeSurf" class="logo-image">
                             <span class="logo-text">VibeSurf</span>
-                            <div class="social-links">
-                                <a href="https://github.com/vvincent1234/VibeSurf" class="social-link" title="GitHub" data-platform="github" target="_blank" rel="noopener noreferrer">
-                                    <svg width="16" height="16" viewBox="0 0 24 24" fill="none" xmlns="http://www.w3.org/2000/svg">
-                                        <path d="M12 0C5.374 0 0 5.373 0 12c0 5.302 3.438 9.8 8.207 11.387.599.111.793-.261.793-.577v-2.234c-3.338.726-4.033-1.416-4.033-1.416-.546-1.387-1.333-1.756-1.333-1.756-1.089-.745.083-.729.083-.729 1.205.084 1.839 1.237 1.839 1.237 1.07 1.834 2.807 1.304 3.492.997.107-.775.418-1.305.762-1.604-2.665-.305-5.467-1.334-5.467-5.931 0-1.311.469-2.381 1.236-3.221-.124-.303-.535-1.524.117-3.176 0 0 1.008-.322 3.301 1.23A11.509 11.509 0 0112 5.803c1.02.005 2.047.138 3.006.404 2.291-1.552 3.297-1.23 3.297-1.23.653 1.653.242 2.874.118 3.176.77.84 1.235 1.911 1.235 3.221 0 4.609-2.807 5.624-5.479 5.921.43.372.823 1.102.823 2.222v3.293c0 .319.192.694.801.576C20.566 21.797 24 17.3 24 12c0-6.627-5.373-12-12-12z" fill="currentColor"/>
-                                    </svg>
-                                </a>
-                                <a href="https://discord.gg/WSeRwW2M" class="social-link" title="Discord" data-platform="discord" target="_blank" rel="noopener noreferrer">
-                                    <svg width="16" height="16" viewBox="0 0 24 24" fill="none" xmlns="http://www.w3.org/2000/svg">
-                                        <path d="M20.317 4.37a19.791 19.791 0 00-4.885-1.515.074.074 0 00-.079.037c-.21.375-.444.864-.608 1.25a18.27 18.27 0 00-5.487 0 12.64 12.64 0 00-.617-1.25.077.077 0 00-.079-.037A19.736 19.736 0 003.677 4.37a.07.07 0 00-.032.027C.533 9.046-.32 13.58.099 18.057a.082.082 0 00.031.057 19.9 19.9 0 005.993 3.03.078.078 0 00.084-.028c.462-.63.874-1.295 1.226-1.994a.076.076 0 00-.041-.106 13.107 13.107 0 01-1.872-.892.077.077 0 01-.008-.128 10.2 10.2 0 00.372-.292.074.074 0 01.077-.01c3.928 1.793 8.18 1.793 12.062 0a.074.074 0 01.078.01c.12.098.246.198.373.292a.077.077 0 01-.006.127 12.299 12.299 0 01-1.873.892.077.077 0 00-.041.107c.36.698.772 1.362 1.225 1.993a.076.076 0 00.084.028 19.839 19.839 0 006.002-3.03.077.077 0 00.032-.054c.5-5.177-.838-9.674-3.549-13.66a.061.061 0 00-.031-.03zM8.02 15.33c-1.183 0-2.157-1.085-2.157-2.419 0-1.333.956-2.419 2.157-2.419 1.21 0 2.176 1.096 2.157 2.42 0 1.333-.956 2.418-2.157 2.418zm7.975 0c-1.183 0-2.157-1.085-2.157-2.419 0-1.333.955-2.419 2.157-2.419 1.21 0 2.176 1.096 2.157 2.42 0 1.333-.946 2.418-2.157 2.418z" fill="currentColor"/>
-                                    </svg>
-                                </a>
-                                <a href="https://x.com/warmshao" class="social-link" title="X (Twitter)" data-platform="x" target="_blank" rel="noopener noreferrer">
-                                    <svg width="16" height="16" viewBox="0 0 24 24" fill="none" xmlns="http://www.w3.org/2000/svg">
-                                        <path d="M18.244 2.25h3.308l-7.227 8.26 8.502 11.24H16.17l-5.214-6.817L4.99 21.75H1.68l7.73-8.835L1.254 2.25H8.08l4.713 6.231zm-1.161 17.52h1.833L7.084 4.126H5.117z" fill="currentColor"/>
-                                    </svg>
-                                </a>
+                            <div class="social-links" id="social-links-container">
+                                <!-- Social links will be populated dynamically from config -->
                             </div>
                         </div>
                         <div class="session-info">

{vibesurf-0.1.28 → vibesurf-0.1.29}/vibesurf.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: vibesurf
-Version: 0.1.28
+Version: 0.1.29
 Summary: VibeSurf: A powerful browser assistant for vibe surfing
 Author: Shao Warm
 License: Apache-2.0
@@ -71,56 +71,88 @@ If you're as excited about open-source AI browsing as I am, give it a star! ⭐
 
 ## 🛠️ Installation
 
-### Step 1: Install uv
-Install uv from [https://docs.astral.sh/uv/getting-started/installation/](https://docs.astral.sh/uv/getting-started/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**
 ```bash
-# On macOS and Linux
 curl -LsSf https://astral.sh/uv/install.sh | sh
+```
 
-# On Windows
+**Windows**
+```bash
 powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
 ```
 
-### Step 2: Setup and Install
+### 2. Setup Environment
+Install VibeSurf
+
 ```bash
-uv venv --python 3.12
 uv pip install vibesurf -U
 ```
 
-### Step 3: Launch
+### 3. Launch VibeSurf
+Start the VibeSurf browser assistant
+
 ```bash
 uv run vibesurf
 ```
 
 ## 👩‍💻 For Contributors
 
-Want to contribute to VibeSurf? Here are two ways to set up your development environment:
+Want to contribute to VibeSurf? Follow these steps to set up your development environment:
 
-### Method 1: Direct Server Run
-Run the backend server directly using uvicorn:
+### 1. Clone Repository
 ```bash
-uvicorn vibe_surf.backend.main:app --host 127.0.0.1 --port 9335
+git clone https://github.com/vibesurf-ai/VibeSurf.git
+cd VibeSurf
 ```
 
-### Method 2: Editable Installation
-Install the package in editable mode and run using the CLI:
+### 2. Setup Environment
+**MacOS/Linux**
 ```bash
+uv venv --python 3.12
+source .venv/bin/activate
 uv pip install -e .
-uv run vibesurf
 ```
 
-Choose the method that works best for your development workflow!
-## �️ Roadmap
+**Windows**
+```bash
+uv venv --python 3.12
+.venv\Scripts\activate
+uv pip install -e .
+```
+
+### 3. Start Debugging
+**Option 1: Direct Server**
+```bash
+uvicorn vibe_surf.backend.main:app --host 127.0.0.1 --port 9335
+```
+
+**Option 2: CLI Entry**
+```bash
+uv run vibesurf
+```
+## 🗺️ Roadmap
 
 We're building VibeSurf to be your ultimate AI browser companion. Here's what's coming next:
 
-- [x] **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
+- [x] **Smart Skills System** - *Completed*
+  Add `/search` for quick information search and `/crawl` for automatic website data extraction. Integrated native APIs for Xiaohongshu, Douyin, Weibo, and YouTube.
+
+- [ ] **Powerful Coding Agent** - *In Progress*
+  Build a comprehensive coding assistant for data processing and analysis directly in your browser
+
+- [ ] **Agentic Browser Workflow** - *Planned*
+  Create custom drag-and-drop workflows for auto-login, data collection, and complex browser automation tasks
+
+- [ ] **Third-Party Integrations** - *Planned*
+  Connect with n8n workflows and other tools to combine browsing with automation
+
+- [ ] **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