Skip to main content

🚀 Panduan Setup Node

Panduan ini ditulis khusus untuk mahasiswa yang baru pertama kali setup environment blockchain/AI. Ikuti langkah-langkah sesuai sistem operasi (OS) yang kamu gunakan.

Belum Pernah Pakai Terminal?

Jangan khawatir! Panduan ini akan menjelaskan setiap langkah secara detail. Terminal (atau Command Prompt/PowerShell di Windows) adalah aplikasi untuk menjalankan perintah teks. Kamu cukup copy-paste perintah yang diberikan.

Prasyarat Sistem​

Minimum Requirements​

KomponenMinimumRekomendasiCatatan
OSWindows 10/11 (WSL 2), macOS 12+, Ubuntu 20.04Windows 11 (WSL 2), macOS 14+, Ubuntu 22.04Windows memerlukan WSL 2
Python3.93.10 atau 3.11btcli mendukung Python 3.9-3.12
RAM8 GB16 GB+Cek di System Info / About This Mac
Storage50 GB SSD kosong100 GB+ NVMe SSDUntuk model AI dan dependencies
Internet20 Mbps50 Mbps+Stabil, hindari WiFi publik untuk mining
Ports8091 (axon)—Perlu dibuka di firewall
GPU Tidak Diperlukan untuk Co-Learning Camp

Panduan ini menggunakan bittensor-subnet-template yang hanya memerlukan CPU. Untuk subnet produksi yang membutuhkan GPU NVIDIA, lihat Modul 5: Perencanaan Hardware.

Cara Cek Spesifikasi Komputer​

1. Tekan tombol Windows + I → buka Settings
2. System → About
3. Lihat: Processor (CPU), Installed RAM, System type (64-bit)

Langkah 1: Install Python​

Python adalah bahasa pemrograman yang digunakan Bittensor. Kamu wajib install Python sebelum melanjutkan.

Opsi A: Download dari python.org (Paling Mudah)​

  1. Buka python.org/downloads
  2. Download Python 3.11.x (klik tombol kuning besar)
  3. Jalankan installer yang sudah didownload
  4. PENTING: Centang ✅ "Add python.exe to PATH" di bagian bawah installer
  5. Klik "Install Now"
  6. Tunggu hingga selesai, klik "Close"
Jangan Lupa Centang "Add to PATH"!

Jika lupa mencentang opsi ini, Python tidak akan dikenali di terminal. Kamu harus uninstall dan install ulang dengan opsi ini dicentang.

Opsi B: Install via Microsoft Store​

  1. Buka Microsoft Store
  2. Cari "Python 3.11"
  3. Klik "Get" / "Install"

Verifikasi Instalasi​

Buka Command Prompt (tekan Windows + R, ketik cmd, tekan Enter):

python --version

Output yang diharapkan:

Python 3.11.x

Jika muncul python is not recognized, coba:

python3 --version

Jika masih error, restart komputer dulu. Jika masih error setelah restart, Python belum benar terinstall — ulangi langkah di atas.

Cek juga pip (package manager Python):

pip --version

Output yang diharapkan:

pip 23.x.x from ... (python 3.11)

Langkah 2: Install Git​

Git adalah version control system yang dibutuhkan untuk mengunduh kode subnet.

  1. Buka git-scm.com/download/win
  2. Download installer (pilih 64-bit Git for Windows Setup)
  3. Jalankan installer:
    • Klik Next untuk semua opsi default
    • Pada "Adjusting your PATH environment", pilih "Git from the command line and also from 3rd-party software" (opsi tengah, biasanya sudah terpilih)
    • Klik Next hingga selesai → Install → Finish

Verifikasi​

Buka Command Prompt baru (tutup yang lama, buka baru):

git --version

Output yang diharapkan:

git version 2.x.x.windows.x

Langkah 3: Install btcli & Bittensor SDK​

Di ekosistem Bittensor ada 2 package utama yang perlu kamu ketahui:

