API & usage

Explorer

Become a miner

// minerai-1 · open-source AI for developers

What are we building?

Open-source AI for developers, running on community GPUs.

Answers come from independent miners and can be wrong. Never paste secrets.

// mine · earn $MINERAI

Your graphics card runs the AI. You earn $MINERAI.

Every answer on minerai is written by a community GPU. 80% of what users pay goes to the miner who answered it, paid out every day.

// 02 · how much of your GPU 

            

              Paste it in PowerShell, press Enter.
              
            

            
Then your miner lights up on the . Next time, just type minerai mine.

          

        


        

        

          
80%of every answer's price goes to its miner, in $MINERAI, paid daily.

          
2× · 3×Bigger cards unlock bigger models, which pay more per answer. The miner installs them by itself.

          
8 GB+Any NVIDIA, AMD or Apple GPU with 8 GB or more. 

        


        

          

            
// 01 · architecture

            
How a miner works

            
The miner is a small open-source Node.js program that drives a local inference engine (Ollama, or any OpenAI-compatible server such as llama.cpp or LM Studio). It opens one outbound WebSocket to the router: no port to open, no public IP.

            
user ── HTTPS ──▶ router ── WebSocket ──▶ miner ──▶ Ollama · GPU
                              ◀──── tokens, streamed ────────┘

            
    
              
  1. Handshake. The router sends a nonce; the miner signs it with its ed25519 identity (~/.minerai/identity.json) and names the wallet that receives its rewards.
    2. 
              
  2. Probation. Its first answers are questions the router can check (arithmetic, facts). One pass and it serves users.
    3. 
              
  3. Jobs. Each question is streamed to one miner, chosen at random among the free ones and weighted by reputation.
    4. 
              
  4. Checks. Canaries keep coming at random times, on every model the miner claims. Wrong answers lower reputation; at zero the miner is banned and loses its unpaid earnings.
    5. 
              
  5. Receipts. Every job gets a receipt signed by the router: miner, wallet, model, token counts.
    6. 
            

          


          

            
// 02 · requirements

            
Hardware and models

            
The miner installs every unlocked model your GPU memory can hold, in the background, and serves them all. Bigger models pay more per answer.

            

              
ModelSizeGPU memoryPaysStatus

              
            

            
Also needed: Windows 10+, macOS 13+ or Linux · about 6 GB of disk for minerai-1 (more for bigger models) · a stable connection. Apple Silicon counts its unified memory.

          


          

            
// 03 · earnings

            
What you earn

            

              
RuleValue

              
                
Your share80% of the $MINERAI each answer you serve costs the user (10% is burned, 10% goes to the treasury)

                
Price of an answer$0.001 per 1,000 generated tokens, paid in $MINERAI at the live price

                
Hold24 hours, so cheating can be caught before tokens move

                
PayoutAutomatic, every day at 12:00 UTC, from 100 $MINERAI owed, to your wallet

                
ProofEvery payout is a Solana transaction you can open; the totals are public at /api/transparency

              
            

          


          

            
// 04 · commands

            
The minerai command

            

              
CommandWhat it does

              
                
minerai mineStarts mining with the saved wallet (asks for it the first time). Ctrl+C stops and frees the GPU at once

                
minerai mine <wallet>Mines for another wallet

                
minerai updateGets the latest version. The miner also updates itself between answers

                
minerai modelsThe models unlocked on the network

                
mineraiThe AI agent in your terminal, paid from your balance

              
            

            
Advanced: MINERAI_CONCURRENCY=2 serves two answers at once on a big card; MINERAI_BACKEND_URL points the miner at another engine (llama.cpp, LM Studio). Settings live in ~/.minerai/.

          


          

            
// 05 · security

            
What the miner can and can't do

            
    
              
  • It never holds a private key of your wallet: only its public address, where rewards are sent.
    • 
              
  • Its identity key only signs the handshake; it can't move funds.
    • 
              
  • It only receives the prompt of the job it is serving, and never sees accounts, keys or payments.
    • 
              
  • The code is open source, and the installer is plain text you can read before running it.
    • 
            

            
Full mining guide in the docs →

          

        

      

    


    
    

      

        

          
// admin · operator only

          
Launch $MINERAI

          
Check what's ready, launch the coin (or paste its address), and it's linked everywhere at once: prices, payments, payouts, burns, buybacks, staking, the website and the docs.

        

        

          
The admin needs your admin wallet signed in and the admin password.

          

            
            
          

          

        

        
      

    


    
    

      

        

          
// explorer · launched with minerai

          
Coins launched with minerai

          
Every coin here was created from the minerai app, and its launch was checked on Solana. Live data from pump.fun. Anyone can launch a coin: this is not investment advice.

          

            

            
            
          

        

        

      

    


    
    

      

        

          
// api · openai-compatible

          
Use minerai in your own apps

          
Point any OpenAI client at minerai, keep your code, pay in $MINERAI. Every request is served by a community GPU.

        


        

          

            

              
minerai in your terminal

              
An AI agent in any project folder: it reads your code, writes files and runs commands, and always asks before changing anything. The same command mines. It updates itself.

            

          

          

            

              

                
                
              

              
            

            
            

          

          
    
            
  1. minerai loginpaste your API key from the card below
    2. 
            
  2. mineraiopen the agent in any project folder
    3. 
            
  3. minerai mineearn $MINERAI with your graphics card
    4. 
          

        


        

          

            

              
