Colab Agent Bridge - Documentation

Mengapa Alat Ini Dibuat?

Google Colab memberikan akses gratis ke GPU (seperti T4) yang sangat berguna untuk melatih model AI (*finetuning LLM*). Namun, Google Colab tidak memiliki API resmi untuk dikontrol secara otomatis dari luar.

Jika Anda sedang membangun agen AI (*AI Agent*) atau sistem otomatis di komputer lokal Anda, agen tersebut tidak bisa begitu saja "mengetik" atau "menjalankan" kode di Google Colab. Colab Agent Bridge menyelesaikan masalah ini dengan memanipulasi Editor Colab (Monaco Editor) langsung dari dalam *browser* Anda.

AI Agent Apa Saja yang Didukung?

Untuk saat ini, jembatan eksklusif ini didesain secara khusus untuk berkomunikasi dengan Agy (Antigravity Agent). Agy dapat sepenuhnya membaca konteks sel Colab, menulis kode, hingga mengeksekusi proses training model Anda secara otonom.

Agy (Antigravity CLI)

Cara Menginstal Agy (Antigravity CLI)

Agy adalah asisten pemrograman otonom tingkat lanjut dari Google DeepMind yang dijalankan melalui antarmuka terminal (CLI). Untuk menggunakan ekstensi jembatan ini secara maksimal, pastikan Anda telah menginstal Agy.

1. Unduh & Instal via NPM

Jika Anda sudah memiliki Node.js terpasang, buka terminal lokal Anda dan jalankan:

npm install -g antigravity-cli

2. Autentikasi

Tautkan terminal dengan kredensial Google Anda:

agy auth login

3. Jalankan Agy

Masuk ke folder repositori Colab-Agent-Bridge lalu jalankan agen:

agy start

Lihat Repositori Resmi Agy (GitHub)

Cara Kerja (Alur Sistem)

1

AI Agent Lokal

Skrip Python (atau Agen AI Anda) ingin mengeksekusi sesuatu di Colab. Ia mengirim permintaan HTTP POST sederhana ke Local Server.

2

Python Bridge Server

Berjalan di latar belakang komputer Anda (localhost:8765). Bertindak sebagai ruang tunggu (antrian) untuk perintah-perintah tersebut.

3

Chrome Extension

Terpasang di Chrome. Secara aktif bertanya ke Server: "Ada perintah baru?". Jika ada, ia akan menulis dan memencet tombol 'Play' di Google Colab secara otomatis.

Agent Lokal → (HTTP POST) → Server Antrian ← (Long Polling) ← Ekstensi Chrome → (DOM Inject) → Google Colab

Cara Instalasi

1

Unduh Repositori
Klon repositori GitHub ke komputer Anda.

git clone https://github.com/nikoidm123/Colab-Agent-Bridge.git
2

Pasang Ekstensi di Chrome
Buka chrome://extensions/, aktifkan Developer Mode, klik Load Unpacked, dan pilih folder ekstensi yang baru saja diunduh.
3

Jalankan Local Server
Jalankan server jembatan menggunakan Python (tidak perlu pustaka eksternal).

python server.py
4

Buka Google Colab
Buka *tab* Google Colab mana saja. Ekstensi akan otomatis mendeteksi URL dan mulai menghubungi localhost:8765.

Contoh Jika Sudah Terhubung

Ketika ekstensi aktif, Anda tidak perlu menyentuh *mouse* atau *keyboard* sama sekali. Sel-sel kode di Google Colab Anda akan diisi dan dijalankan secara otomatis (seperti ada "hantu" yang mengetiknya).

colab.research.google.com

[ 1 ]

import time

from IPython.display import display, HTML

html = '''
<div style='background-color: #030014; color: #06b6d4; padding: 20px; border-radius: 10px; border: 2px solid #06b6d4; box-shadow: 0 0 15px rgba(6, 182, 212, 0.5); font-family: monospace; font-size: 16px; text-align: center;'>
<h2 style='color: #fff; margin-top: 0;'>🚀 ANTIGRAVITY AI ONLINE</h2>
<p>Sistem Bridge Server berhasil terhubung dua arah dengan ekstensi Chrome!</p>
<p style='color: #8b5cf6; font-weight: bold;'>Status: READY. Menunggu perintah dari agen AI...</p>
</div>
'''

display(HTML(html))

🚀 ANTIGRAVITY AI ONLINESistem Bridge Server berhasil terhubung dua arah dengan ekstensi Chrome!
Status: READY. Menunggu perintah dari agen AI...

Agen jarak jauh akan membaca status sel ini. Jika berhasil dieksekusi, agen akan mendapatkan tanda centang hijau dan menerima balasan *output* dari sel (teks "🚀 Menjalankan...").

Dokumentasi API

Kirim HTTP POST request ke http://localhost:8765/command dengan payload JSON berikut:

POST Action: read_cell

Mengekstrak isi dari sel Colab tertentu berdasarkan indeks (dimulai dari 0).

{
    "action": "read_cell",
    "index": 0
}
                        

POST Action: write_cell

Menimpa kode di dalam sel tertentu. Membutuhkan parameter tambahan code.

{
    "action": "write_cell",
    "index": 0,
    "code": "print('Hello from AI Agent!')"
}
                        

POST Action: run_cell

Menjalankan sel tertentu di Colab (mensimulasikan klik tombol Play atau pintasan Ctrl+Enter).

{
    "action": "run_cell",
    "index": 0
}
                        

Contoh Penggunaan di Skrip Python (AI Agent)

Gunakan skrip Python ini sebagai Agen Anda untuk memerintahkan Colab secara otomatis.

import requests
import time

SERVER_URL = "http://localhost:8765/command"

def write_and_run_colab(cell_index, python_code):
    # 1. Tulis kode ke Colab
    payload_write = {
        "action": "write_cell",
        "index": cell_index,
        "code": python_code
    }
    print("Menulis kode ke Colab...")
    requests.post(SERVER_URL, json=payload_write)
    
    time.sleep(1) # Beri jeda sebentar
    
    # 2. Jalankan eksekusi
    payload_run = {
        "action": "run_cell",
        "index": cell_index
    }
    print("Mengeksekusi kode di Colab...")
    requests.post(SERVER_URL, json=payload_run)

# --- Contoh Penggunaan ---
kode_untuk_colab = """
import torch
print(f"GPU Tersedia: {torch.cuda.is_available()}")
print("Halo dari Agen Lokal!")
"""

write_and_run_colab(cell_index=0, python_code=kode_untuk_colab)
                