Skip to content
forked from viamrobotics/rdk

Viam Server - Robotic Development Kit

License

Notifications You must be signed in to change notification settings

gloriacai01/rdk

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

RDK (Robot Development Kit)

PkgGoDev

Viam provides an open source robot architecture that provides robotics functionality via simple APIs

Website: viam.com

Documentation: docs.viam.com

Cloud App: app.viam.com

Contact

If you have a bug or an idea, please open an issue here.

Building and Using

Dependencies

  • Install make.
  • Run make setup to install dev environment requirements.
    • This also installs some client side git hooks.

Build and Run

  • Build: make server. Then run ./bin/<your architecture>/server [parameters]
  • Run without building: go run web/cmd/server/main.go [parameters]

Example with a dummy configuration: go run web/cmd/server/main.go -config etc/configs/fake.json. Then visit http://localhost:8080 to access remote control.

Examples

SDKs

Multiple SDKs are available for writing client applications that interface with the Viam RDK.

Environment Variable Settings

Environment Variable Behavior Default Value
VIAM_RESOURCE_CONFIGURATION_TIMEOUT Duration for which resources are allowed to (re)configure. 1 minute
VIAM_MODULE_STARTUP_TIMEOUT Duration for which modules are allowed to startup. 5 minutes
ENV If set to "development", runs the frontend development server. Server runs normally

Development

Sign the Contribution Agreement before submitting pull requests.

API

The API is defined with Protocol Buffers/gRPC which can be found at https://github.com/viamrobotics/api.

Conventions

Committing

  • Follow git's guidance on commit messages:

Describe your changes in imperative mood, e.g. "make xyzzy do frotz" instead of "[This patch] makes xyzzy do frotz" or "[I] changed xyzzy to do frotz", as if you are giving orders to the codebase to change its behavior. Try to make sure your explanation can be understood without external resources. Instead of giving a URL to a mailing list archive, summarize the relevant points of the discussion.

Frontend

See documentation in Frontend Readme.

To start the client development environment, first run the same go run command mentioned in Building and Using, but with the environmental variable ENV=development (e.g. ENV=development go run web/cmd/server/main.go -debug -config etc/configs/fake.json).

If you are in the web/frontend directory this is aliased as npm run server.

You will additionally need to start a development server for client assets. To do this, navigate to web/frontend and run npm start (and npm install if doing this for the first time) in a new terminal tab. Visit localhost:8080 to view the app, not localhost:5173. The latter is the above-mentioned hot module replacement server that rebuilds frontend asset changes.

Frontend against a remote host

See documentation in Direct Remote Control.

License check

We run LicenseFinder in CI to verify 3rd-party libraries have approved software licenses. If you add a 3rd-party library to this project, please run make license-check to verify that it can be used.

For maintainers, here is how to make some common license policy changes:

Permit a new license (e.g. MIT):

https://github.com/pivotal/LicenseFinder#permitting-licenses

license_finder permitted_licenses add MIT

Associate a license with a dependency that is not automatically detected or incorrect:

https://github.com/pivotal/LicenseFinder#setting-licenses

license_finder licenses add my_new_dependency MIT

Approve a dependency outright - please include a reason if you do this!

https://github.com/pivotal/LicenseFinder#approving-dependencies

license_finder approvals add my_new_dependency --why="valid reason"

Please refer to the README at https://github.com/pivotal/LicenseFinder for information on how to make other license policy changes.

Windows Support (Experimental)

Windows 10 22H2 and up.

Development Dependencies

Support is not well tested yet.

Known Issues

License

Copyright 2021-2024 Viam Inc.

AGPLv3 - See LICENSE file

About

Viam Server - Robotic Development Kit

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Go 97.0%
  • Svelte 2.1%
  • TypeScript 0.6%
  • Shell 0.2%
  • Makefile 0.1%
  • HTML 0.0%