Skip to content

Connect your runtime

CrackedAI runs your code on your own machine, not in the cloud. Set the runtime up in one command.

Checking for your runtime…
1

Install

pipx install crackedai-connect

Works on macOS, Linux, and Windows. Requires Python 3.12+. No pipx? Use uv tool install crackedai-connect, or pip install crackedai-connect inside a virtualenv you have activated. A bare pip install into a Homebrew or system Python is refused by the OS, not by us.

2

Run

crackedai-connect

On first run it asks which modes you want and installs only those. PyTorch and JAX are the multi-gigabyte ones; typed Python needs mypy and a Python you already have, and Rust and C++ need a compiler rather than a download from us.

Already installed, and want to add a mode later? Run crackedai-connect --toolchains rust (or python, cpp, pytorch, jax — comma-separated for several). It is a one-time download per mode.

3

Solve

Come back here and start solving problems. The website automatically detects the running runtime.

Browse problems

What gets installed

NVIDIA GPU

PyTorch with CUDA + JAX with CUDA. Auto-detects your CUDA version (11, 12, or 13).

Apple Silicon

PyTorch with MPS acceleration + JAX. Uses your M-series GPU automatically.

CPU Only

Lightweight CPU-only PyTorch (smaller download) + JAX. Everything works, just no GPU acceleration.

FAQ

I already have PyTorch/JAX installed

On first run, crackedai-connect installs hardware-matched versions. After that, it uses whatever is installed. Delete ~/.crackedai/setup_done to force reinstall.

On a phone or tablet? Use a computer you already own

The runtime is a desktop program, so there is nothing to install here. Instead, link a computer that has it running and your phone can send code there to be run. Your laptop does the work, and the results come back.

  1. 1. On the computer, install the runtime as below and get a code from Settings .
  2. 2. Run crackedai-connect --link CODE there, then start it normally.
  3. 3. Come back here on your phone. Run and Submit will name that machine.

Needs crackedai-connect 0.8.5 or newer. The computer has to be awake with the runtime running, though it does not need a browser open.

You're on Safari, and it can't reach the runtime. Safari is the only browser that blocks a secure page from talking to a program running on your own machine, so the runtime is invisible to it no matter how it's installed, and nothing below will fix that. Open crackedaicode.com in Chrome, Edge, Firefox or Arc instead; everything else on this page still applies once you do.

It says "Listening" but this site can't see it

Almost always a browser permission, not your setup. Chrome 142 and newer ask before any website may reach a program running on your own machine. The prompt says something like "Look for and connect to any device on your local network." Choose Allow. If you dismissed it or clicked Block, the site is stuck: reload the page to get the prompt back, or click the icon just left of the address bar, open the site's permission settings, and allow local network access.

Also make sure you're on crackedai-connect 0.8.3 or newer. Run pipx upgrade crackedai-connect , or pip install -U crackedai-connect for a pip install. Older runtimes refused the check that Chrome versions before 142 use, for an unrelated reason. After upgrading, stop the runtime with Ctrl+C and start it again. Upgrading the package does not change the copy already running.

On Safari, try a Chromium-based browser (Chrome, Edge, Arc, Brave) if it still won't connect. Safari is stricter than other browsers about a secure page talking to your own machine, and we've seen setups that work everywhere else fail there.

To confirm the runtime itself is fine, open http://127.0.0.1:52341/health in a tab. If that shows a block of JSON, the runtime is working perfectly and the problem is only the browser permission above.

Is my code sent to a server?

No. Code executes entirely on your machine. The browser talks directly to localhost. The web server is never involved in code execution.

What does Python mode need?

crackedai-connect 0.4.0 or newer. Python-mode submissions are graded on mypy --strict as well as on the tests, and older runtimes can't type-check. Upgrade with pip install -U crackedai-connect.

What does Rust mode need?

crackedai-connect 0.5.0 or newer, plus a Rust toolchain on your PATH. rustup.rs installs one. Rust code is compiled locally, so without rustc it can't run at all. Submissions are additionally graded on clippy -D warnings; clippy ships with rustup but isn't installed by default, so add it with rustup component add clippy.

What does C++ mode need?

crackedai-connect 0.8.0 or newer, plus a C++ compiler on your PATH. macOS: xcode-select --install. Debian/Ubuntu: apt install g++ clang-tidy. Windows: install the Visual Studio Build Tools, or use WSL. C++ code is compiled on your machine, so without a compiler it can't run at all. Submissions are additionally graded on clang-tidy, which ships with LLVM (brew install llvm on macOS) and is a separate package on most Linux distributions.

Can I use a virtual environment?

Yes. Install crackedai-connect in any venv, conda env, or pixi env. It will install frameworks into whatever environment it's running in.