Targon (Bittensor Subnet 4) is a redundant deterministic verification mechanism that can be used to interpret and analyze ground truth sources and a query.
NOTICE: Using this software, you must agree to the Terms and Agreements provided in the terms and conditions document. By downloading and running this software, you implicitly agree to these terms and conditions.
- Compute Requirements
- Installation
- What is a Redundant Deterministic Verification Network?
- Features of Targon
- How to Run Targon
- How to Contribute
The following table shows the suggested compute providers for running a validator or miner.
Provider | Cost | Location | Machine Type | Rating |
---|---|---|---|---|
TensorDock | Low | Global | VM & Container | 4/5 |
Latitude | Medium | Global | Bare Metal | 5/5 |
Paperspace | High | Global | VM & Bare Metal | 4.5/5 |
GCP | High | Global | VM & Bare Metal | 3/5 |
Azure | High | Global | VM & Bare Metal | 3/5 |
AWS | High | Global | VM & Bare Metal | 3/5 |
Runpod | Low | Global | VM & Container | 5/5 |
- VRAM: 80 GB
- Storage: 200 GB
- RAM: 16 GB
- CPU: 4
In order to run Targon, you will need to install PM2 and the Targon package. The following instructions apply only to Ubuntu OSes. For your specific OS, please refer to the official documentation.
To install or update nvm, you should run the install script. To do that, you may either download and run the script manually, or use the following cURL or Wget command:
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
Running either of the above commands downloads a script and runs it. The script
clones the nvm repository to /.nvm, and attempts to add the source lines from
the snippet below to the correct profile file (/.bash_profile, ~/.zshrc,
~/.profile, or ~/.bashrc).
export NVM_DIR="$([ -z "${XDG_CONFIG_HOME-}" ] && printf %s "${HOME}/.nvm" || printf %s "${XDG_CONFIG_HOME}/nvm")"
[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh" # This loads nvm
nvm install node
npm install pm2@latest -g
You have now installed PM2.
git clone https://github.com/manifold-inc/targon.git
cd targon
python3 -m pip install -e .
You have now installed Targon. You can now run a validator or a miner.
The query and a deterministic seed are used to generate a ground truth output with the specified model, which can be run by the validator or as a light client. The validator then sends requests to miners with the query and deterministic seed. The miner's responses are scored based on Tokens Per Second only if they pass a Jaro-Winkler Similarity test given a predefined threshold.
A miner is a node that is responsible for generating a output from a query and a deterministic sampling params.
A validator is a node that is responsible for verifying a miner's output. The validator will send a request to a miner with a query and deterministic sampling params. The miner will then send back a response with the output. The validator will then compare the output to the ground truth output. If the outputs are similar enough in respect to Jaro Winkler Similarity, then the miner has completed the challenge.
An inference request is a request sent by a validator to a miner. The inference request contains a query and inference sampling params. The miner will then generate an output from the query and deterministic sampling params that is then streamed back to the validator.
CAVEAT: Every Interval (360 blocks) there will be a random amount of inference samples by the validator. The validator will then compare the outputs to the ground truth outputs. The Jaro-Winkler Simalarity of the outputs will be used to determine the reward for the miner if the miner is running an appropriate model. If the miner fails verification, their score will be 0.
The Jaro-Winkler Similarity is a string metric measuring edit distance between two strings. Jaro-Winkler Similarity is defined as:
where:
S_w = Jaro-Winkler Similarity
S_j = Jaro Similarity
P = Scaling Factor
L = Length of the matching prefix up to a max of 4 characters
Jaro Similarity is the measure of similarity between two strings. The value of Jaro distance ranged from 0 to 1 where 0 means no similarity and 1 means very similar.
The Jaro Similarity is calculated using the following formula:
where:
S_j = Jaro Similarity
m = number of matching characters
t = half of the number of transpositions
s1 = length of first string
s2 = length of second string
In the context of Targon, the scaling factor for our Jaro-Winkler calculation was set to 0.25.
Note: Jaro-Winkler Similarity is not a mathematical metric, as it fails the Triangle Inequality.
In order to run Targon, you must have a VLLM instance up and running.
First, install VLLM and JSON Schema on your machine
pip install vllm jsonschema
Now you are ready to server your VLLM instance to PM2
pm2 start vllm --name vllm-serve --interpreter python3 -- serve mlabonne/NeuralDaredevil-7B --dtype auto --api-key [some-secret-you-also-pass-to-validator] --port 8000
The --neuron.model_endpoint
for miner / vali using this vllm instance on the
same machine would be http:https://localhost:8000/v1
. Make sure to include the
/v1
to the end of the URL.
Also note that --api-key
is defined by you. Set it to something hard to guess,
and probably random. Whatever you decide, pass it in to both --api-key
in
vllm, and --neuron.api_key
on the miner / vali
Running a miner through PM2 will require the LLM instance of your choice to be running.
pm2 start neurons/miner.py --name miner --interperter python3 -- --wallet.name [WALLET_NAME] --netuid 4 --wallet.hotkey [WALLET_HOTKEY] --subtensor.network finney --neuron.model_endpoint [MODEL_ENDPOINT] --nueron.api_key [NEURON_API_KEY] --axon.port [AXON_PORT] --logging.trace
Please replace the following with your specific configuration:
- [WALLET_NAME]
- [WALLET_HOTKEY]
- [MODEL_ENDPOINT]
- [NEURON_API_KEY]
- [AXON_PORT]
NOTE: Trace logging is very verbose. You can use --logging.info
instead for
less log bloat.
Additionally:
--blacklist.force_validator_permit [TRUE/FALSE]
is defaulted to true to force incoming requests to have a permit.
Running a validator through PM2 will require the LLM instance of your choice to be running.
pm2 start neurons/validator.py --name validator --interperter python3 -- --wallet.name [WALLET_NAME] --netuid 4 --subtensor.network finney --neuron.model_endpoint [MODEL_ENDPOINT] --neuron.api_key [NEURON_API_KEY]
Please replace the following with your specific configuration:
- [WALLET_NAME]
- [MODEL_ENDPOINT]
- [NEURON_API_KEY]
- --netuid ==> Subnet Netuid. Defaults to 4
- --neuron.epoch_length ==> Default epoch length (how often we set weights, measured in 12 second blocks). Defaults to 360
- --mock ==> Mock neuron and all network components. Defaults to False
- --neuron.model_endpoint ==> Endpoint to use for the OpenAi CompatibleClient. Defaults to "http:https://127.0.0.1:8000/v1"
- --neuron.model_name ==> Name of the model used for completion. Defaults to "mlabonne/NeuralDaredevil-7B"
- --neuron.api_key ==> API key for OpenAi Compatible API. Defaults to "12345"
- --neuron.name ==> Trials for this neuron go in neuron.root/ (wallet-cold - wallet-hot) / neuron.name. Defaults to miner
- --blacklist.force_validator.permit ==> If set, forces incoming requests to have a permit. Defaults to True
- --neuron.name ==> Trials for this neuron go in neuron.root/ (wallet-cold - wallet-hot) / neuron.name. Defaults to validator
- --neuron.timeout ==> The timeout for each forward call in seconds. Defaults to 12
- --neuron.sample_size ==> The number of miners to query in a single step. Defaults to 48
- --nueron.vpermit_tao_limit ==> The maximum number of TAO allowed to query a validator with a permit. Defaults to 4096
Project maintainers reserve the right to weigh the opinions of peer reviewers using common sense judgement and may also weigh based on merit. Reviewers that have demonstrated a deeper commitment and understanding of the project over time or who have clear domain expertise may naturally have more weight, as one would expect in all walks of life. Where a patch set affects consensus-critical code, the bar will be much higher in terms of discussion and peer review requirements, keeping in mind that mistakes could be very costly to the wider community. This includes refactoring of consensus-critical code. Where a patch set proposes to change the Targon subnet, it must have been discussed extensively on the discord server and other channels, be accompanied by a widely discussed BIP and have a generally widely perceived technical consensus of being a worthwhile change based on the judgement of the maintainers. That being said, Manifold welcomes all PR's for the betterment of the subnet and Bittensor as a whole. We are striving for improvement at every interval and believe through open communication and sharing of ideas will success be attainable.