@golem-sdk/task-executor
Advanced tools
A golem-js based library allowing running computation tasks on Golem, designed for batch map-reduce like scenarios
TaskExecutor facilitates building of applications that utilize the computational power of the Golem Network in a transparent and efficient manner. It is a @golem-sdk/golem-js based library allowing running computation tasks, designed for batch map-reduce like scenarios.
With TaskExecutor, developers can focus on implementing their computational tasks without delving into the details of communicating with the Golem Network or managing modules such as payments or market.
To use task-executor, it is necessary to have yagna installed, with a recommended minimum version of v0.15.0. Yagna is a
service that communicates and performs operations on the Golem Network, upon your requests via the SDK. You
can follow these instructions
to set it up.
In order to get started and on Golem Network and obtain test GLM tokens (tGLM) that will allow you to build on the
test network, follow these steps:
# Join the network as a requestor
curl -sSf https://join.golem.network/as-requestor | bash -
# Start the golem node on your machine,
# you can use `daemonize` to run this in background
yagna service run
# IN SEPARATE TERMINAL (if not daemonized)
# Initialize your requestor
yagna payment init --sender --network holesky
# Request funds on the test network
yagna payment fund --network holesky
# Check the status of the funds
yagna payment status --network holesky
app-key to use with TaskExecutorIf you don't have any app-keys available from yagna app-key list, go ahead and create one with the command below.
You will need this key in order to communicate with yagna from your application via golem-js.You can set it
as YAGNA_APPKEY environment variable.
yagna app-key create my-golem-app
@golem-sdk/task-executor is available as a NPM package.
npm install @golem-sdk/task-executor
To build a library available to the Node.js environment:
npm run build
This will generate production code in the dist/ directory ready to be used in your Node.js or browser applications.
import { TaskExecutor } from "@golem-sdk/task-executor";
import { pinoPrettyLogger } from "@golem-sdk/pino-logger";
(async function main() {
const executor = await TaskExecutor.create({
logger: pinoPrettyLogger({ level: "info" }),
demand: {
workload: {
imageTag: "golem/alpine:latest",
},
},
market: {
rentHours: 0.5,
pricing: {
model: "linear",
maxStartPrice: 0.5,
maxCpuPerHourPrice: 1.0,
maxEnvPerHourPrice: 0.5,
},
},
});
try {
await executor.run(async (exe) => console.log((await exe.run("echo 'Hello World'")).stdout));
} catch (error) {
console.error("Computation failed:", error);
} finally {
await executor.shutdown();
}
})();
The examples directory in the repository contains various usage patterns for the TaskExecutor. You can browse through them and learn about the recommended practices. All examples are automatically tested during our release process.
In case you find an issue with the examples, feel free to submit an issue report to the repository.
You can find even more examples and tutorials in the JavaScript API section of the Golem Network Docs.
The library is designed to work with LTS versions of Node (starting from 18) and with browsers.
The library uses the debug package to provide debug logs. To enable them, set the DEBUG environment variable to task-executor:* to see the related log lines. For more information, please refer to the debug package documentation.
Read the dedicated testing documentation to learn more about how to run tests of the library.
It is recommended to run unit tests and static code analysis before committing changes.
npm run lint
# and
npm run format
FAQs
A golem-js based library allowing running computation tasks on Golem, designed for batch map-reduce like scenarios
We found that @golem-sdk/task-executor demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 0 open source maintainers collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
RubyGems.org has added a new "maintainer" role that allows for publishing new versions of gems. This new permission type is aimed at improving security for gem owners and the service overall.
Security News
Node.js will be enforcing stricter semver-major PR policies a month before major releases to enhance stability and ensure reliable release candidates.
Security News
Research
Socket's threat research team has detected five malicious npm packages targeting Roblox developers, deploying malware to steal credentials and personal data.