PackageInstall CommandFungsi
btcli (Bittensor CLI)pip install bittensor-cliTool command-line untuk wallet, staking, registrasi, dan interaksi dengan jaringan
Bittensor SDKpip install "bittensor<10.0.0"Library Python untuk membangun miner dan validator kustom
Referensi Resmi

Panduan ini mengikuti dokumentasi resmi Bittensor. Selalu cek halaman tersebut untuk update terbaru.

Apa itu Virtual Environment?​

Virtual environment (lingkungan virtual) adalah folder terisolasi yang berisi Python dan package-nya sendiri. Ini penting agar dependencies Bittensor tidak konflik dengan project Python lain di komputermu.

📁 Komputer kamu
├── 📁 bittensor-env/          ← Virtual environment (Python + btcli + SDK)
│   ├── 📁 bin/ (atau Scripts/)
│   ├── 📁 lib/
│   └── 📁 include/
├── 📁 project-kuliah/         ← Project lain tidak terpengaruh
└── 📁 skripsi/                ← Project lain tidak terpengaruh
Windows Memerlukan WSL 2

Menurut dokumentasi resmi Bittensor, Windows memerlukan WSL 2 (Windows Subsystem for Linux) dengan distribusi Ubuntu. Operasi mining dan validating tidak didukung di Windows native.

4a. Install WSL 2 (Jika Belum Ada)​

Buka PowerShell sebagai Administrator (klik kanan → "Run as administrator"):

wsl --install

Ini akan menginstall WSL 2 dengan Ubuntu secara default. Restart komputer setelah instalasi selesai.

Setelah restart, Ubuntu akan terbuka otomatis dan meminta kamu membuat username + password untuk Linux.

4b. Buka Terminal WSL​

Setelah WSL terinstall, buka Ubuntu dari Start Menu, atau ketik di PowerShell:

wsl

Mulai dari sini, semua perintah dijalankan di terminal WSL (Linux). Ikuti langkah yang sama seperti tab Linux.

4c. Buat & Aktifkan Virtual Environment​

# Install venv module
sudo apt update
sudo apt install python3-venv python3-pip -y

# Buat virtual environment
python3 -m venv ~/bittensor-env

# Aktifkan virtual environment
source ~/bittensor-env/bin/activate

Setelah aktivasi, terminal akan menampilkan (bittensor-env) di awal baris:

(bittensor-env) namakamu@DESKTOP-xxx:~$

4d. Install btcli​

# Upgrade pip dulu
pip install --upgrade pip

# Install btcli (Bittensor CLI)
pip install bittensor-cli

Proses ini memakan waktu 2-5 menit tergantung kecepatan internet.

4e. Verifikasi​

btcli --version

Output yang diharapkan:

BTCLI version: 8.x.x

Jika muncul, selamat! btcli sudah terinstall.

Mengaktifkan Ulang di Sesi Berikutnya

Setiap kali membuka terminal WSL baru, aktifkan virtual environment lagi:

source ~/bittensor-env/bin/activate

Tambahkan alias agar lebih mudah:

echo 'alias btenv="source ~/bittensor-env/bin/activate"' >> ~/.bashrc
source ~/.bashrc

Sekarang cukup ketik btenv untuk mengaktifkan.

Alternatif: Tanpa WSL (Hanya untuk Wallet Management)

Jika kamu hanya ingin membuat wallet dan cek balance (tanpa mining), kamu bisa install btcli di Windows native:

python -m venv %USERPROFILE%\bittensor-env
%USERPROFILE%\bittensor-env\Scripts\activate.bat
pip install bittensor-cli
btcli --version

Namun untuk mining dan validating, WSL 2 tetap diperlukan.

Install Bittensor SDK (Opsional — untuk Development)​

Jika kamu ingin membangun miner atau validator kustom, install juga Bittensor SDK. SDK ini terpisah dari btcli.

# Install Bittensor SDK (versi yang kompatibel dengan sebagian besar subnet)
pip install "bittensor<10.0.0"

# Atau dengan dukungan PyTorch (untuk AI/ML)
pip install "bittensor[torch]<10.0.0"
Mengapa Versi di Bawah 10?

