Get Started

This guide takes you from a new account to a device serving inference on the ZeroGPU edge network.

Get your ZeroGPU Edge Provider credentials

Field	What to enter
App name	The name of your app
Website / store URL	Your website, store listing, or Telegram `t.me` link
Category	Productivity, Utilities, Creative, Finance, News, Lifestyle, or Gaming
Estimated monthly users	Your approximate monthly active users
Primary region	Where most of your users are
App types	The platforms you’ll integrate: Android, Browser, Chrome Extension, Telegram Mini App, macOS

Accept the terms and select Submit for approval. Your app shows as Pending Review; review usually takes 24–48 hours. Once it’s Approved, open the app in the portal to copy its SDK key.

The SDK key (zgpu-sdk-…) is for Edge Providers: it lets your app’s devices join the network. It is different from the API key (zgpu-api-…) used to call the ZeroGPU API. Don’t mix them up.

Select your platform

Pick the SDK that matches your app. Each SDK page covers requirements, setup, lifecycle, and troubleshooting.

Android

Chrome / Web

Telegram Mini Apps

macOS

Install the SDK

Android
Web
Chrome extension
Telegram Mini Apps
macOS

build.gradle.kts

dependencies {
    implementation("ai.zerogpu:android-sdk:0.3.0")
}

<script async src="https://js-sdk.zerogpu.ai/dist/loader.js"></script>

npm install @zerogpu/browser-extension-sdk
npx zerogpu init

<script async src="https://js-sdk.zerogpu.ai/dist/loader.js"></script>

npm install @zerogpu/worker

Initialize ZeroGPU

Pass your SDK key when you create the SDK. Keep it out of source control and inject it at build time.

Android
Web / Telegram
Chrome extension
macOS

val sdk = ZeroGpuSdk(
    context = applicationContext,
    operatorKey = BuildConfig.ZEROGPU_OPERATOR_KEY, // "zgpu-sdk-…"
)

<script
  async
  src="https://js-sdk.zerogpu.ai/dist/loader.js"
  edgeOperatorKey="zgpu-sdk-your-key"
></script>

offscreen.js

import { initZeroGpuOffscreen } from "./vendor/zerogpu/zerogpu-offscreen.js";

initZeroGpuOffscreen({ edgeOperatorKey: "zgpu-sdk-your-key" });

const worker = new ZeroGpuWorker({ operatorKey: ZEROGPU_OPERATOR_KEY });

Nothing to call: registration is automatic. When the SDK starts, it registers the device with the ZeroGPU device registry using your SDK key, downloads and verifies its assigned model, runs a warm-up inference, and opens a secure connection for tasks.

Start contributing compute

On Android and macOS, call start(). In browsers, Telegram Mini Apps, and Chrome extensions, the SDK starts as soon as it’s initialized with your SDK key. From then on the device receives inference tasks from the network and runs them locally; you never feed it tasks or poll it.

Confirm the device is online

SDK logs: turn on debug logging (each SDK page shows how) and look for the device registering, loading its model, and becoming ready.
Portal: check your app’s status and the Analytics page in the Edge Operator Portal. Apps serving traffic show as Active/Earning.

A connected device only receives work when the network needs it, so it may sit ready for a while before its first task.

Tell your users. Before the SDK starts, show your users the End User Disclosure from the Edge Operator Portal, word for word, with your app’s name, and get their agreement. Give them a way to turn resource sharing off.

Choose your SDK

Android

ai.zerogpu:android-sdk for Android apps.

Chrome / Web

Script tag for websites; npm package for Chrome extensions.

Telegram Mini Apps

One script tag in your Mini App.

macOS

@zerogpu/worker for Electron desktop apps.

Models

Guides

Platform

Edge Providers

Get Started

Android

Chrome / Web

Telegram Mini Apps

macOS

Choose your SDK

Android

Chrome / Web

Telegram Mini Apps

macOS

Android

Chrome / Web

Telegram Mini Apps

macOS

​Choose your SDK

Android

Chrome / Web

Telegram Mini Apps

macOS

Choose your SDK