How scarletkc/colab-playground works
Colab Playground is a desktop front end for the Google Colab CLI. A user configures accounts and session limits in the app, provisions a runtime, then monitors cost and can stop it, forward a port, or run a plugin. The graph keeps app state, core domain services, and host/CLI execution distinct. README claims establish the main capabilities; source-index references and excerpts support the internal links, but several UI and service implementations were not sampled in detail.
Main entry points: backend.rs Backend selection · ui Desktop UI · provision.rs Session provisioning · plugins.rs Plugin runtime
Components 20
Desktop app
- Desktop UI
crates/app/src/ui - App state
crates/app/src/state/mod.rs - Settings and languages
crates/app/src/settings.rs
Colab workflows
- Account management
crates/core/src/accounts.rs - Session provisioning
crates/core/src/provision.rs - Session ledger
crates/core/src/sessions.rs - Cost guards
crates/core/src/guard.rs - Usage tracking
crates/core/src/usage.rs - Port forwarding
crates/core/src/tunnel.rs - Plugin runtime
crates/core/src/plugins.rs - GGUF model plugin
plugins/llama-cpp/worker.py
Execution layer
- Backend selection
crates/core/src/backend.rs - Colab CLI adapter
crates/core/src/cli.rs - Host process runner
crates/core/src/host.rs - Data layout
crates/core/src/paths.rs - App updater
crates/core/src/updater.rs
External systems
- Google Colab CLI
- Colab runtime
- HTTP services
Other components
- User
Connections 23
- User → Desktop UI: uses
README.md - Desktop UI → App state: updates
crates/app/src/state/mod.rs - App state → Backend selection: dispatches calls
crates/app/src/state/mod.rs - Backend selection → Account management: builds service
crates/core/src/backend.rs - Backend selection → Session provisioning: builds service
crates/core/src/backend.rs - Backend selection → Session ledger: builds service
crates/core/src/backend.rs - Backend selection → Cost guards: builds service
crates/core/src/backend.rs - Backend selection → Usage tracking: builds service
crates/core/src/backend.rs - Backend selection → Port forwarding: builds service
crates/core/src/backend.rs - Backend selection → Plugin runtime: builds service
crates/core/src/backend.rs - Backend selection → App updater: builds service
crates/core/src/backend.rs - Colab CLI adapter → Host process runner: runs commands
crates/core/src/cli.rs - Host process runner → Google Colab CLI: invokes
crates/core/src/host.rs - Account management → Data layout: uses layout
crates/core/src/paths.rs - Session provisioning → Colab CLI adapter: creates sessions
crates/core/src/provision.rs - Session provisioning → Colab runtime: probes hardware
crates/core/src/provision.rs - Cost guards → Colab runtime: enforces watchdog
crates/core/src/guard.rs - Plugin runtime → Colab runtime: runs scripts
crates/core/src/plugins.rs - GGUF model plugin → HTTP services: downloads models
- Desktop UI → Settings and languages: edits preferences
README.md - Desktop UI → Port forwarding: forwards ports
README.md - Desktop UI → Plugin runtime: manages plugins
crates/app/src/ui/pages/plugins/mod.rs - App updater → HTTP services: downloads releases