Banyak subnet (termasuk template resmi) belum di-update untuk Bittensor SDK v10+. Menggunakan bittensor<10.0.0 memastikan kompatibilitas paling luas. Jika nanti subnet yang kamu pilih membutuhkan versi lebih baru, kamu bisa upgrade sesuai instruksi README-nya.

Ukuran Download Besar

Package bittensor[torch] berukuran 2-4 GB karena menyertakan PyTorch. Pastikan koneksi internet stabil.

Verifikasi SDK:

python3 -c "import bittensor as bt; print(bt.__version__)"

Install dari Source (Alternatif)​

Jika ingin install btcli dari source code:

git clone https://github.com/opentensor/btcli.git
cd btcli
pip3 install .

Konfigurasi btcli​

Setelah install, btcli menyimpan konfigurasi default di ~/.bittensor/config.yml. Kamu bisa mengatur default values agar tidak perlu mengetik ulang setiap kali:

# Set default wallet name
btcli config set --wallet-name mywallet

# Set default network
btcli config set --network finney

# Lihat konfigurasi saat ini
btcli config get
Environment VariableFungsi
BTCLI_CONFIG_PATHOverride lokasi file config
BTCLI_DEBUG_FILELokasi debug log (default: ~/.bittensor/debug.txt)

Verifikasi Koneksi ke Jaringan​

Pastikan btcli bisa terhubung ke jaringan Bittensor:

btcli subnets list

Output yang diharapkan (tabel subnet yang aktif):

                                Subnets
NETUID  HYPERPARAMS    NAME              TEMPO  EMISSION  ...
   1    ...           prompting           99     0.13     ...
   2    ...           omron               99     0.08     ...
   ...

Jika muncul error koneksi, cek internet kamu dan coba lagi. Jika masih gagal, gunakan endpoint alternatif:

btcli subnets list --network finney

Langkah 4: Membuat Wallet​

Wallet Bittensor terdiri dari cold key dan hot key. Jika belum paham perbedaannya, baca dulu Modul 6: Wallet & Keamanan.

Apa yang Akan Dibuat?​

📁 ~/.bittensor/wallets/
└── 📁 mywallet/               ← Nama wallet kamu
    ├── 🔑 coldkey              ← Master key (JAGA BAIK-BAIK!)
    ├── 🔑 coldkeypub.txt       ← Public key (aman untuk dibagikan)
    └── 📁 hotkeys/
        └── 🔑 miner1           ← Key untuk mining
Langkah Ini Sama untuk Semua OS

Setelah Bittensor terinstall, perintah btcli sama di Windows, macOS, dan Linux. Pastikan virtual environment sudah aktif (ada (bittensor-env) di terminal).

5a. Buat Wallet Baru (Cold Key + Hot Key Sekaligus)​

btcli wallet create --wallet-name mywallet --hotkey miner1
Syntax btcli

Perhatikan bahwa btcli menggunakan tanda hubung (--wallet-name) bukan titik. Beberapa versi lama menggunakan --wallet.name — pastikan kamu menggunakan versi terbaru.

Sistem akan meminta kamu membuat password:

Enter password to encrypt key: ********
Retype password: ********
Tips Password
  • Minimal 12 karakter
  • Campuran huruf besar, kecil, angka, dan simbol
  • Jangan gunakan password yang sama dengan akun lain
  • Catat password ini di tempat aman — jika lupa, cold key tidak bisa diakses

Setelah itu, sistem akan menampilkan mnemonic phrase (12 atau 24 kata). Kamu bisa mengatur jumlah kata dengan flag --n-words:

# Default: 12 kata
btcli wallet create --wallet-name mywallet --hotkey miner1

# Atau 24 kata (lebih aman)
btcli wallet create --wallet-name mywallet --hotkey miner1 --n-words 24
Your mnemonic phrase:
abandon bicycle cargo dragon elephant flame guitar ...
SANGAT PENTING: Backup Mnemonic Phrase!

Mnemonic phrase ini adalah satu-satunya cara untuk memulihkan wallet jika hilang. Tidak ada "forgot password" atau "reset" di blockchain.

