The all encompassing LuxOS python library.
Project description
LuxOS Tools Repository
WARNING There are references into the PR luxos-code-refactoring
This repository contains scripts we built to operate and troubleshoot miners running LuxOS.
Install
There are few ways to install the luxos package:
-
Using pip (suggested for end-users):
pip install luxos pip install git+https://github.com/LuxorLabs/luxos-tooling.git@pr/luxos-code-refactoring
Using pip gives you access to the cli commands
luxos
andhealth-checker
as well the ability to import in python theimport luxos.api
api for luxos. -
A single drop in file (for support):
curl -LO https://github.com/LuxorLabs/luxos-tooling/raw/pr/luxos-code-refactoring/luxos.pyz
These are two standalone zipapp files, you can use from the command line as
python luxos.pyz
, no dependencies beside a recent-ish python version (eg. >= 3.10) -
From the github source checkout (for devs):
python -m venv venv source venv/bin/activate # for Windows: .\myenv\Scripts\activate) pip install -r tests/requirements.txt export PYTHONPATH=$(pwd)/src # for Windows: SET PYTHONPATH=%CD%\src (or) pip install -e .
LuxOS API Wrapper - luxos
This tool offers a convenient way to interact with LuxOS through a command-line interface (CLI) or as Python packages for more advanced integrations.
CLI Usage
The luxos.py script serves as a versatile LuxOS API wrapper, allowing users to interact with LuxOS features directly from the command line. Below are some basic examples:
python3 -m luxos --ipfile miners.csv --cmd rebootdevice --timeout 2
python3 -m luxos --range_start 192.168.1.0 --range_end 192.168.1.255 --cmd rebootdevice --verbose True
NOTE Please don't forget to set the PYTHONPATH.
Library Usage
If you prefer to integrate LuxOS functionality into your Python applications or scripts, luxos.py can also be used as a Python package. Here's a quick example:
from luxos.api import (execute_command)
execute_command("192.168.1.1", 4028, 2, "rebootdevice", "", False)
LuxOS HealthChecker - health_checker.py
The HealthChecker script is designed to continuously pull miner data from LuxOS, providing valuable insights into the health of your mining machines.
You can customize the HealthChecker params using the config.yaml
file provided.
To run the HealthChecker you can use health-checker
if you installed using pip, or
the cli python3 -m luxos.scripts.health_checker
.
Feel free to explore and customize these tools to suit your specific needs. If you encounter any issues or have suggestions for improvement, please open an issue or submit a pull request.
You can find LuxOS API documentation here.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.