# 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#L1047-L1062), [`AdminUtils.sudo_set_immunity_period`](/code/pallets/admin-utils/src/lib.rs#L500-L528), [`AdminUtils.sudo_set_min_allowed_weights`](/code/pallets/admin-utils/src/lib.rs#L533-L561), [`AdminUtils.sudo_set_weights_version_key`](/code/pallets/admin-utils/src/lib.rs#L385-L415), [`AdminUtils.sudo_set_activity_cutoff_factor`](/code/pallets/admin-utils/src/lib.rs#L705-L721), [`AdminUtils.sudo_set_min_burn`](/code/pallets/admin-utils/src/lib.rs#L787-L821), [`AdminUtils.sudo_set_max_burn`](/code/pallets/admin-utils/src/lib.rs#L826-L860), [`AdminUtils.sudo_set_bonds_moving_average`](/code/pallets/admin-utils/src/lib.rs#L918-L952), [`AdminUtils.sudo_set_bonds_penalty`](/code/pallets/admin-utils/src/lib.rs#L957-L983), [`AdminUtils.sudo_set_serving_rate_limit`](/code/pallets/admin-utils/src/lib.rs#L302-L323), [`AdminUtils.sudo_set_commit_reveal_weights_interval`](/code/pallets/admin-utils/src/lib.rs#L1423-L1452), [`AdminUtils.sudo_set_max_allowed_uids`](/code/pallets/admin-utils/src/lib.rs#L566-L611), [`AdminUtils.sudo_set_burn_increase_mult`](/code/pallets/admin-utils/src/lib.rs#L2261-L2301), [`AdminUtils.sudo_set_burn_half_life`](/code/pallets/admin-utils/src/lib.rs#L2219-L2257), [`AdminUtils.sudo_set_collateral_lock_share`](/code/pallets/admin-utils/src/lib.rs#L2385-L2420), [`AdminUtils.sudo_set_collateral_drain_ratio`](/code/pallets/admin-utils/src/lib.rs#L2428-L2469), [`AdminUtils.sudo_set_adjustment_alpha`](/code/pallets/admin-utils/src/lib.rs#L469-L495), [`AdminUtils.sudo_set_rho`](/code/pallets/admin-utils/src/lib.rs#L632-L654), [`AdminUtils.sudo_set_max_difficulty`](/code/pallets/admin-utils/src/lib.rs#L352-L380), [`AdminUtils.sudo_set_alpha_sigmoid_steepness`](/code/pallets/admin-utils/src/lib.rs#L1677-L1711), [`AdminUtils.sudo_set_min_childkey_take_per_subnet`](/code/pallets/admin-utils/src/lib.rs#L1224-L1258), [`AdminUtils.sudo_set_owner_immune_neuron_limit`](/code/pallets/admin-utils/src/lib.rs#L1863-L1883), [`AdminUtils.sudo_set_alpha_values`](/code/pallets/admin-utils/src/lib.rs#L1325-L1350), [`AdminUtils.sudo_set_commit_reveal_weights_enabled`](/code/pallets/admin-utils/src/lib.rs#L1263-L1290), [`AdminUtils.sudo_set_liquid_alpha_enabled`](/code/pallets/admin-utils/src/lib.rs#L1301-L1322), [`AdminUtils.sudo_set_network_pow_registration_allowed`](/code/pallets/admin-utils/src/lib.rs#L747-L755), [`AdminUtils.sudo_set_yuma3_enabled`](/code/pallets/admin-utils/src/lib.rs#L1722-L1745), [`AdminUtils.sudo_set_bonds_reset_enabled`](/code/pallets/admin-utils/src/lib.rs#L1756-L1779), [`AdminUtils.sudo_set_toggle_transfer`](/code/pallets/admin-utils/src/lib.rs#L1515-L1537), [`AdminUtils.sudo_set_owner_cut_enabled`](/code/pallets/admin-utils/src/lib.rs#L2305-L2325), [`AdminUtils.sudo_set_owner_cut_auto_lock_enabled`](/code/pallets/admin-utils/src/lib.rs#L2329-L2349) |