WAJIB dilakukan:

  1. Tulis mnemonic di kertas (bukan di komputer/HP)
  2. Simpan kertas di tempat aman (brankas, amplop tersegel)
  3. Buat minimal 2 salinan di lokasi berbeda
  4. Pastikan tulisan terbaca jelas

JANGAN PERNAH:

  • Screenshot atau foto mnemonic
  • Copy-paste ke Notes, Word, Google Docs, atau Notion
  • Simpan di cloud (Google Drive, iCloud, OneDrive)
  • Kirim via chat (WhatsApp, Telegram, Discord)
  • Bagikan ke siapapun — termasuk orang yang mengaku "support Bittensor"

5b. Atau Buat Cold Key dan Hot Key Terpisah​

Jika lebih suka membuat satu per satu:

# Buat cold key
btcli wallet new-coldkey --wallet-name mywallet

# Buat hot key
btcli wallet new-hotkey --wallet-name mywallet --hotkey miner1

5c. Verifikasi Wallet​

# Lihat daftar wallet yang sudah dibuat
btcli wallet list

Output yang diharapkan:

Wallets
└── mywallet (<ss58_address>)
    └── miner1 (<ss58_address>)
# Lihat overview wallet (semua subnet dan stake)
btcli wallet overview --wallet-name mywallet

5d. Cek Balance​

btcli wallet balance --wallet-name mywallet

Output (wallet baru, balance masih 0):

Wallet: mywallet
  Coldkey: <ss58_address>
  Balance: τ0.000000000

Opsi tambahan untuk balance:

# Cek balance semua wallet
btcli wallet balance --all

# Cek balance berdasarkan ss58 address (tanpa perlu wallet lokal)
btcli wallet balance --ss58-address 5Gx...abc

# Sort berdasarkan total balance
btcli wallet balance --all --sort total

5e. Recovery Wallet (Jika Perlu)​

Jika kamu sudah punya mnemonic phrase dan ingin memulihkan wallet:

# Recovery cold key dari mnemonic
btcli wallet regen-coldkey --wallet-name mywallet --mnemonic "word1 word2 word3 ..."

# Recovery hot key dari mnemonic
btcli wallet regen-hotkey --wallet-name mywallet --hotkey miner1 --mnemonic "word1 word2 word3 ..."

5f. Mendapatkan TAO​

TAO Testnet

TAO testnet tidak memiliki nilai uang nyata. Gunakan untuk belajar dan testing tanpa risiko kehilangan uang.

Pertama, set btcli ke testnet:

# Set btcli ke testnet
btcli config set --network test

# Atau jalankan command langsung ke testnet
btcli wallet balance --wallet-name mywallet --network test

Cara Mendapatkan Testnet TAO​

Ada beberapa cara untuk mendapatkan testnet TAO:

Cara 1: Miner's Union Testnet Faucet (Rekomendasi untuk Pemula)​

Miner's Union menyediakan faucet web yang mudah digunakan untuk mendapatkan testnet TAO.

Langkah-langkah:

  1. Buka https://app.minersunion.ai/testnet-faucet di browser
  2. Pastikan kamu sudah punya ss58 address dari cold key testnet kamu: 
    btcli wallet list --wallet-name mywallet
    Catat alamat ss58 yang ditampilkan (dimulai dengan 5...)
  3. Masukkan ss58 address cold key kamu di form faucet
  4. Klik Claim / Request Tokens
  5. Tunggu beberapa saat, lalu cek balance: 
    btcli wallet balance --wallet-name mywallet --network test
Miner's Union

Miner's Union adalah platform komunitas yang membantu miner baru untuk testing di testnet tanpa perlu setup validator sendiri. Selain faucet, mereka juga menyediakan tools monitoring dan panduan mining.

Cara 2: Request di Discord Bittensor​

Faucet bawaan btcli saat ini dinonaktifkan di testnet. Alternatif utama adalah meminta langsung di komunitas:

  1. Bergabung ke Discord Bittensor
  2. Cari channel #requests-for-testnet-tao (atau nama serupa)
  3. Kirim pesan dengan ss58 address kamu dan jelaskan bahwa kamu butuh testnet TAO untuk belajar
  4. Tunggu admin atau community member mengirim testnet TAO

