allora/README.md

82 lines
3.1 KiB
Markdown
Raw Normal View History

2024-08-08 14:50:17 +03:00
# Basic ETH Price Prediction Node
This repository provides an example Allora network worker node, designed to offer price predictions for ETH. The primary objective is to demonstrate the use of a basic inference model running within a dedicated container, showcasing its integration with the Allora network infrastructure to contribute valuable inferences.
## Components
- **Worker**: The node that publishes inferences to the Allora chain.
- **Inference**: A container that conducts inferences, maintains the model state, and responds to internal inference requests via a Flask application. This node operates with a basic linear regression model for price predictions.
- **Updater**: A cron-like container designed to update the inference node's data by daily fetching the latest market information from Binance, ensuring the model stays current with new market trends.
Check the `docker-compose.yml` file for the detailed setup of each component.
## Docker-Compose Setup
A complete working example is provided in the `docker-compose.yml` file.
### Steps to Setup
1. **Clone the Repository**
2. **Copy and Populate Configuration**
2024-08-08 14:53:15 +03:00
2024-08-08 14:50:17 +03:00
Copy the example configuration file and populate it with your variables:
```sh
cp config.example.json config.json
```
3. **Initialize Worker**
2024-08-08 14:53:15 +03:00
2024-08-08 14:50:17 +03:00
Run the following commands from the project's root directory to initialize the worker:
```sh
2024-08-09 13:29:25 +03:00
chmod +x init.config
./init.config
2024-08-08 14:50:17 +03:00
```
These commands will:
- Automatically create Allora keys for your worker.
- Export the needed variables from the created account to be used by the worker node, bundle them with your provided `config.json`, and pass them to the node as environment variables.
4. **Faucet Your Worker Node**
2024-08-08 14:53:15 +03:00
2024-08-08 16:19:06 +03:00
You can find the offchain worker node's address in `./worker-data/env_file` under `ALLORA_OFFCHAIN_ACCOUNT_ADDRESS`. [Add faucet funds](https://docs.allora.network/devs/get-started/setup-wallet#add-faucet-funds) to your worker's wallet before starting it.
2024-08-08 14:50:17 +03:00
5. **Start the Services**
2024-08-08 14:53:15 +03:00
2024-08-08 14:50:17 +03:00
Run the following command to start the worker node, inference, and updater nodes:
```sh
docker compose up --build
```
To confirm that the worker successfully sends the inferences to the chain, look for the following log:
```
{"level":"debug","msg":"Send Worker Data to chain","txHash":<tx-hash>,"time":<timestamp>,"message":"Success"}
```
## Testing Inference Only
2024-08-08 19:21:15 +03:00
This setup allows you to develop your model without the need to bring up the offchain worker or the updater. To test the inference model only:
2024-08-08 14:50:17 +03:00
1. Run the following command to start the inference node:
```sh
docker compose up --build inference
```
Wait for the initial data load.
2. Send requests to the inference model. For example, request ETH price inferences:
2024-08-08 14:53:15 +03:00
2024-08-08 14:50:17 +03:00
```sh
curl http://127.0.0.1:8000/inference/ETH
```
Expected response:
```json
{"value":"2564.021586281073"}
2024-08-08 14:50:17 +03:00
```
3. Update the node's internal state (download pricing data, train, and update the model):
2024-08-08 14:53:15 +03:00
2024-08-08 14:50:17 +03:00
```sh
curl http://127.0.0.1:8000/update
```
Expected response:
```sh
2024-03-06 18:53:48 +03:00
0
2024-08-08 14:50:17 +03:00
```