❓Fast Worker FAQ

Have a question that isn't on this list? We're always updating the FAQ, just give us a ping on one of the channels listed at the bottom of the page 🤙

How do I access my Fast Worker earnings?

Unlike the Relaxed Worker network which automatically sends token earnings to the Sogni Account directly, with the Fast Worker you must Claim Worker Earnings periodically. Proceed to dashboard.sogni.ai to do so.

How can I tell if my Fast Worker is connected and working?

You can view real-time performance and debugging analytics for your worker using the Fast Worker analytics dashboard at nft.sogni.ai/analytics This dashboard gives a real-time view of what your Fast Worker is actively working on down to the phase and step of each job. If the worker has stopped processing jobs due to a configured cooldown or penalty it will be outlined here.

It also shows daily and lifetime views of all earnings and performance analytics. If your worker has experienced any connection errors and job failures they are also reported here for debugging.

My GPU isn't on the list, when will you support it?

The Sogni Fast Supernet strives to provide super fast and reliable render times (often less than <5 seconds) to artist no matter if returning a single image job or a batch of 16 images. This unique parallel processing capability is only as fast as the slowest worker in the batch. So in the current testnet phase we are restricting the Fast Supernet to these, top of the line but very popular, residential and enterprise Nvidia GPUs.

In the future we will be releasing new worker job types and Supernet speed tiers which will allow us to accommodate more GPUs. Our end goal is to allow all GPUs to participate.

How do I get the Fast Worker Prospect NFT and API Key?

You just need to go to nft.sogni.ai and login with your Sogni account to acquire the free Fast Worker Prospect NFT. You'll find these available in the "NFT Collections Explorer" tab under the Available filter. Batches of new NFTs are released at an interval but get snapped up quick. So we have produced the Sogni Fast Worker Prospect NFT Request form where you can request one directly get sent to the Base Sepola Testnet wallet associated with your free Sogni account. Once you have the NFT you can download the Fast Worker installer for your OS and follow the steps to configure your worker. During this process you'll be instructed to go back to nft.sogni.ai to create your API Key from the "My NFTs" tab.

Please note that you can use the same API Key for different Fast Workers running from the same Sogni account but you will need a different NFT_TOKEN_ID supplied for each Fast Worker. Ths is because the Supernet needs to know which NFT under the address to pull and build reputation against for your worker. If you try to run multiple Fast Workers using the same NFT you will find they keep knocking each other off the network during authentication.

Can I run more than one Fast Worker?

Yes you can run as many as you have the GPUs to allocate for so long as there are still unclaimed Fast Worker Prospect NFTs available to mint are made available in batches that help ensure the supply of workers can go up in-line with platform demand. This helps ensure maximum job rates (and token rewards) for the number of GPUs on the network.

You can even run multiple Fast Workers from the same Sogni Account. Just make sure all Fast Worker NFTs are moved to that account's wallet address. You should then use the same API Key generated at nft.sogni.ai through one of these NFTs for every worker configuration. Currently a single API Key is generated for each entire Sogni account and regenerating it will remove the previous API Key.

Can I run multiple Fast Worker instances from one machine that has multiple GPUs?

Yep this is supported though each Fast Worker must be configured with it's own NFT TOKEN ID even when running from one machine. You must also have a minimum of 30gb of ram for EACH instance of Fast Worker you are running. See details in Advanced Configuration. Please make sure all Fast Worker NFTs are moved to that account's wallet address. You should then use the same API Key generated at nft.sogni.ai through one of these NFTs for every worker configuration. Currently a single API Key is generated for each entire Sogni account and regenerating it will remove the previous API Key.

The site nft.sogni.ai is not letting me mint more than 1 Fast Worker Prospect NFT ?

Site restrictions currently only allow Sogni accounts to mint an NFT if the address is not already holding one to prevent hoarding while minting is free during Testnet. However you can set up a new Sogni account for each worker, even using the same email address .

How does the Leaderboard and airdrop rewards work?

