FoxyGPU

Run local code — FastAPI backends, frontend dev servers, or anything else — on Google Colab's free-tier GPU, driven entirely from your own machine.

Install

pip install foxygpu

How it works

foxygpu launch opens FoxyGPU's own runner notebook directly in Colab — no manual notebook upload, and no GitHub account or token needed for the default path. That notebook starts a control-plane agent, reached from your machine over a Cloudflare Tunnel (no account needed). The local foxygpu CLI talks to that agent to upload your project, start it with a shell command, stream its logs, and expose whatever port it's listening on with its own public URL.

┌───────────────────┐
│    foxygpu CLI    │
│  (local machine)  │
└───────────────────┘
          │
          │  HTTPS/WSS via a Cloudflare Tunnel
          ▼
┌──────────────────────────────┐
│         foxygpu_agent        │
│    (Colab VM, GPU runtime)   │
│      spawns your process     │
│  (uvicorn / npm / anything)  │
└──────────────────────────────┘

Quickstart

foxygpu launch                     # opens Colab, no token needed
# run the cells; copy the `foxygpu connect ...` command it prints
foxygpu connect <url> --token <token>

foxygpu run ./my-app --cmd 'pip install -r requirements.txt && uvicorn main:app --host 0.0.0.0 --port $PORT' --expose

The agent picks a free port for you and injects it as $PORT — you never have to think about which ports are free. Once you know your --cmd, save it to a foxygpu.yaml and just run foxygpu deploy from then on — it also auto-detects common frameworks (FastAPI/Flask, Vite/Next.js) if you don't have one yet.

Made changes and want to update what's running? foxygpu redeploy stops the previous deployment of the same project before starting the new one.

Need to pass a database URL or API key? Use --env/--env-file — never embed secrets directly in --cmd, since that gets shown in foxygpu status and the logs.

Any language, any framework

foxygpu run/deploy just execute a shell command on the VM — Node, Go, Rust, Flask, Streamlit, a plain training script, anything the Colab VM can run works, not just Python or FastAPI.

Full documentation

The GitHub README has the complete command reference, a full working example (a real GPU-backed Ollama chat app), known limitations, and contributor docs.

Project links

Data verified by PyPI on Aug 31, 2026
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Latest release

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for shamshadz from gravatar.com shamshadz

Credits

Author: Shamshad Choudhary

GitHub Statistics

Data verified by PyPI on Aug 31, 2026
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

License expression

MIT
View SPDX License List

Requires

Python >=3.9

Provides Extra

dev

Tags

colab gpu ollama deployment cli fastapi

Classifiers

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

foxygpu-0.2.1.tar.gz (33.0 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

foxygpu-0.2.1-py3-none-any.whl (23.1 kB view details)

Uploaded Python 3

File details

Details for the file foxygpu-0.2.1.tar.gz.

File metadata

  • Download URL: foxygpu-0.2.1.tar.gz
  • Upload date:
  • Size: 33.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for foxygpu-0.2.1.tar.gz
Algorithm Hash digest
SHA256 e33ed15a1a273c0e953bd1e5f2bf02fb7100061db040e803d73073bae6e25858
MD5 47ce934775e0ca0a7b2141913a36afc4
BLAKE2b-256 08d48acfe7bb167c4dce8906c548188d9a67188864828b070cead6003469f6b9

See more details on using hashes here.

Provenance

The following attestation bundles were made for foxygpu-0.2.1.tar.gz:

Publisher: publish.yml on Shamshadz/FoxyGPU

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file foxygpu-0.2.1-py3-none-any.whl.

File metadata

  • Download URL: foxygpu-0.2.1-py3-none-any.whl
  • Upload date:
  • Size: 23.1 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for foxygpu-0.2.1-py3-none-any.whl
Algorithm Hash digest
SHA256 18cd928873d58aa55775e995d210d336678648b91b7d86206bbe2da0d574b694
MD5 d9cdcd25bf0cae8d453f02ff81a88862
BLAKE2b-256 440aa65c57f559d65670c47aa1e13e5c5c278551c8361ef5aa449a3421e779d8

See more details on using hashes here.

Provenance

The following attestation bundles were made for foxygpu-0.2.1-py3-none-any.whl:

Publisher: publish.yml on Shamshadz/FoxyGPU

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

This release

0.2.1 This release

2 files

0.2.0

2 files

0.1.0

2 files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page