CollabShell — Manage and run Google Colab sessions directly from your phone with native TPU and GPU control

---

Download

Platform	Download	Notes
🤖 Android		Recommended for Android mobile users

Android Architecture Build Splits

Variant	Download	Notes
📱 ARM64 (most phones)	collabshell-arm64-v8a.apk	Modern 64-bit Android devices
📱 ARMv7 (older phones)	collabshell-armeabi-v7a.apk	Legacy 32-bit Android devices
💻 x86_64 (emulators)	collabshell-x86_64.apk	Chromebooks & Android emulators

---

Core Capabilities

Capability	Description
Session Lifecycle Control	Instantly create, list, restart, and stop active Google Colab sessions directly from your device.
Hardware Tiers	Provision CPU (always free), T4 GPU, or TPU v5e/v6e runtimes based on your Google tier limits.
Interactive Terminal	Run Python scripts and interactive code blocks on the remote VM with a full console output viewer.
Google Drive Mounts	Mount your personal Google Drive storage to the remote virtual machine for persistent datasets.
Package Installer	Fast pip and uv package installation directly on the remote instance.
Exportable Event Logs	Maintain history profiles and export session logs as Jupyter Notebooks (.ipynb), Markdown (.md), or plain text.
Sandbox Security	Secure OAuth2 credentials management sandboxed on your device storage.

---

Screenshots

Onboarding & Authentication

Google Sign-In Onboarding — native auth guide for managing instances	Verification Flow — OAuth2 verification sandboxed securely on your device

Dashboard & Navigation

Home view (Light Theme) — one-click access to all active runtimes	Dashboard (Dark Theme) — list active instances with direct shortcut links	New Session Provisioning — select accelerators (CPU, GPU, TPU) and set run names

Interactive Notebook & Code Editor

Interactive Editor — mount Google Drive, toggle keep-alive, and edit code cells	Command execution — run shell scripts natively with real-time progress logging

Rich Markdown editor — write documentation with live render support	Virtual Keyboard Integration — responsive input alignments for mobile screens	Result Output Console — view parsed JSON payloads and execution blocks

History, Settings & Scripts

Quick Run Mode — upload and execute raw scripts in one-shot runtimes	Chronological History — filter, trace, and export session logs to IPYNB	Settings Manager — toggle app themes, customize timeout defaults, and re-authenticate

---

Features

• CollabShell-Branded Design System — Solarized Light and deep Dark themes styled to the Google Colab branding palette.
• Dynamic Onboarding Guide — 3-step walk-through onboarding introducing features with gesture-swipe controls.
• Preloaded Interstitial Ads — Intelligent Google AdMob integration displaying ads seamlessly on mobile platforms.
• Non-Blocking Execution — Asynchronous connection wrappers ensuring the Flet UI stays fully responsive during long remote computations.
• Ruff Compliance — Clean, formatted, and strictly linted Python codebase.

---

Architecture

Layer	Technology	Purpose
Frontend	Flet	Cross-platform UI with responsive views and smooth page transitions
Client Service	google-colab-cli SDK	Wrapper for Colab session management and code execution
Local Database	Flat JSON Storage (storage.json)	Key-value store for app settings, theme state, and credentials
Auth Provider	Google OAuth2	Secure user authentication to manage personal Google Cloud instances

Visual Flow

graph TB
    subgraph COLLABSHELL_CLIENT ["📱 COLLABSHELL CLIENT (Android App)"]
        UI["🎨 Flet Reactive UI (Home | Session | Terminal | Settings)"]
        Service["⚙️ Colab Service wrapper"]
        Storage["💾 Local Storage (settings & credentials)"]
        UI --> Service
        UI --> Storage
    end

    subgraph GOOGLE_SERVICES ["🌐 GOOGLE COLAB INSTANCES"]
        OAuth["🔐 Google OAuth2 Auth Server"]
        VMs["🖥️ Google Colab Runtimes (CPU / GPU / TPU)"]
    end

    Service ==>|Google Auth Client| OAuth
    Service ==>|gRPC / REST Commands| VMs

Loading

---

Privacy & Security

CollabShell is designed with a strict Privacy-First philosophy:

1. Direct VM Connections: All commands, file accesses, and script executions are sent directly to Google Colab. No intermediate proxy.
2. Zero Metadata Tracking: We do not trace, log, or collect your code, file lists, or Google account credentials.
3. Device Sandboxing: Local settings and tokens are kept in secure application directories.
4. Data Sovereignty: Saved logs and exports reside 100% locally in your device Downloads folder.

---

Legal Disclaimer

CollabShell is an independent Flet-based client application wrapping the Google Colab CLI and is not affiliated with, authorized, maintained, sponsored, or endorsed by Google LLC, Google Colaboratory, or any of its affiliates.

Users are responsible for complying with Google Colab's Terms of Use, resource usage policies, and local data protection regulations. The authors are not responsible for any issues resulting from Google account suspensions or resource limits.