Previous
Module dependencies
The
The
Name | Type | Inclusion | Description |
---|---|---|---|
module_id | string | Required | The module ID, which includes either the module namespace or organization ID, followed by its name.CautionThe |
visibility | string | Required | Whether the module is accessible only to members of your organization (private ), or visible to all Viam users (public ). You can later make a private module public using the viam module update command. Once you make a module public, you can change it back to private if it is not configured on any machines outside of your organization. |
url | string | Required for cloud build | The URL of the GitHub repository containing the source code of the module. Cloud build will fail if you do not provide this. Optional for local modules. |
description | string | Required | A description of your module and what it provides. |
models | object | Required | A list of one or more models provided by your custom module. You must provide at least one model, which consists of an You are strongly encouraged to include a |
entrypoint | string | Required | The name of the file that starts your module program. This can be a compiled executable, a script, or an invocation of another program. If you are providing your module as a single file to the upload command, provide the path to that single file. If you are providing a directory containing your module to the upload command, provide the path to the entry point file contained within that directory. |
build | object | Optional | An object containing the command to run to build your module, as well as optional fields for the path to your dependency setup script, the target architectures to build for, and the path to your built module. Use this with the Viam CLI's build subcommand. |
markdown_link | string | Optional | Link to the documentation (README) for this module. The Viam app uses this to render your README on your module's page in the registry. Similar to the markdown_link within the models object (described above), which allows the app to render info for a specific model in the configuration panel. |
$schema | string | Optional | Enables VS Code hover and autocomplete as you edit your module code. Gets auto-generated when you run viam module generate or viam module create . Has no impact on the module's function. |
Was this page helpful?
Glad to hear it! If you have any other feedback please let us know:
We're sorry about that. To help us improve, please tell us what we can do better:
Thank you!