The Fast Worker Leaderboard is a live ranking based on how many tokens were earned by the NFT used to log in. Tokens are earned by completing AI inference jobs on Sogni's Fast Supernet. Job analytics and reputation are tied to the NFT—not the Sogni account or wallet address—for the purposes of this leaderboard.

This means that if you're running multiple Fast Workers, even from the same Sogni account, each one will have its own separate entry on the leaderboard.

Once claimed, a SOGNI token airdrop will be distributed to your account, with exponentially higher rewards for higher leaderboard positions.

Can I run both Relaxed / Mac Worker(s) and Fast Worker(s)?

Yes. There was previously a restriction Testnet but this is now fully supported.

Can I switch my worker from Stable Diffusion to Flux and vice versa without reinstalling everything?

Yep! Just re-run the installer script. It will detect that you have already completed setup and only ask you to pick which worker image you want to switch to. All models are cached locally in the /data-models/ folder so you won't have to redownload anything. You can delete that folder at any time to save space. Worker analytics stays with the NFT so you could even switch machines and keep your spot on the leaderboard.

How can I update my workers to the latest version of the Fast Worker software?

Sogni Fast Worker is designed to automatically check and pull the latest worker image from Docker Hub every time it starts and at a periodic interval when it is running so you normally don't need to do anything. To expedite an update you can simply stop and start your worker again to trigger the update check. To ensure the auto-update works as expected you can make sure in your docker-compose.yml file that you have: sogni/sogni-flux-worker:latest for Flux or sogni/sogni-stable-diffusion-worker:latest for Stable Diffusion.

This means the worker will always check for the latest latest tagged Docker Image and pull it if it is newer than what is currently loaded. This check is enabled by default via the pull_policy: always line in the docker-compose.yml file. Note that if you're running Fast Worker on a 3rd party DePIN provider like Salad.com which does not use a docker-compose configuration file and / or caches the docker image local to their network, you may need to occasionally manually "refresh" the docker image being pulled. You can do this by simply clicking "Edit" on the Container Image Source URL and re-entering the same path that was previously there and submitting the change to the platform. The service should automatically pull and cache the latest version of the "latest" tagged docker image and redeploy it.

My Fast Worker won't auto-update and got disconnected for running an unsupported version, how do I fix it?

Sogni occasionally pushes important Docker Worker Image updates. In any case where these updates are required, the minimum worker image version to connect to the socket service is incremented and you may get a worker disconnected error like Stable Diffusion Worker v0.2.16 is no longer supported, restarting to upgrade to 0.2.17. Normaly the Health Probe service that is bundled with your worker should restart it and pull the latest image, and reconnect without you having to do anything.

If you do run into an issue, here are troubleshooting steps: First go to nft.sogni.ai/analytics and click on "My GPU Worker Stats" to access a user-friendly analytics and debug dashboard for your worker. Here you can confirm the Worker Version you are running and if you received any "Last Worker Kick" error messages. If you this error but the version of the worker displayed is higher, and your worker is still connected to the network, you are good to go! If your worker is showing as offline with the "no longer supported" error you may need to manually restart it or update it. Here are the steps: Scenario A: You are running the Fast Worker directly 1. Verify the docker image paths are set correctly in your docker-compose.yaml file: Open the docker-compose.yaml file in your install directory and make sure it includes For Sogni Fast Worker Stable Diffusion: image: sogni/sogni-stable-diffusion-worker:latest For Sogni Fast Worker Flux: image: sogni/sogni-flux-worker:latest 2. Restart the worker

Run ./worker-stop.sh and ./worker-start.sh on Linux or ./worker-stop.bat and ./worker-start.bat on Windows 3. Re-check the worker status You can go to nft.sogni.ai/analytics or run the local debugger script to get a log of any errors encountered: Run ./worker-debug.sh on Linux or double click ./worker-debug.bat on Windows. Scenario B: You are running the Fast Worker on a 3rd Party DePIN Network You should first try removing and re-adding the Docker Image path above. If this doesn't work you can also replace the ":latest" tag above with the actual latest numeric version of the worker image as listed on our public Docker Hub pages for our Stable Diffusion worker and Flux worker. We have a convenient REST API endpoint which also return the latest Stable Diffusion and Flux version image paths. If you manually replace :latest with a version like :23 keep in mind that you'll need to manually update it again each time the required min version changes. This often does not change for weeks or months but can change at any time.

