# set-hyperparameter (/docs/tx/set-hyperparameter)

Dispatches the matching AdminUtils `sudo_set_*` call for the named
parameter (`alpha_low`/`alpha_high` read the current pair from chain and
set both via `sudo_set_alpha_values`). The signer must be the subnet's
owner coldkey; root-only parameters are not available here and must go
through the raw-call escape hatch. Changes take effect on chain immediately
and shape subnet economics and consensus (registration costs, weight
rules, immunity, transfers), so
verify the raw value before sending — `value` accepts either the raw
on-chain integer or a human form that is converted for you. Some
parameters are rate-limited by the chain, so a quick follow-up change can
fail. Read current values back with the `subnet_hyperparameters` read.

| Signer    | Origin       | Pallet     | Wraps                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| --------- | ------------ | ---------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `coldkey` | subnet owner | AdminUtils | [`AdminUtils.sudo_set_tempo`](/code/pallets/admin-utils/src/lib.rs#L1028-L1043), [`AdminUtils.sudo_set_immunity_period`](/code/pallets/admin-utils/src/lib.rs#L481-L509), [`AdminUtils.sudo_set_min_allowed_weights`](/code/pallets/admin-utils/src/lib.rs#L514-L542), [`AdminUtils.sudo_set_weights_version_key`](/code/pallets/admin-utils/src/lib.rs#L366-L396), [`AdminUtils.sudo_set_activity_cutoff_factor`](/code/pallets/admin-utils/src/lib.rs#L686-L702), [`AdminUtils.sudo_set_min_burn`](/code/pallets/admin-utils/src/lib.rs#L768-L802), [`AdminUtils.sudo_set_max_burn`](/code/pallets/admin-utils/src/lib.rs#L807-L841), [`AdminUtils.sudo_set_bonds_moving_average`](/code/pallets/admin-utils/src/lib.rs#L899-L933), [`AdminUtils.sudo_set_bonds_penalty`](/code/pallets/admin-utils/src/lib.rs#L938-L964), [`AdminUtils.sudo_set_serving_rate_limit`](/code/pallets/admin-utils/src/lib.rs#L283-L304), [`AdminUtils.sudo_set_commit_reveal_weights_interval`](/code/pallets/admin-utils/src/lib.rs#L1381-L1410), [`AdminUtils.sudo_set_max_allowed_uids`](/code/pallets/admin-utils/src/lib.rs#L547-L592), [`AdminUtils.sudo_set_burn_increase_mult`](/code/pallets/admin-utils/src/lib.rs#L2216-L2256), [`AdminUtils.sudo_set_burn_half_life`](/code/pallets/admin-utils/src/lib.rs#L2174-L2212), [`AdminUtils.sudo_set_collateral_lock_share`](/code/pallets/admin-utils/src/lib.rs#L2340-L2375), [`AdminUtils.sudo_set_collateral_drain_ratio`](/code/pallets/admin-utils/src/lib.rs#L2383-L2424), [`AdminUtils.sudo_set_adjustment_alpha`](/code/pallets/admin-utils/src/lib.rs#L450-L476), [`AdminUtils.sudo_set_rho`](/code/pallets/admin-utils/src/lib.rs#L613-L635), [`AdminUtils.sudo_set_max_difficulty`](/code/pallets/admin-utils/src/lib.rs#L333-L361), [`AdminUtils.sudo_set_alpha_sigmoid_steepness`](/code/pallets/admin-utils/src/lib.rs#L1632-L1666), [`AdminUtils.sudo_set_min_childkey_take_per_subnet`](/code/pallets/admin-utils/src/lib.rs#L1205-L1239), [`AdminUtils.sudo_set_owner_immune_neuron_limit`](/code/pallets/admin-utils/src/lib.rs#L1818-L1838), [`AdminUtils.sudo_set_alpha_values`](/code/pallets/admin-utils/src/lib.rs#L1306-L1331), [`AdminUtils.sudo_set_commit_reveal_weights_enabled`](/code/pallets/admin-utils/src/lib.rs#L1244-L1271), [`AdminUtils.sudo_set_liquid_alpha_enabled`](/code/pallets/admin-utils/src/lib.rs#L1282-L1303), [`AdminUtils.sudo_set_network_pow_registration_allowed`](/code/pallets/admin-utils/src/lib.rs#L728-L736), [`AdminUtils.sudo_set_yuma3_enabled`](/code/pallets/admin-utils/src/lib.rs#L1677-L1700), [`AdminUtils.sudo_set_bonds_reset_enabled`](/code/pallets/admin-utils/src/lib.rs#L1711-L1734), [`AdminUtils.sudo_set_toggle_transfer`](/code/pallets/admin-utils/src/lib.rs#L1470-L1492), [`AdminUtils.sudo_set_owner_cut_enabled`](/code/pallets/admin-utils/src/lib.rs#L2260-L2280), [`AdminUtils.sudo_set_owner_cut_auto_lock_enabled`](/code/pallets/admin-utils/src/lib.rs#L2284-L2304) |

## Parameters [#parameters]

| Parameter | Type                        | Required | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| --------- | --------------------------- | -------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `netuid`  | integer                     | yes      | Subnet to configure; the signer must be its owner.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| `name`    | string                      | yes      | Hyperparameter to set. One of: activity\_cutoff\_factor, adjustment\_alpha, alpha\_high, alpha\_low, alpha\_sigmoid\_steepness, bonds\_moving\_avg, bonds\_penalty, bonds\_reset\_enabled, burn\_half\_life, burn\_increase\_mult, collateral\_drain\_ratio, collateral\_lock\_share, commit\_reveal\_period, commit\_reveal\_weights\_enabled, immunity\_period, liquid\_alpha\_enabled, max\_allowed\_uids, max\_burn, max\_difficulty, min\_allowed\_weights, min\_burn, min\_childkey\_take, network\_pow\_registration\_allowed, owner\_cut\_auto\_lock\_enabled, owner\_cut\_enabled, owner\_immune\_neuron\_limit, rho, serving\_rate\_limit, tempo, transfers\_enabled, weights\_version, yuma3\_enabled. |
| `value`   | integer \| number \| string | yes      | New value. Give the raw on-chain integer (within the parameter's codec bounds), or the human form as a float or a string with a decimal point (a 0..1 fraction for normalized parameters, a non-negative TAO amount for rao parameters). Boolean parameters take true/false or 0/1 only.                                                                                                                                                                                                                                                                                                                                                                                                                          |

Address parameters (`--hotkey`, `--coldkey`, `--dest`, ...) accept a raw ss58
address, an address-book or proxy-book name, or a local wallet/hotkey name.

## CLI [#cli]

Preview with `--dry-run` (shows fee, effects, and policy result without
submitting), then submit:

```bash
btcli tx set-hyperparameter \
  --netuid <int> \
  --name <value> \
  --value <value> --dry-run
btcli tx set-hyperparameter \
  --netuid <int> \
  --name <value> \
  --value <value> -w my_coldkey
```

## Python [#python]

```python
import bittensor as bt
from bittensor.wallet import Wallet

wallet = Wallet(name="my_coldkey", hotkey="my_hotkey")
intent = bt.SetHyperparameter(netuid=1, name="...", value="...")

sub = bt.Subtensor()
plan = sub.plan(intent, wallet)   # fee, effects, policy — no submission
result = sub.execute(intent, wallet)
if not result.success:
    print(result.error.code, result.error.remediation)
```

(`bt.Subtensor` is also the async client — `async with bt.Subtensor() as client:`
— see [The client](/docs/concepts/client).) Or build the intent by op name, as
an agent would:

```python
result = sub.execute_tool("set_hyperparameter", {...}, wallet)
```

## On-chain implementation [#on-chain-implementation]

| Chain call                                             | Source                                                                                     |
| ------------------------------------------------------ | ------------------------------------------------------------------------------------------ |
| `AdminUtils.sudo_set_tempo`                            | [`pallets/admin-utils/src/lib.rs#L1039`](/code/pallets/admin-utils/src/lib.rs#L1028-L1043) |
| `AdminUtils.sudo_set_immunity_period`                  | [`pallets/admin-utils/src/lib.rs#L483`](/code/pallets/admin-utils/src/lib.rs#L481-L509)    |
| `AdminUtils.sudo_set_min_allowed_weights`              | [`pallets/admin-utils/src/lib.rs#L516`](/code/pallets/admin-utils/src/lib.rs#L514-L542)    |
| `AdminUtils.sudo_set_weights_version_key`              | [`pallets/admin-utils/src/lib.rs#L368`](/code/pallets/admin-utils/src/lib.rs#L366-L396)    |
| `AdminUtils.sudo_set_activity_cutoff_factor`           | [`pallets/admin-utils/src/lib.rs#L688`](/code/pallets/admin-utils/src/lib.rs#L686-L702)    |
| `AdminUtils.sudo_set_min_burn`                         | [`pallets/admin-utils/src/lib.rs#L770`](/code/pallets/admin-utils/src/lib.rs#L768-L802)    |
| `AdminUtils.sudo_set_max_burn`                         | [`pallets/admin-utils/src/lib.rs#L809`](/code/pallets/admin-utils/src/lib.rs#L807-L841)    |
| `AdminUtils.sudo_set_bonds_moving_average`             | [`pallets/admin-utils/src/lib.rs#L901`](/code/pallets/admin-utils/src/lib.rs#L899-L933)    |
| `AdminUtils.sudo_set_bonds_penalty`                    | [`pallets/admin-utils/src/lib.rs#L940`](/code/pallets/admin-utils/src/lib.rs#L938-L964)    |
| `AdminUtils.sudo_set_serving_rate_limit`               | [`pallets/admin-utils/src/lib.rs#L285`](/code/pallets/admin-utils/src/lib.rs#L283-L304)    |
| `AdminUtils.sudo_set_commit_reveal_weights_interval`   | [`pallets/admin-utils/src/lib.rs#L1383`](/code/pallets/admin-utils/src/lib.rs#L1381-L1410) |
| `AdminUtils.sudo_set_max_allowed_uids`                 | [`pallets/admin-utils/src/lib.rs#L549`](/code/pallets/admin-utils/src/lib.rs#L547-L592)    |
| `AdminUtils.sudo_set_burn_increase_mult`               | [`pallets/admin-utils/src/lib.rs#L2218`](/code/pallets/admin-utils/src/lib.rs#L2216-L2256) |
| `AdminUtils.sudo_set_burn_half_life`                   | [`pallets/admin-utils/src/lib.rs#L2176`](/code/pallets/admin-utils/src/lib.rs#L2174-L2212) |
| `AdminUtils.sudo_set_collateral_lock_share`            | [`pallets/admin-utils/src/lib.rs#L2342`](/code/pallets/admin-utils/src/lib.rs#L2340-L2375) |
| `AdminUtils.sudo_set_collateral_drain_ratio`           | [`pallets/admin-utils/src/lib.rs#L2385`](/code/pallets/admin-utils/src/lib.rs#L2383-L2424) |
| `AdminUtils.sudo_set_adjustment_alpha`                 | [`pallets/admin-utils/src/lib.rs#L452`](/code/pallets/admin-utils/src/lib.rs#L450-L476)    |
| `AdminUtils.sudo_set_rho`                              | [`pallets/admin-utils/src/lib.rs#L615`](/code/pallets/admin-utils/src/lib.rs#L613-L635)    |
| `AdminUtils.sudo_set_max_difficulty`                   | [`pallets/admin-utils/src/lib.rs#L335`](/code/pallets/admin-utils/src/lib.rs#L333-L361)    |
| `AdminUtils.sudo_set_alpha_sigmoid_steepness`          | [`pallets/admin-utils/src/lib.rs#L1634`](/code/pallets/admin-utils/src/lib.rs#L1632-L1666) |
| `AdminUtils.sudo_set_min_childkey_take_per_subnet`     | [`pallets/admin-utils/src/lib.rs#L1207`](/code/pallets/admin-utils/src/lib.rs#L1205-L1239) |
| `AdminUtils.sudo_set_owner_immune_neuron_limit`        | [`pallets/admin-utils/src/lib.rs#L1820`](/code/pallets/admin-utils/src/lib.rs#L1818-L1838) |
| `AdminUtils.sudo_set_alpha_values`                     | [`pallets/admin-utils/src/lib.rs#L1308`](/code/pallets/admin-utils/src/lib.rs#L1306-L1331) |
| `AdminUtils.sudo_set_commit_reveal_weights_enabled`    | [`pallets/admin-utils/src/lib.rs#L1246`](/code/pallets/admin-utils/src/lib.rs#L1244-L1271) |
| `AdminUtils.sudo_set_liquid_alpha_enabled`             | [`pallets/admin-utils/src/lib.rs#L1284`](/code/pallets/admin-utils/src/lib.rs#L1282-L1303) |
| `AdminUtils.sudo_set_network_pow_registration_allowed` | [`pallets/admin-utils/src/lib.rs#L730`](/code/pallets/admin-utils/src/lib.rs#L728-L736)    |
| `AdminUtils.sudo_set_yuma3_enabled`                    | [`pallets/admin-utils/src/lib.rs#L1679`](/code/pallets/admin-utils/src/lib.rs#L1677-L1700) |
| `AdminUtils.sudo_set_bonds_reset_enabled`              | [`pallets/admin-utils/src/lib.rs#L1713`](/code/pallets/admin-utils/src/lib.rs#L1711-L1734) |
| `AdminUtils.sudo_set_toggle_transfer`                  | [`pallets/admin-utils/src/lib.rs#L1472`](/code/pallets/admin-utils/src/lib.rs#L1470-L1492) |
| `AdminUtils.sudo_set_owner_cut_enabled`                | [`pallets/admin-utils/src/lib.rs#L2262`](/code/pallets/admin-utils/src/lib.rs#L2260-L2280) |
| `AdminUtils.sudo_set_owner_cut_auto_lock_enabled`      | [`pallets/admin-utils/src/lib.rs#L2286`](/code/pallets/admin-utils/src/lib.rs#L2284-L2304) |

Every file is browsable under [/code](/code) exactly as built into the runtime, or as plain text under `/code/raw/<path>` (index: [`/code/index.json`](/code/index.json)).