Running a Node
Learn how to set up and run your Dria Compute Node
Introduction
The Dria Compute Launcher is a simple and efficient way to set up and run the Dria Compute Node. The launcher automatically handles environment setup, model selection, and binary management, making it easy to start the node with minimal configuration.
Features
Settings Menu: Change various settings such as your wallet, ports and API keys, all without leaving the launcher.
Model Selection: Choose your models with a nice menu.
Model Benchmarking: Measure TPS for Ollama models to see if your machine can handle them.
Automatic Updates: Launcher will automatically update a running compute node when there is an update & restart it.
Version Control: You can select & run a specific compute node release.
Auto-detect Ollama: Launcher will check Ollama if you are using it’s model, and start its server if required.
Installation
Open a terminal and run the following command, it will ask for your user password:
Some Apple devices need you to bypass macOS’s security warning. If you see “macOS cannot verify that this app is free from malware” when using the launcher use the following command:
Open a terminal and run the following command, it will ask for your user password:
Some Apple devices need you to bypass macOS’s security warning. If you see “macOS cannot verify that this app is free from malware” when using the launcher use the following command:
Open a terminal in Administrator mode, and run the following command:
You may need to allow network access to the launcher if Windows prompts you to do so.
You can build from source using Rust & install the launcher globally using the command below:
The minimum supported rust version (MSRV) for the launcher is 1.81.0.
Usage
Double-click the executable or run it via the command line. Use help to see available options:
All commands that you see with help have their own help messages within as well, you can view it with:
Model Providers
The purpose of running a Dria Compute Node is to serve LLMs to the network. These models can either be locally-hosted models via Ollama, or API-based models such as Gemini and OpenAI.
Starting a Node
Start your node with start command:
When you are running for the first time, the launcher will prompt you to fill in node information, such as your private key, chosen models and their respective provider information.
You can stop the node with CTRL+C (on Linux / Windows) or CMD+C (on macOS)
Referrals Program
You can earn $DRIA points if you refer other users! When you refer a user, for each point they earn you earn a portion of those points as well. To get a referral code, enter someone’s referral code and such, use the following command:
Each referral code only has 10 uses! Once you have referred 10 users, your code will no longer work.
Changing Settings
You can use the settings command to change anything about your node:
You will be greeted with a menu, where you can navigate with arrow keys ↑ ↓ and select an option with enter ENTER:
Using this menu, you are able to change the following settings:
- Wallet: change your secret key
- Port: edit your listen address port, defaults to
4001 - Models: view all models & edit the models that you want to serve
- Ollama: edit host & port of the Ollama server
- API Keys: change API keys for providers
- Log Levels: change log-levels for modules within compute node & launcher
You can always exit the process (ungracefully) with CTRL+C (on Linux / Windows) or CMD+C (on macOS), or ESC on both systems.
Choosing Models
When you select Model option in the Settings menu, you will be greeted with a list of model providers:
Here, you can select a provider to choose models served by them, where you will be greeted with the following menu:
Within this menu you can navigate by using the arrow keys ↑ ↓ and press SPACE to select a model. You can select all models using →, or de-select everything with ←. To finish selecting models, press ENTER.
When you are done selecting models for all providers, you can go back to the main menu by selecting ← Go Back.
Measuring Local Models
You can test your machine’s performance on locally served Ollama models using the measure command:
Within Dria Knowledge Network, local models require you to reach a certain level of performance, typically at least 15 TPS (Tokens Per Second) on the evaluation metric, to be eligible for tasks. This command will measure your selected models, and then print a table of the results. We are particularly interested in Eval TPS and Total (ms) for our model performance.
Measurements the fail to meet the Compute Node requirements (e.g., below 15 Eval TPS) will be colored in red.
Displaying $DRIA Points
Use the points command to display how much you have earned!
Update Manually
Using the update command you can check for updates & automatically update your compute node and launcher.
You don’t need to do this usually, as the launcher will always check for updates when you run the start command.
Environment Editor
For more advanced users that would like to view the environment file in more detail & plain-text, we provide the env-editor command:
This command will open the selected environment file using a terminal-native text editor, allowing you to edit everything in it. If there happens to be multiple keys for a single value in the environment, the settings command will edit the last uncommented key on Save.
Running a Specific Release
Using the specific command you can choose to run a specific release:
This is completely optional, and should mostly be used for debugging and testing on the live network. When you run a specific release your node & launcher will not be automatically updated!
The Dria Knowledge Network always considers the latest minor version as the active version; therefore,
if the latest is 0.3.x and you decide to run a smaller version like 0.2.x you will most likely kept out of network due to protocol mismatch.