Can I use my computer while running Fast Worker?

Casual use of your computer while running Fast Worker is completely fine, however if you use any applications or games that may leverage your graphics card it may cause your worker's performance to drop. If your machine is too bogged down to perform jobs quickly it will be significantly deprioritzed in the system to where it will get less jobs. So if you plan on using your computer for anythign intensive, it's best to shut down Fast Worker and turn it back on after you are done.

Can I transfer my Fast Worker Prospect to another account?

Yes, that is fully supported and allowed. You can even transfer the NFT for free between accounts through the transfer form under My NFTs at nft.sogni.ai Just note that when you transfer a Fast Worker NFT the jobs analytics and history, and leaderboard ranks are attached to the NFT and not to the Sogni account address. So if you transfer the NFT to another account, that account will take over the displayed username, addresss, rank and score in terms of Fast Worker Leaderboard.

Does becoming a Fast Worker give me extra priority in the Artist job queue?

Yes! Sogni Accounts that have run a Relaxed or Fast Worker get special priority on the Supernet when requesting their own jobs in Artist mode. This benefit kicks in for the first 500 images you request each day as an Artist.

How do I download all the models to my Fast Worker ahead of time?

The Fast Worker comes bundled with 1 model and downloads new models at runtime automatically as there is demand on the network. This means you normally don't have to change any settings. You can tweak these settings and also auto-download more models more quickly using the Advanced Configuration guide however.

Are there any restrictions on what regions can host and earn using a worker node?

The platform officially supports connections from over 240+ countries but due to certain international regulations we are required to block certain regions from participation. This is a non-exhaustive list of countries currently geo-blocked: Cuba, Iran, North Korea, Syria, Russia Our DePIN partners have updated their Sogni Fast Worker templates so that provisioning a 3rd party worker GPU node for the platform will bypass worker provisioning from this list.

If you are leveraging a DePIN rental platform that is not Salad or Nosana you can supply this list of approved countries in any geo-filter configuration provided by that platform to avoid provisioning churn getting a worker node online. These are ISO 3166-1 alpha-2 country codes:

af, al, dz, as, ad, ao, ai, aq, ag, ar, am, aw, au, at, az, bs, bh, bd, bb, be, bz, bj, bm, bt, bo, bq, ba, bw, bv, br, io, bn, bg, bf, bi, cv, kh, cm, ca, ky, cf, td, cl, cn, cx, cc, co, km, cd, cg, ck, cr, hr, cw, cy, cz, ci, dk, dj, dm, do, ec, eg, sv, gq, er, ee, sz, et, fk, fo, fj, fi, fr, gf, pf, tf, ga, gm, ge, de, gh, gi, gr, gl, gd, gp, gu, gt, gg, gn, gw, gy, ht, hm, va, hn, hk, hu, is, in, id, iq, ie, im, il, it, jm, jp, je, jo, kz, ke, ki, kr, kw, kg, la, lv, lb, ls, lr, ly, li, lt, lu, mo, mg, mw, my, mv, ml, mt, mh, mq, mr, mu, yt, mx, fm, md, mc, mn, me, ms, ma, mz, mm, na, nr, np, nl, nc, nz, ni, ne, ng, nu, nf, mp, no, om, pk, pw, ps, pa, pg, py, pe, ph, pn, pl, pt, pr, qa, mk, ro, rw, re, bl, sh, kn, lc, mf, pm, vc, ws, sm, st, sa, sn, rs, sc, sl, sg, sx, sk, si, sb, so, za, gs, ss, es, lk, sd, sr, sj, se, ch, tw, tj, tz, th, tl, tg, tk, to, tt, tn, tr, tm, tc, tv, ug, ua, ae, gb, um, us, uy, uz, vu, ve, vn, vg, vi, wf, eh, ye, zm, zw, ax