Cara 3: Local Subtensor (untuk Developer)​

Jika kamu ingin testing tanpa tergantung testnet publik, jalankan subtensor lokal dengan faucet aktif:

# Clone subtensor
git clone https://github.com/opentensor/subtensor.git
cd subtensor

# Build dengan fitur faucet
cargo build --release --features pow-faucet

# Jalankan local subtensor
./target/release/node-subtensor --dev

Lalu gunakan faucet lokal:

btcli wallet faucet --wallet-name mywallet --network local
Local vs Testnet
  • Local subtensor — Kamu kontrol penuh, cocok untuk development dan testing cepat
  • Testnet publik — Lebih realistis, cocok untuk testing sebelum deploy ke mainnet

Lokasi File Wallet​

Wallet disimpan di lokasi berikut:

OSLokasi
WindowsC:\Users\namakamu\.bittensor\wallets\
macOS/Users/namakamu/.bittensor/wallets/
Linux/home/namakamu/.bittensor/wallets/
Folder Tersembunyi

Folder .bittensor dimulai dengan titik, artinya tersembunyi di file explorer.

  • Windows: Buka File Explorer → View → centang "Hidden items"
  • macOS: Di Finder, tekan Cmd + Shift + . untuk tampilkan file tersembunyi
  • Linux: ls -la ~/ atau tekan Ctrl + H di file manager

Langkah 5: Registrasi ke Subnet​

Sebelum mining, kamu harus mendaftarkan hotkey ke subnet yang ingin kamu ikuti.

6a. Lihat Daftar Subnet​

# Lihat semua subnet yang tersedia
btcli subnets list
Riset Subnet

Sebelum memilih subnet, lakukan riset di taostats.io atau tao.app untuk melihat:

  • Emisi TAO per subnet
  • Jumlah miner dan validator aktif
  • Requirements hardware
  • Profitabilitas estimasi

6b. Lihat Detail Subnet (Metagraph)​

# Lihat metagraph (daftar miner/validator) subnet tertentu
# Ganti 1 dengan nomor subnet yang diinginkan
btcli subnets metagraph --netuid 1
Tentang Metagraph

Metagraph menampilkan data "lite" — termasuk stake, trust, incentive, dan emission. Untuk data lengkap (weights & bonds), gunakan Python SDK dengan lite=False.

6c. Pilih Metode Registrasi​

Untuk menjadi miner, kamu harus mendaftarkan hotkey ke subnet agar mendapat UID (slot unik). Setiap subnet memiliki jumlah UID terbatas (biasanya 256 slot: maksimal 64 validator + 192 miner).

MetodeBiayaKecepatanCocok Untuk
TAO RegistrationBayar TAO (fluktuatif)Cepat (detik)Yang sudah punya TAO
POW RegistrationGratis (pakai CPU/GPU)Lambat (menit - jam)Mahasiswa yang belum punya TAO
Biaya Registrasi Dinamis

Biaya registrasi berubah secara dinamis — harga naik dua kali lipat setiap ada registrasi baru, lalu perlahan turun seiring waktu. Ini seperti sistem lelang terdesentralisasi. Biaya registrasi yang sudah dibayar tidak bisa dikembalikan.

Opsi A: Registration dengan TAO (Rekomendasi)​

btcli subnet register \
  --netuid 1 \
  --wallet.name mywallet \
  --wallet.hotkey miner1

Sistem akan menampilkan biaya dan meminta konfirmasi:

Registration cost: τ0.1 (example)
Do you want to proceed? [y/n]: y
Untuk Windows (WSL)

Di WSL, perintah multiline dengan \ bekerja normal. Jika kamu mengetik di satu baris:

btcli subnet register --netuid 1 --wallet.name mywallet --wallet.hotkey miner1

Opsi B: POW Registration (Gratis)​

btcli subnet pow_register \
  --netuid 1 \
  --wallet.name mywallet \
  --wallet.hotkey miner1

Proses ini memerlukan komputasi dan bisa memakan waktu beberapa menit hingga jam. Terminal akan menampilkan progress:

Solving POW... [difficulty: xxx] [hash rate: xxx H/s]

6d. Verifikasi Registrasi​

btcli subnets metagraph --netuid 1

Cari hotkey address kamu di daftar. Jika muncul, registrasi berhasil.

Kamu juga bisa verifikasi via Python SDK:

import bittensor as bt
sub = bt.subtensor(network="finney")
print(sub.is_hotkey_registered("YOUR_HOTKEY_SS58_ADDRESS"))
# Output: True jika terdaftar

Langkah 6: Menjalankan Miner​

Setiap Subnet Berbeda!

Setiap subnet memiliki cara instalasi dan menjalankan miner yang berbeda-beda. Tidak ada satu cara universal. Selalu baca README dari repository subnet yang kamu pilih sebelum mulai.

7a. Cara Umum: Clone dan Ikuti Instruksi Subnet​

Langkah umumnya:

  1. Temukan repository subnet — Cek GitHub OpenTensor, halaman subnet di Taostats, atau docs resmi subnet
  2. Clone repository
  3. Baca README.md — Ini langkah PALING PENTING, karena setiap subnet punya cara setup sendiri
  4. Install dependencies sesuai instruksi
  5. Jalankan miner sesuai instruksi

7b. Contoh: Menjalankan Miner dengan Subnet Template​

Kita akan menggunakan bittensor-subnet-template sebagai contoh praktik. Template ini dibuat untuk SDK Bittensor versi lama, jadi kita perlu pin versi bittensor<10.0.0.

Clone dan Install​

# Clone template subnet
git clone https://github.com/opentensor/bittensor-subnet-template.git
cd bittensor-subnet-template

# Install package
pip install -e .

Cari Subnet di Testnet​

# Lihat daftar subnet yang tersedia di testnet
btcli subnet list --subtensor.network test

Catat netuid subnet yang ingin kamu ikuti (misalnya 1).

Register Miner ke Subnet​

btcli subnet register \
  --netuid 1 \
  --wallet.name mywallet \
  --wallet.hotkey miner1 \
  --subtensor.network test
Butuh Test TAO

Registrasi ke subnet membutuhkan test TAO. Jika belum punya, claim dari faucet terlebih dahulu (lihat Langkah 4).

Jalankan Miner​

# caffeinate mencegah Mac sleep saat miner berjalan
caffeinate -i python3 neurons/miner.py \
  --netuid 1 \
  --wallet.name mywallet \
  --wallet.hotkey miner1 \
  --subtensor.network test \
  --logging.debug

Verifikasi Miner Berjalan​

Buka terminal baru (jangan tutup terminal miner!) dan jalankan:

# Aktifkan virtual environment dulu
source ~/bittensor-env/bin/activate

# Cek metagraph — miner kamu seharusnya muncul di sini
btcli subnet metagraph --netuid 1 --subtensor.network test

Jika miner kamu terdaftar dan berjalan, kamu akan melihat hotkey-mu di daftar metagraph dengan status ACTIVE: True.

Parameter Umum Miner​

ParameterFungsiContoh
--wallet.nameNama walletmywallet
--wallet.hotkeyNama hotkeyminer1
--netuidNomor ID subnet (lihat btcli subnets list)1, 8, 18, dll
--axon.portPort untuk menerima query8091
--logging.debugTampilkan log detail—
--subtensor.networkJaringan yang digunakanfinney (mainnet) atau test
Cara Tahu Command yang Benar
  1. Baca README.md di repo subnet
  2. Cari folder neurons/ atau src/ untuk entry point
  3. Cek pyproject.toml atau setup.py untuk script commands
  4. Join Discord subnet untuk tanya komunitas

Apa yang Terjadi Saat Miner Berjalan?​

Ketika miner berjalan, berikut proses yang terjadi di balik layar:

Apa yang TerjadiPenjelasan
Miner menerima queryValidator mengirim task ke miner melalui jaringan
Miner memproses taskMiner menjalankan logika (AI model, komputasi, dll) sesuai spesifikasi subnet
Validator menilaiResponse miner dinilai kualitasnya oleh validator
Reward diberikanMiner dengan response terbaik mendapat porsi TAO terbesar
Kompetisi terus-menerusProses ini berulang setiap epoch — miner harus terus memberikan response berkualitas

