vibe

<picture> <source media="(prefers-color-scheme: dark)" srcset="./static/vibe-dark.png"> <source media="(prefers-color-scheme: light)" srcset="./static/vibe-light.png"> <img alt="Vibe Browser" src="./static/vibe-dark.png" width="100%"> </picture> <h1 align="center">The Interactive Browser.</h1> <div align="center"> [](https://x.com/cobrowser) [](https://discord.gg/gw9UpFUhyY) </div> > **Alpha software** – APIs and security hardening are still evolving. --- ## Quick Start Download the latest image from the [releases page](https://github.com/co-browser/vibe/releases) and run it. In the chat window’s bottom bar: | Do this | What it enables | |---------|------------------| | **Sign in with Gmail** | Email tooling | | **Sign in with Co-Browser** | Persistent memory | | **Enter OpenAI API key** | AI features | That’s all, start browsing and Vibe adapts as you go. --- ## Local Development ```bash # Copy the environment template cp .env.example .env # Add your OpenAI key inside .env # OPENAI_API_KEY=sk-xxxxxxxxxxxxx # Install dependencies and start the app pnpm install pnpm dev ``` The desktop application will reload automatically as you edit the source code. --- ## Configuration Flags | Flag | Purpose | |------|---------| | `USE_LOCAL_RAG_SERVER=true` | Use a locally running RAG server. | | `USE_LOCAL_GMAIL_AUTH=true` | Use self-hosted Gmail OAuth (see below). | | `USE_LOCAL_GMAIL_SERVER=true` | Run Gmail MCP server locally (default: cloud). | ### Self-Hosted Gmail OAuth If you prefer to use your own Google Cloud project: <details> <summary>Console (Web) setup</summary> 1. Select or create a project in the [Google Cloud Console](https://console.cloud.google.com/projectselector2/home/dashboard).<br> 2. Enable the Gmail API in the [library](https://console.cloud.google.com/apis/library/gmail.googleapis.com).<br> 3. Create OAuth credentials (Desktop app) and download the JSON file. </details> <details> <summary>gcloud (CLI) setup</summary> ```bash # Authenticate and pick a project gcloud auth login # (Optional) create a new project gcloud projects create YOUR_PROJECT_ID # Activate the project gcloud config set project YOUR_PROJECT_ID # Enable the Gmail API gcloud services enable gmail.googleapis.com ``` Create OAuth credentials for a Desktop application in the console (step 3 above) and download the JSON file. </details> **Finish up** ```bash mkdir -p ~/.gmail-mcp mv gcp-oauth.keys.json ~/.gmail-mcp/ ``` --- ## Demo  --- ## Release Notes > **Note** > > [v0.1.8](https://github.com/co-browser/vibe/releases/tag/v0.1.8) - July 19, 2025 > > • **Cloud Gmail Support:** Gmail MCP server can now run in the cloud, controlled by `USE_LOCAL_GMAIL_SERVER` environment variable > • **Authentication UX:** Added lock icon and tooltip to Gmail button showing when CoBrowser sign-in is needed for cloud access > • **Enhanced Security:** Improved token handling and added secure IPC channel for environment variable access > • **Flexible Deployment:** Gmail integration now works seamlessly in both local and cloud modes For the full technical changelog, see [CHANGELOG.md](CHANGELOG.md). ## Contributing Please follow the guidelines in [CONTRIBUTING.md](CONTRIBUTING.md). The project’s code of conduct is available in [CODE_OF_CONDUCT.md](CODE_OF_CONDUCT.md).