Alpha software – APIs and security hardening are still evolving.
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.
# 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 devThe desktop application will reload automatically as you edit the source code.
| 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). |
If you prefer to use your own Google Cloud project:
Console (Web) setup
- Select or create a project in the Google Cloud Console.
- Enable the Gmail API in the library.
- 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.comCreate 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/
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.
Please follow the guidelines in CONTRIBUTING.md.
The project’s code of conduct is available in CODE_OF_CONDUCT.md.