Contoh Manfaat Nyata per Subnet​

SubnetApa yang Miner LakukanOutput untuk Dunia Nyata
SN1 ApexMengirim solusi algoritmaBenchmark dan optimisasi AI model
SN8 TaoshiPrediksi harga aset finansialSinyal trading untuk trader dan hedge fund
SN13 DataverseScraping dan kurasi data webDataset terstruktur untuk riset dan bisnis
SN18 ZeusPrediksi cuaca berbasis AIData cuaca untuk pertanian dan asuransi
SN23 NicheImageGenerate gambar dari promptLayanan image generation terdesentralisasi

Mengapa Ini Penting?​

  1. Kamu dibayar TAO — Semakin bagus response miner-mu, semakin besar reward yang kamu terima
  2. Kontribusi nyata — Output miner digunakan oleh konsumen dan aplikasi di dunia nyata
  3. Kompetisi sehat — Mekanisme insentif mendorong miner untuk terus meningkatkan kualitas
  4. Desentralisasi AI — Kamu membantu membangun infrastruktur AI yang tidak dikontrol satu pihak
Subnet Template = Latihan

Perlu diingat bahwa bittensor-subnet-template yang kita jalankan tadi adalah template untuk belajar, bukan subnet produksi. Di mainnet, setiap subnet memiliki task spesifik (seperti contoh di tabel di atas) dengan reward TAO yang bernilai nyata.

7c. Menjaga Miner Tetap Berjalan​

Saat kamu tutup terminal, miner akan berhenti. Gunakan metode berikut agar miner tetap berjalan di background:

Karena mining memerlukan WSL, gunakan metode Linux (screen/tmux) di dalam WSL:

# Buka WSL dari PowerShell
wsl

Lalu ikuti instruksi Linux di tab sebelah.

Langkah 7: Membuka Port Firewall​

Miner perlu menerima koneksi masuk dari validator. Port default Bittensor axon adalah 8091.

Via GUI (Windows Defender Firewall)​

  1. Tekan Windows + R → ketik wf.msc → Enter
  2. Klik "Inbound Rules" di panel kiri
  3. Klik "New Rule..." di panel kanan
  4. Pilih "Port" → Next
  5. Pilih "TCP", masukkan 8091 → Next
  6. Pilih "Allow the connection" → Next
  7. Centang semua (Domain, Private, Public) → Next
  8. Name: "Bittensor Axon" → Finish

Via Command (PowerShell sebagai Administrator)​

netsh advfirewall firewall add rule name="Bittensor Axon" dir=in action=allow protocol=TCP localport=8091

Langkah 8: Verifikasi Node​

Setelah miner berjalan, verifikasi bahwa semuanya bekerja dengan benar.

9a. Cek Metagraph​

btcli subnets metagraph --netuid 1

Output contoh:

UID  │ HOTKEY       │ STAKE    │ TRUST  │ INCENTIVE │ EMISSION │ UPDATED
0    │ 5Gx...abc    │ 100.0    │ 0.95   │ 0.12      │ 0.08     │ 120
1    │ 5Hy...def    │ 50.0     │ 0.87   │ 0.09      │ 0.06     │ 115
...  │ (key kamu)   │ ...      │ ...    │ ...       │ ...      │ ...

9b. Memahami Metrik​

MetrikArtiTargetPenjelasan
UIDID unik di subnet—Nomor registrasi kamu di subnet
HOTKEYAlamat public hotkey—Cari ini untuk menemukan posisi kamu
STAKEJumlah TAO yang di-stakeLebih tinggi = lebih baik (validator)Menunjukkan "taruhan" di jaringan
TRUSTSkor kepercayaanDi atas 0.5Seberapa dipercaya validator terhadap kamu
INCENTIVESkor insentifSetinggi mungkinKualitas response kamu vs miner lain
EMISSIONTAO yang diterima per epochSetinggi mungkinReward yang kamu dapatkan
UPDATEDBlock terakhir updateHarus recentJika angka ini tidak berubah, ada masalah

