🌐 What Is This?

Gemini Antigravity Bridge is an MCP (Model Context Protocol) server that creates a persistent, bidirectional communication channel between:

• ☁️ Google Gemini Spark (cloud-based AI assistant with Google Workspace access, powered by Gemini 3.8 / 3.7)
• 💻 Google DeepMind Antigravity (local agentic IDE with full system access)

Optimized for Gemini 3.8's next-generation agentic reasoning, this enables a fully autonomous loop where Spark can dispatch coding tasks to your local machine, and Antigravity can request cloud intelligence back from Spark — all through a standardized, secure protocol.

┌──────────────────────────────────────────────────────────────────┐
│                    GEMINI SPARK (Google Cloud)                    │
│  📬 Gmail │ 📁 Drive │ 📅 Calendar │ 🎨 Canva │ 🎥 YouTube     │
└─────────────────────────┬────────────────────────────────────────┘
                          │ MCP over HTTPS
                          ▼
┌──────────────────────────────────────────────────────────────────┐
│              ⚡ GEMINI ANTIGRAVITY BRIDGE (MCP Server)            │
│                                                                  │
│  🔧 System Commands    📂 File Operations    🤖 Agent Dispatch   │
│  🧠 Shared Memory      🔄 Project Sync       📊 Status Reports  │
│                                                                  │
│  Tunnel: ngrok / Cloudflare (permanent HTTPS domain)             │
└─────────────────────────┬────────────────────────────────────────┘
                          │ Local MCP + Message Injection
                          ▼
┌──────────────────────────────────────────────────────────────────┐
│             ANTIGRAVITY IDE (Local Machine)                       │
│  🖥️ Terminal │ 📝 Code Editor │ 🌳 Git │ 🧪 Tests │ 🚀 Deploy  │
└──────────────────────────────────────────────────────────────────┘

🏆 Why This Bridge?

🚀 Quick Start

Prerequisites

• Python 3.10+
• ngrok account (free tier) with a reserved domain
• Google Gemini Spark (Advanced/Ultra subscription)
• Google DeepMind Antigravity IDE

Installation

# Clone the repository
git clone https://github.com/nandhakumar-murugan/gemini-antigravity-bridge.git
cd gemini-antigravity-bridge

# Install dependencies or install package directly
pip install -r requirements.txt
# OR install as a CLI tool:
pip install -e .

# Configure environment
cp .env.example .env
# Edit .env with your NGROK_AUTHTOKEN and NGROK_DOMAIN

# Launch the bridge (via script or CLI)
gemini-bridge
# or: python run_with_tunnel.py

Connect to Gemini Spark

1. Open Gemini Spark → Settings → Connected Apps
2. Click "Add a custom app"
3. Enter your public MCP URL: https://your-domain.ngrok-free.dev/mcp
4. Spark will discover all 23 tools automatically!

🛠️ Available Tools (23)

🔧 System Execution

📂 File Operations

🤖 Agent Orchestration

🧠 Shared Memory & Sync

🌐 Spark Connected Apps

🔗 Antigravity Deep Integration

🔄 Spark Connected Apps

Through the bridge, Antigravity can orchestrate Spark's connected Google & third-party apps:

🏗️ Architecture

graph TB
    subgraph Cloud["☁️ Google Cloud"]
        Spark["Gemini Spark<br/>Consumer AI Assistant"]
        Gmail["📬 Gmail"]
        Drive["📁 Google Drive"]
        Calendar["📅 Google Calendar"]
        Canva["🎨 Canva"]
    end

    subgraph Bridge["⚡ Antigravity Bridge"]
        MCP["MCP Server<br/>(FastMCP + Starlette)"]
        Tunnel["HTTPS Tunnel<br/>(ngrok / Cloudflare)"]
        Memory["🧠 Shared Memory<br/>(bridge_history.json)"]
        Dashboard["📊 Web Dashboard"]
    end

    subgraph Local["💻 Local Machine"]
        AGY["Antigravity IDE"]
        Terminal["🖥️ Terminal"]
        Git["🌳 Git Repos"]
        Files["📂 File System"]
    end

    Spark -->|"MCP over HTTPS"| Tunnel
    Tunnel --> MCP
    MCP -->|"inject_message"| AGY
    MCP -->|"run_system_command"| Terminal
    MCP -->|"git_quick_status"| Git
    MCP -->|"read/write_file"| Files
    MCP --> Memory
    AGY -->|"save_session_note"| Memory
    Memory -->|"get_agent_report"| Spark
    Spark --> Gmail
    Spark --> Drive
    Spark --> Calendar
    Spark --> Canva

🚢 Deployment

Auto-Start on Windows Boot

The bridge includes a silent startup script that launches automatically when you log in:

📁 %APPDATA%\Microsoft\Windows\Start Menu\Programs\Startup\
└── GeminiAntigravityBridge.vbs  (silent background launcher)

Cloud Deployment (24/7 Uptime)

# Using Docker
docker build -t gemini-antigravity-bridge .
docker run -d -p 8000:8000 --env-file .env gemini-antigravity-bridge

# Using Render.com / Google Cloud Run
# Push to GitHub → Connect repo → Deploy automatically

📋 Scheduled Monitoring

The bridge supports multi-tier automated monitoring via Gemini Spark schedules:

🤝 Contributing

Contributions are welcome! Please read the Apache 2.0 License before submitting PRs.

1. Fork the repository
2. Create your feature branch (git checkout -b feat/amazing-feature)
3. Commit your changes (git commit -m 'feat: add amazing feature')
4. Push to the branch (git push origin feat/amazing-feature)
5. Open a Pull Request

📄 License

This project is licensed under the Apache License 2.0 — see the LICENSE file for details.

📚 Research Paper & Academic Citation

This framework implements the formal architecture introduced in the published research paper:

AgentShield: A Zero-Trust Runtime Guardrail Architecture for Autonomous Multi-Agent AI Systems with Bidirectional Context Synchronization
Nandhakumar Murugan
Department of Computer Science and Engineering (Cybersecurity), KGiSL Institute of Technology (KiTE), Autonomous
Permanent DOI: 10.5281/zenodo.22259022 | Open Access: Zenodo CERN Repository

If you reference or build upon this architecture in academic or enterprise research, please cite:

@article{murugan2026agentshield,
  title={AgentShield: A Zero-Trust Runtime Guardrail Architecture for Autonomous Multi-Agent AI Systems with Bidirectional Context Synchronization},
  author={Murugan, Nandhakumar},
  journal={Zenodo},
  year={2026},
  doi={10.5281/zenodo.22259022},
  url={https://doi.org/10.5281/zenodo.22259022}
}

👨‍💻 Author

Nandhakumar Murugan
B.E. Computer Science & Cyber Security | KGiSL Institute of Technology
Google Student Ambassador (GID: 36) | Open Source Contributor