Basic Usage

To use the engine, you can use our CLI hosted on maldeclabs/infinity-cli you will find how to install and the dependencies.

Use the -h flag to see CLI help

$ lua src/infinity-cli.lua -h
Usage: infinity-cli [-h] [-g {data:metadata,plugins,plugins:plugin}]
       [-m {get,post}] [-e <endpoint>] [-d <data>] [-r] [-f] [-v]

Infinity Engine CLI

Options:
   -h, --help            Show this help message and exit.
          -g {data:metadata,plugins,plugins:plugin},
   --gateway {data:metadata,plugins,plugins:plugin}
                         Specify which gateway you want to use
         -m {get,post},  Your plugin's endpoint method on the engine
   --method {get,post}
           -e <endpoint>,
   --endpoint <endpoint>
                         Your plugin's endpoint on the engine
       -d <data>,        Data to be passed to gateway
   --data <data>
   -r, --raw-data        Bring raw engine data without processing
   -f, --file            Specify if 'data' is a file
   -v, --version         Display the current version of the script

For more info, see https://github.com/maldeclabs/infinity-cli

Checking the plugins loaded by the engine

$ lua src/infinity-cli.lua -g plugins
[ Plugins List ]
  lua:
    state_memory : 0x47c2f
    scripts:
      1:
        name : example.lua
        path : plugins/example.lua
        type : file

Collecting file information using MetaData

$ lua src/infinity-cli.lua --raw-data -g data:metadata -d "Why do programmers prefer dark mode? Because light attracts bugs!" 
{
   "mime_type":"text/plain; charset=us-ascii",
   "sha256":"8e4bf126e62cf07de438599a8e043c3b998f4a59abc6cc7cde874b8118a6b015",
   "sha1":"608974e94107c504ed2e04cd80404e6f1f107f55",
   "sha512":"92ef4546765623308e1aef4682bb965bd10f60b0beef5b68bb12c8c2a0e5cfba1d7cd2c5bf213edc8890f19b0f5ca8a8e21e5509122d6e6e2e3fce50bb4e8e22",
   "sha224":"699b2227773b709b35a6c11d1d07d6b9c730789f38ce88e280d0f8af",
   "sha384":"9b1ee54e14080dbbbd417950606de168500747257755564c6d67483d7d5d2361b3b5faed2d0e4535189c5464da0b0f6e",
   "sha3_256":"164d7d5c98a14839cc04dfbec14672b59130d35d5136f94f344c75f7970f794a",
   "sha3_512":"633a7d1a2f286e9b1175534aa03c74409acc1ea90d2ea75cbe9b161f65cac0c0f0c2cb22d5df2c46cada3cbd87a56fe2d0afae34c692d0886088ec8222c0bfd5",
   "size":65,
   "creation_date":"2025-03-14",
   "entropy":4.202063582954583
}

use -f to specify whether --data is a path to a file example ; --data "/usr/bin/ls" -f

Hitting my plugin endpoints

You can create endpoints in your engine and use the cli to use them, just use the gateway plugins:plugin

Get method -

$ lua src/infinity-cli.lua -m get -e /engine/status  -g plugins:plugin
[ /engine/status ]
  engine:
    is_running : true
    server:
      bindaddr : 127.0.0.1
      port : 8081.0
      ssl_enable : false
      concurrency : 4.0

I made a get in my plugin that exposes an endpoint /engine/status

Post method -

Sending to the engine using the post method and a file to my plugin's endpoint

$ lua src/infinity-cli.lua -m post -e /engine/status  -g plugins:plugin --data /usr/bin/ls --file

[ /engine/test ]
 message : data received successfully

Configuration file

You can configure your cli by correctly passing the address and port among other values ​​of your engine.

Just modify your config file which is a json maldeclabs/infinity-cli/config.

{
    "api": {
        "addr": "127.0.0.1", // addr your engine
        "port": "8081", // port your engine
        "gateways": {
            "web": {
                "protocol": "http", // engine by default does not enable ssl
                "metadata": "/v1/engine/data/metadata",
                "plugins": "/v1/engine/plugins"
            },
            
            // continue