9c. Monitor Berkala​

Jalankan pengecekan ini secara rutin (minimal 1x sehari):

# Cek metagraph (posisi dan skor kamu)
btcli subnets metagraph --netuid 1

# Cek balance (apakah reward masuk)
btcli wallet balance --wallet-name mywallet

# Cek apakah miner masih running
# Linux/macOS:
ps aux | grep miner.py

# Windows (PowerShell):
# Get-Process python | Where-Object {$_.CommandLine -like "*miner*"}

🔧 Troubleshooting Cepat​

Masalah Umum per OS​

MasalahPenyebabSolusi
wsl --install gagalFitur WSL belum aktifBuka "Turn Windows features on/off", aktifkan "Windows Subsystem for Linux"
python3: command not found (di WSL)Python belum terinstall di WSLsudo apt update && sudo apt install python3 python3-pip python3-venv -y
btcli: command not foundvenv tidak aktifsource ~/bittensor-env/bin/activate
pip install bittensor-cli errorRust belum terinstall (di WSL)Install Rust: curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
Port 8091 tidak bisa diaksesFirewall Windows memblok WSLTambahkan rule di Windows Firewall untuk port 8091
Mining tidak berjalan di Windows nativeMining tidak didukung di WindowsGunakan WSL 2 atau mesin Linux

Masalah Umum Semua OS​

MasalahPenyebabSolusi
Registration failedTAO tidak cukup atau slot penuhCek balance, coba POW registration
Timeout di btcliKoneksi jaringan lambatCoba endpoint alternatif (lihat di atas)
Wallet not foundNama wallet salah atau path berbedabtcli wallet list untuk cek nama
Miner running tapi tidak dapat rewardQuality terlalu rendah atau baru mulaiTunggu beberapa epoch, optimisasi model
ModuleNotFoundErrorDependencies belum terinstallpip install -r requirements.txt
Selalu Cek Log!

Jika ada masalah, langkah pertama adalah selalu baca pesan error dengan teliti. 90% masalah bisa diselesaikan hanya dengan membaca error message.

# Linux (systemd)
journalctl -u bittensor-miner -f --no-pager -n 100

# Linux/macOS (screen)
screen -r bittensor-miner

# Semua OS (jika miner jalan langsung di terminal)
# Error akan langsung terlihat di terminal

Rangkuman Perintah​

Cheat sheet lengkap — bookmark halaman ini untuk referensi cepat:

LangkahPerintahCatatan
Install btclipip install bittensor-cliAtau brew install btcli (macOS)
Install SDKpip install "bittensor<10.0.0"Opsional, untuk dev miner/validator
Aktifkan venv (Windows WSL/Linux)source ~/bittensor-env/bin/activateSetiap buka terminal baru
Aktifkan venv (macOS)source ~/bittensor-env/bin/activateSetiap buka terminal baru
Cek versi btclibtcli --versionPastikan terinstall
Set default configbtcli config set --wallet-name mywalletOpsional, agar tidak ketik ulang
Buat walletbtcli wallet create --wallet-name mywallet --hotkey miner1Backup mnemonic!
Cek walletbtcli wallet listLihat semua wallet
Cek balancebtcli wallet balance --wallet-name mywalletCek saldo TAO
Lihat subnetbtcli subnets listDaftar subnet aktif
Register (bayar)btcli subnet register --netuid 1 --wallet.name mywallet --wallet.hotkey miner1Butuh TAO
Register (gratis)btcli subnet pow_register --netuid 1 --wallet.name mywallet --wallet.hotkey miner1Butuh waktu
Jalankan minerBervariasi per subnet — baca README repo subnetContoh: python neurons/miner.py ...
Cek metagraphbtcli subnets metagraph --netuid 1Lihat posisi kamu
Recovery walletbtcli wallet regen-coldkey --wallet-name mywallet --mnemonic "..."Dari mnemonic phrase

Selanjutnya: Debugging & Troubleshooting →