Skip to content

Subnet repository for Bettensor, subnet 30 on the Bittensor network

License

Notifications You must be signed in to change notification settings

Nickel5-Inc/bettensor

Repository files navigation

Bettensor Logo

A sports prediction subnet on the Bittensor network

InstallationValidatorsMinersRelease DetailsWebsiteOfficial Discord Server

What Is Bettensor?

Bettensor is a sports prediction subnet. The goal of Bettensor is to provide a platform for sports fans to predict the outcomes of their favorite sporting events, and ML/AI researchers to develop new models and strategies to benchmark against good, old fashioned human intelligence and intuition.

Mining on this subnet is simple. In this Beta release, miners receive upcoming games and odds, submit predictions as a simulated wager, and are rewarded for correct predictions upon game conclusion. Compute requirements are minimal for those choosing the human intelligence method - all you need is to consistently submit predictions for upcoming games.

Important

Before you begin using our services, please read this legal disclaimer carefully:

  • Nature of Service: Bettensor is a software application developed on the Bittensor network, which operates independently of our control. We are not a financial institution, nor do we facilitate any monetary transactions directly. Bettensor does not distribute payments nor collects money, whether in the form of cryptocurrencies or fiat currencies.
  • Rewards and Transactions: Users of Bettensor engage directly with the Bittensor network. Rewards or payments are issued by the Bittensor network based on the protocols established within its framework. Bettensor's role is limited to providing software that suggests allocation of $TAO tokens based on the predictions made by users. We do not influence or control the decision-making process of the Bittensor network concerning the distribution of rewards.
  • No Financial Advice: The information provided by Bettensor is for informational purposes only and should not be considered financial advice. Users should conduct their own research or consult with a professional advisor before engaging in any betting activities.
  • Assumption of Risk: By using Bettensor, users acknowledge and accept the risks associated with online betting and digital transactions, including but not limited to the risk of financial loss. Users should engage with the platform responsibly and within the bounds of applicable laws and regulations.
  • Compliance with Laws: Users of Bettensor are solely responsible for ensuring that their actions comply with local, state, and federal laws applicable to sports betting and online gambling. Bettensor assumes no responsibility for illegal or unauthorized use of the service.
  • Changes and Amendments: We reserve the right to modify this disclaimer at any time. Users are encouraged to periodically review this document to stay informed of any changes.

By using Bettensor, you acknowledge that you have read, understood, and agreed to the terms outlined in this legal disclaimer. If you do not agree with any part of this disclaimer, you should not use Bettensor.

Installation and Setup

To mine or validate on this subnet, we recommend starting with a cheap VPS instance running Ubuntu 22.04. As with most Subnets, we also recommend running your own Lite Node. You can find a guide to running a Lite Node here.

Note

In this current Beta version, we require Bittensor v6.9.3.

  1. Clone the repository:
git clone https://github.com/bettensor/bettensor.git
  1. Update apt-get:
sudo apt-get update
  1. Run the setup script:
cd bettensor
chmod +x scripts/setup.sh
source ./scripts/setup.sh
  • if you want to set up a lite node (recommended), run the command with the flag source ./scripts/setup.sh --lite-node

  • additionally, the script takes --subtensor.network as an optional flag. if you want to run the lite node on testnet, run source ./scripts/setup.sh --subtensor.network test , or main for mainnet.

  1. Set up a Bittensor wallet (guide here).

  2. Register on the subnet:

  • Mainnet (NETUID 30):
btcli subnet register --netuid 30 --wallet.name <YOUR_COLDKEY> --wallet.hotkey <YOUR_HOTKEY>
  • Testnet (NETUID: 181):
btcli subnet register --netuid 181 --wallet.name <YOUR_COLDKEY> --wallet.hotkey <YOUR_HOTKEY> --subtensor.network test

Guide for Validators

For detailed instructions on setting up and running a Bettensor validator, please refer to our Validator Guide. This document covers:

  • Setting up the environment
  • Running the validator
  • Recommended logging settings

Whether you're new to Bettensor or an experienced validator, the Validator Guide provides all the information you need to participate in the network effectively.

Guide for Miners

For detailed instructions on setting up and running a Bettensor miner, please refer to our Miner Guide. This comprehensive document covers:

  • Miner setup and configuration
  • Choosing between Local and Central Server interfaces
  • Submitting predictions
  • Managing multiple miners
  • Security considerations
  • Troubleshooting and FAQs

Whether you're new to Bettensor or an experienced miner, the Miner Guide provides all the information you need to participate in the network effectively.

Incentive Mechanism and Scoring

The incentive mechanism is intricate and rewards the best miners disproportionately. Details around the mechanism can be found here.

Details for Current Release Version (v2.0.0, Beta)

  • Currently Supported Sports: Baseball, Football (Soccer), American Football
  • Currently available base models: (Football (Soccer): UEFA Teams, NFL)
  • Requires Bittensor==v6.9.4. Support for Bittensor v7.x is coming soon.

License

This repository is licensed under the MIT License.

The MIT License (MIT)
Copyright © 2024 Bettensor (oneandahalfcats, geardici, honeybadgerhavoc)

# Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated
# documentation files (the "Software"), to deal in the Software without restriction, including without limitation
# the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software,
# and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

# The above copyright notice and this permission notice shall be included in all copies or substantial portions of
# the Software.

# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO
# THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
# THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
# OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
# DEALINGS IN THE SOFTWARE.

Bettensor Logo