You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Real-time live interactive terminal sessions directly connected via Google Colab's /api/terminals WebSocket tunnels. Themes follow the app's light/dark mode, and every terminal starts in /content.
Tabbed Workspace
Seamlessly toggle between Notebook cell execution and live Terminal shell tabs inside active cloud runtimes.
Session Lifecycle Control
Instantly create, list, restart, and stop active Google Colab sessions directly from your device with smart intent routing.
Hardware Tiers
Provision CPU (always free), T4 GPU, or TPU v5e/v6e runtimes based on your Google tier limits.
Native OS File Picker & Transfers
Save downloaded files and archives anywhere on your device via the native OS File Picker without Android storage permission issues.
Folder Zip-and-Download
Archive and download entire remote directory structures (/content/folder) right to your local device with live sweeping progress bars.
Google Drive & GCP Mounts
Mount your personal Google Drive storage (/content/drive) or propagate Google Cloud credentials with real-time execution progress.
Exportable Event Logs
Maintain universal history profiles (storage/history/) and export session logs as Jupyter Notebooks (.ipynb), Markdown (.md), or plain text.
Sandbox Security
Secure OAuth2 credentials management sandboxed directly on your device storage.
Screenshots
Onboarding & Security Verification
Google Sign-In Onboarding — native auth guide for managing instances
Verification Flow — OAuth2 verification sandboxed securely on your device
Desktop Keyboard Shortcuts (F1 for the cheat sheet) — Jupyter-standard notebook shortcuts (Shift+Enter run & advance, Ctrl+Enter run in place, Alt+Enter run & insert, Ctrl+S export .ipynb), leak-free terminal combos intercepted before the PTY (Ctrl+Shift+T/W/F/L/C/V, Ctrl+Shift+1..9, zoom), and Files shortcuts (F5 refresh, Alt+Up parent, Ctrl+A select all).
React-Like Declarative UI (Flet 0.86) — The entire app is built on Flet's new functional component model (@ft.component, @ft.observable, use_state, use_effect): state mutations trigger surgical re-renders instead of full-page repaints.
Collab Shell-Branded Design System — Adaptive light and dark themes styled to the Google Colab branding palette; terminal, cards, and glass surfaces all follow the active mode automatically.
Interactive TTY Terminal Emulation — Dedicated PTY terminal engine connecting directly to Colab WebSocket endpoints (/api/terminals), with inline theme cycling, one-tap reconnect, and zoom.
Universal Storage & History Normalization — Monkey-patched backend state persistence (storage_patch.py) guaranteeing history and execution logs save reliably across Android and Linux desktops.
Native OS File Picker & Zip-and-Download — Save files anywhere on your OS/Android device without permission headaches, and archive entire cloud folders on the fly.
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.
Tested & Ruff-Compliant — pytest suite for the shortcut engine and notebook model; clean, formatted, strictly linted codebase.
Architecture
Layer
Technology
Purpose
Frontend
Flet 0.86 (declarative components)
Cross-platform React-like UI with observable state models and surgical re-renders
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
Collab Shell is designed with a strict Privacy-First philosophy:
Direct VM Connections: All commands, file accesses, and script executions are sent directly to Google Colab. No intermediate proxy.
Zero Metadata Tracking: We do not trace, log, or collect your code, file lists, or Google account credentials.
Device Sandboxing: Local settings and tokens are kept in secure application directories.
Data Sovereignty: Saved logs and exports reside 100% locally in your device Downloads folder.
Legal Disclaimer
Collab Shell 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.
About
CollabShell: Run Python, train machine learning models, and manage Jupyter runtimes on cloud GPUs and TPUs directly from your mobile phone. A fast, friendly, and powerful handheld developer workbench. Built with Flet.
