Skip to content

Open-Source AI-powered web browser. Browse the web with your own LLM API key. Alternative to Dia / Comet.

Notifications You must be signed in to change notification settings

co-browser/vibe

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Vibe Browser

The Interactive Browser.

Twitter URL Discord

Alpha software – APIs and security hardening are still evolving.


Quick Start

Download the latest image from the releases page 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

# 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).

Self-Hosted Gmail OAuth

If you prefer to use your own Google Cloud project:

Console (Web) setup
  1. Select or create a project in the Google Cloud Console.
  2. Enable the Gmail API in the library.
  3. Create OAuth credentials (Desktop app) and download the JSON file.
gcloud (CLI) setup
# 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.

Finish up

mkdir -p ~/.gmail-mcp
mv gcp-oauth.keys.json ~/.gmail-mcp/

Demo

Demo


Release Notes

Note

v0.1.7 - July 10, 2025

Gmail Fix: Fixed an issue where Gmail integration would break after restarting the app
Process Management: Email server now properly shuts down when you quit the app
Stability: No more "port already in use" errors on subsequent launches

For the full technical changelog, see CHANGELOG.md.

Contributing

Please follow the guidelines in CONTRIBUTING.md.
The project’s code of conduct is available in CODE_OF_CONDUCT.md.

About

Open-Source AI-powered web browser. Browse the web with your own LLM API key. Alternative to Dia / Comet.

Topics

Resources

Code of conduct

Security policy

Stars

Watchers

Forks

Contributors 5