Your API key

              
Anyone with this key can spend your $MINERAI balance. Keep it on your server, never in front-end code.

            

          

          

            mk_••••••••••••••••••••••••••••••
            
            
            
          

          

            
Base URL

            
Model
minerai-1

          

        


        

          

            

              
Wallet

              
Link a Solana wallet to pay with its $MINERAI, sign in on other devices, and see your miner earnings.

            

            
          

          
          
          
How deposits, payouts and custody work, in detail: Wallets, credits and miner payouts.

        


        

          
Balance…$MINERAI

          
Spent today…$MINERAI

          
Requests today…chat + API

          
Tokens today…in + out

        


        

          

            
Quickstart

            

          

          

            
bash

            

          

          
Add "web_search": true to let the router search the web for fresh answers. Responses include a minerai object with the request's cost and your remaining balance, in $MINERAI.

        


        

          

            
Pricing

            
    
              
  • 1,000 output tokens1 $MINERAI
    • 
              
  • 1,000 input tokens0.25 $MINERAI
    • 
              
  • Connector call (web, Solana, market, GitHub, page)0.5 $MINERAI
    • 
              
  • Holders of 1M $MINERAI20% off
    • 
            

            
Prices are fixed in dollars and paid in $MINERAI at the one-hour average price. Of what you spend: 80% to the miners, 10% burned, 10% to the treasury.

          

          

            
Limits

            
    
              
  • Requests per minute20
    • 
              
  • Parallel requests2
    • 
              
  • Max output tokens4,096
    • 
              
  • Max prompt32k characters
    • 
            

            
Limits grow with the network. Need more? Run a miner, you'll help everyone.

          

        


        

          
Recent usage

          

            

              
TimeSourceInputOutputToolsCost

              
            

          

        

      

    

  


  






  

    
The model grows with the network

    
  

  
Every minerai model runs on community machines. Each step needs the whole network below it, plus enough machines big enough for its model. More miners, smarter AI.

  
  

    
    

    
  

  

  

    
Each step runs the best open-source model of its size when it unlocks, tuned for minerai. Smaller models stay available. Bigger ones will cost more $MINERAI, announced before they go live.

    
  




  

    
Become a miner

    
  

  
Your graphics card runs minerai-1 for the network, and you earn 80% of the $MINERAI paid for every answer it serves. One command sets everything up.

  
  

  
  

    

      

        
        
      

      
    

    
    

  

  
It installs the minerai command (and Node.js and Ollama if they are missing), downloads minerai-1 (about 5 GB, only once), then starts mining. Next time, just type minerai mine. The miner updates itself, and when a bigger model unlocks it installs it on its own if your card can run it, which pays more per answer. No port to open, no private key: only your public address. Your first answers are checked before you receive real questions.

  

    

      // works · 8 GB of GPU memory or more
      
    
        
  • NVIDIA GeForce GTX 10 and 16, RTX 20, 30, 40, 50 series
    • 
        
  • NVIDIA RTX and Quadro workstation cards
    • 
        
  • AMD Radeon RX 6800, 6900, 6950 and RX 7000 series
    • 
        
  • Apple M1, M2, M3, M4 Macs with 16 GB of memory
    • 
      

    

    

      // doesn't work
      
    
        
  • Cards under 8 GB: GTX 1650, GTX 1060, RTX 2060, 4–6 GB laptop GPUs
    • 
        
  • Intel graphics, integrated or Arc
    • 
        
  • AMD Radeon RX 6700 and older on Windows
    • 
        
  • Intel Macs, Macs with 8 GB, computers without a GPU
    • 
      

    

  

  Read the full mining guide: earnings, checks, stopping the miner →



  

    
Invite & earn

    
  

  

  

  

    
0friends joined

    
0$MINERAI earned

  

  
Paid with the miners' daily payout, to your wallet. Friends pay nothing more: your share comes from the treasury's part.




  

    
Connect your terminal

    
  

  

    
>_minerai

    
Check that this code is the one shown in your terminal:

    
    
Your terminal gets its own API key and spends your $MINERAI balance, like the website. You can remove it anytime in API & usage.

    
    

  

  



  

    
Post on X

    
  

  

  
  




  

    
Connect a wallet

    
  

  
You'll sign a short text message. It proves the wallet is yours, costs nothing and cannot move funds. If your wallet asks you to approve a transaction here, stop: it isn't us.

  

  

    

      
      
minerai walletCreated in this browser, encrypted with your password. We never see it.

    

    

      
      
      
    

    
    
  

  




  

    
The network, live

    
  

  

    
    live network
    – tok/s
    
    
    

      
–miners online

      
–answers served

      
–tokens generated

      
–$MINERAI earned by miners

    

  


  
Questions go from people to the router, which sends each one to a community GPU (white). The answer comes back (orange), and the miner gets paid (gold). 







  

    
Your $MINERAI

    
  

  

    Balance
    –
    
  

  

    
    
  

  

  

    
Your balance is $MINERAI: deposit tokens and spend them on AI calls. Deposits open when the token launches.

    
You can already link your wallet so everything is ready. The $MINERAI you spend on AI calls goes to the miners who answer them.