README
ยถ
GPUGo
Use Remote GPUs Like They Are Local
Explore the docs ยป
View Demo
|
Report Bug
|
Request Feature
GPUGo is the official CLI and client tool for TensorFusion GPU Go, designed to transform how you access and manage GPU resources.
It allows developers to treat remote GPUs (on servers, cloud instances, or colleagues' machines) as if they were attached to their local development environment.
Think of it as "NFS for GPUs": seamless, low-latency, and easy to manage.
๐ Highlights
- Zero Friction: Spin up a local-first studio environment with one command and get instant access to remote GPUs.
- Cost Effective: Share powerful GPU servers among multiple developers using TensorFusion's virtualization technology.
- Cross-Platform: Works on macOS (Apple Silicon or Intel), Windows (WSL), and Linux.
- Flexible Backends: Supports Docker, Colima, WSL, and Kubernetes for for studio environments.
- VS Code Integration: Full GUI management via the official extension.
๐ Quick Start
1. Register & Get Started
Register and follow dashboard instructions to get your account and access tokens.
2. Install GPUGo Agent on GPU Host
Copy the command from dashboard and run. You can see real-time onboarding progress on dashboard.
Optionally, you can run in manual way
curl -fsSL https://cdn.tensor-fusion.ai/archive/gpugo/install.sh | sh
# 1. Register the agent using the token from the Dashboard
ggo agent register -t "<token-from-dashboard>"
# 2. Start agent service
ggo agent start
4. Client Side: Use a Remote GPU
Create a Studio environment locally that is connected to the remote GPU.
# Login first, copy personal access token (PAT) from dashboard
ggo auth login
# Create a studio environment connected to a remote GPU
ggo studio create my-project -s "https://go.gpu.tf/s/share-code"
# Connect via SSH (automatically configures your ~/.ssh/config)
ggo studio ssh my-project
๐งฉ VS Code Extension (Recommended)
Prefer a GUI? The GPU Go VS Code Extension provides a beautiful interface to manage your studios, agents, and workers.
๐ Check out the VS Code Extension README
๐ฌ Community & Contact
- Discord channel: https://discord.gg/2bybv9yQNk
- Discuss anything about TensorFusion & GPUGo: Github Discussions
- Contact us with WeCom for Greater China region: ไผไธๅพฎไฟก
- Email us: support@tensor-fusion.com
- Schedule 1:1 meeting with TensorFusion founders
๐ License
This project is licensed under the Apache License 2.0 - see the LICENSE file for details.
Directories
ยถ
| Path | Synopsis |
|---|---|
|
cmd
|
|
|
ggo
command
|
|
|
ggo/cmdutil
Package cmdutil provides common utilities for CLI commands
|
Package cmdutil provides common utilities for CLI commands |
|
mock-worker
command
|
|
|
internal
|
|
|
deps
Package deps manages external dependencies for GPU Go, including downloading and managing vgpu libraries from the CDN.
|
Package deps manages external dependencies for GPU Go, including downloading and managing vgpu libraries from the CDN. |
|
errors
Package errors provides centralized error types for GPU Go.
|
Package errors provides centralized error types for GPU Go. |
|
studio
Package studio provides one-click AI development environment management across various container and VM platforms (WSL, Colima, AppleContainer, K8S, Docker).
|
Package studio provides one-click AI development environment management across various container and VM platforms (WSL, Colima, AppleContainer, K8S, Docker). |
|
tui
Package tui provides terminal UI styling and output formatting
|
Package tui provides terminal UI styling and output formatting |
|
utils
Package utils provides shared utilities for GPU Go.
|
Package utils provides shared utilities for GPU Go. |