## 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#L1058`](/code/pallets/admin-utils/src/lib.rs#L1047-L1062) |
| `AdminUtils.sudo_set_immunity_period`                  | [`pallets/admin-utils/src/lib.rs#L502`](/code/pallets/admin-utils/src/lib.rs#L500-L528)    |
| `AdminUtils.sudo_set_min_allowed_weights`              | [`pallets/admin-utils/src/lib.rs#L535`](/code/pallets/admin-utils/src/lib.rs#L533-L561)    |
| `AdminUtils.sudo_set_weights_version_key`              | [`pallets/admin-utils/src/lib.rs#L387`](/code/pallets/admin-utils/src/lib.rs#L385-L415)    |
| `AdminUtils.sudo_set_activity_cutoff_factor`           | [`pallets/admin-utils/src/lib.rs#L707`](/code/pallets/admin-utils/src/lib.rs#L705-L721)    |
| `AdminUtils.sudo_set_min_burn`                         | [`pallets/admin-utils/src/lib.rs#L789`](/code/pallets/admin-utils/src/lib.rs#L787-L821)    |
| `AdminUtils.sudo_set_max_burn`                         | [`pallets/admin-utils/src/lib.rs#L828`](/code/pallets/admin-utils/src/lib.rs#L826-L860)    |
| `AdminUtils.sudo_set_bonds_moving_average`             | [`pallets/admin-utils/src/lib.rs#L920`](/code/pallets/admin-utils/src/lib.rs#L918-L952)    |
| `AdminUtils.sudo_set_bonds_penalty`                    | [`pallets/admin-utils/src/lib.rs#L959`](/code/pallets/admin-utils/src/lib.rs#L957-L983)    |
| `AdminUtils.sudo_set_serving_rate_limit`               | [`pallets/admin-utils/src/lib.rs#L304`](/code/pallets/admin-utils/src/lib.rs#L302-L323)    |
| `AdminUtils.sudo_set_commit_reveal_weights_interval`   | [`pallets/admin-utils/src/lib.rs#L1425`](/code/pallets/admin-utils/src/lib.rs#L1423-L1452) |
| `AdminUtils.sudo_set_max_allowed_uids`                 | [`pallets/admin-utils/src/lib.rs#L568`](/code/pallets/admin-utils/src/lib.rs#L566-L611)    |
| `AdminUtils.sudo_set_burn_increase_mult`               | [`pallets/admin-utils/src/lib.rs#L2263`](/code/pallets/admin-utils/src/lib.rs#L2261-L2301) |
| `AdminUtils.sudo_set_burn_half_life`                   | [`pallets/admin-utils/src/lib.rs#L2221`](/code/pallets/admin-utils/src/lib.rs#L2219-L2257) |
| `AdminUtils.sudo_set_collateral_lock_share`            | [`pallets/admin-utils/src/lib.rs#L2387`](/code/pallets/admin-utils/src/lib.rs#L2385-L2420) |
| `AdminUtils.sudo_set_collateral_drain_ratio`           | [`pallets/admin-utils/src/lib.rs#L2430`](/code/pallets/admin-utils/src/lib.rs#L2428-L2469) |
| `AdminUtils.sudo_set_adjustment_alpha`                 | [`pallets/admin-utils/src/lib.rs#L471`](/code/pallets/admin-utils/src/lib.rs#L469-L495)    |
| `AdminUtils.sudo_set_rho`                              | [`pallets/admin-utils/src/lib.rs#L634`](/code/pallets/admin-utils/src/lib.rs#L632-L654)    |
| `AdminUtils.sudo_set_max_difficulty`                   | [`pallets/admin-utils/src/lib.rs#L354`](/code/pallets/admin-utils/src/lib.rs#L352-L380)    |
| `AdminUtils.sudo_set_alpha_sigmoid_steepness`          | [`pallets/admin-utils/src/lib.rs#L1679`](/code/pallets/admin-utils/src/lib.rs#L1677-L1711) |
| `AdminUtils.sudo_set_min_childkey_take_per_subnet`     | [`pallets/admin-utils/src/lib.rs#L1226`](/code/pallets/admin-utils/src/lib.rs#L1224-L1258) |
| `AdminUtils.sudo_set_owner_immune_neuron_limit`        | [`pallets/admin-utils/src/lib.rs#L1865`](/code/pallets/admin-utils/src/lib.rs#L1863-L1883) |
| `AdminUtils.sudo_set_alpha_values`                     | [`pallets/admin-utils/src/lib.rs#L1327`](/code/pallets/admin-utils/src/lib.rs#L1325-L1350) |
| `AdminUtils.sudo_set_commit_reveal_weights_enabled`    | [`pallets/admin-utils/src/lib.rs#L1265`](/code/pallets/admin-utils/src/lib.rs#L1263-L1290) |
| `AdminUtils.sudo_set_liquid_alpha_enabled`             | [`pallets/admin-utils/src/lib.rs#L1303`](/code/pallets/admin-utils/src/lib.rs#L1301-L1322) |
| `AdminUtils.sudo_set_network_pow_registration_allowed` | [`pallets/admin-utils/src/lib.rs#L749`](/code/pallets/admin-utils/src/lib.rs#L747-L755)    |
| `AdminUtils.sudo_set_yuma3_enabled`                    | [`pallets/admin-utils/src/lib.rs#L1724`](/code/pallets/admin-utils/src/lib.rs#L1722-L1745) |
| `AdminUtils.sudo_set_bonds_reset_enabled`              | [`pallets/admin-utils/src/lib.rs#L1758`](/code/pallets/admin-utils/src/lib.rs#L1756-L1779) |
| `AdminUtils.sudo_set_toggle_transfer`                  | [`pallets/admin-utils/src/lib.rs#L1517`](/code/pallets/admin-utils/src/lib.rs#L1515-L1537) |
| `AdminUtils.sudo_set_owner_cut_enabled`                | [`pallets/admin-utils/src/lib.rs#L2307`](/code/pallets/admin-utils/src/lib.rs#L2305-L2325) |
| `AdminUtils.sudo_set_owner_cut_auto_lock_enabled`      | [`pallets/admin-utils/src/lib.rs#L2331`](/code/pallets/admin-utils/src/lib.rs#L2329-L2349) |

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)).