AI Development

    SN22 Embedding Tasks: How GPU Miners Join | Desearch

    By Desearch Team6 min read

    Embedding tasks are part of SN22 main: GPU miners turn the pages the network crawls into vectors with Desearch-Embedding-4B, validators recompute a sample to check the work, and that verified work is what makes the Desearch index searchable.

    If you already know the model and the crawl and embed loop from Desearch 2.0, this post is the practical part. It covers what an embed task is, what you need, the two steps to join, and how checks and rewards work. Everything here comes from the public subnet-22 PR #391.

    How a crawled page becomes searchable

    Crawl miners fetch pages. Embed miners turn the text of those pages into vectors. Validators embed a sample again and compare. Vectors that hold up are what the search index is built from. Crawling gives the network pages; embedding is what lets a query find the right ones. For background on how Desearch builds a web index on Bittensor, start there.

    What an embed task is

    A task is a batch of crawled page texts. You run the model on your own GPU and send back one vector per text, in the same order. Validators pick a sample of your uploads, embed the same texts again and check that the results match yours.

    What you need

    Step 1: Start the model server

    From the PR #391 instructions:

    BASH
    vllm serve desearch/Desearch-Embedding-4B --revision 12e5c6910d49dd5534e8a77a6fa7d8a057bd534a \
      --served-model-name desearch-4b-v1 --runner pooling --dtype float16 \
      --no-enable-chunked-prefill --max-num-batched-tokens 16384 --port 8000

    Run it exactly as given. A different precision, quantized weights or another revision give different vectors, and those fail the check.

    Step 2: Start the embed miner

    BASH
    pm2 start python3 --name desearch_embed_miner -- -m neurons.miners.embed

    Settings are in neurons/miners/.env:

    • EMBED_MODEL, by default desearch-4b-v1
    • EMBED_API_URL, your model server, by default http://127.0.0.1:8000/v1/embeddings
    • EMBED_API_KEY, only if your server needs one

    The miner waits for the server before it claims any task.

    Already crawling? Nothing changes

    Crawl miners need no changes. One hotkey can crawl, embed or both. Run the embed miner next to your crawl miner under the same hotkey, or on its own. Crawling and embedding keep separate budgets and lockouts, so a problem in one does not touch the other.

    How the check and rewards work

    Validators check a sample of each miner's uploads. A passing task, and every task not picked for a check, is paid by the characters it embedded. A failed check earns nothing and takes back what you were paid since your last passed check. So the simplest way to earn steadily is to run the server exactly as given and keep it healthy.

    On emission, PR #391 puts it this way: "50% is burned, 20% goes to crawl miners and 30% to embed miners." For more on how SN22 rewards work in general, see how developers earn on Desearch and the scoring and incentives guide.

    For validators

    Validators update themselves. To check embed work, a validator either runs the same model server on its own GPU and sets EMBED_API_URL in neurons/validators/.env, or falls back to Desearch's temporary model server through the task API. Either way the check is the same.

    FAQ

    Do crawl miners need to change anything?

    No. Crawl miners need no changes.

    Can one hotkey crawl and embed?

    Yes. One hotkey can crawl, embed or both, and each keeps its own budget.

    What GPU do I need?

    An NVIDIA GPU with 16 GB of memory or more. 24 GB is recommended.

    Which model do embed miners run?

    Desearch-Embedding-4B, open on Hugging Face.

    How are embed miners rewarded?

    By the characters they embed, for tasks that pass a validator check or are not picked for one. A failed check takes back pay since the last passed check.

    What if a validator has no GPU?

    It falls back to Desearch's temporary model server through the task API.

    Search the index SN22 builds

    The pages miners crawl and embed feed the index behind Desearch. You can run AI Search on web and X from the Desearch Console today.

    Try AI Search in the Desearch Console

    Put your next idea to work.

    Try a query in the playground, then use the docs to bring Desearch into your application.

    Browse more articles