{"id":17031406,"url":"https://github.com/breandan/duckietown-shell","last_synced_at":"2025-04-23T22:01:09.531Z","repository":{"id":146966439,"uuid":"143775892","full_name":"breandan/duckietown-shell","owner":"breandan","description":null,"archived":false,"fork":false,"pushed_at":"2018-08-06T22:22:53.000Z","size":114,"stargazers_count":0,"open_issues_count":0,"forks_count":15,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-03-30T03:51:11.984Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":false,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/breandan.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.pdf","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2018-08-06T19:51:18.000Z","updated_at":"2018-08-06T22:22:55.000Z","dependencies_parsed_at":"2023-05-05T22:30:36.204Z","dependency_job_id":null,"html_url":"https://github.com/breandan/duckietown-shell","commit_stats":null,"previous_names":[],"tags_count":7,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/breandan%2Fduckietown-shell","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/breandan%2Fduckietown-shell/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/breandan%2Fduckietown-shell/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/breandan%2Fduckietown-shell/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/breandan","download_url":"https://codeload.github.com/breandan/duckietown-shell/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":250522299,"owners_count":21444511,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-10-14T08:24:02.275Z","updated_at":"2025-04-23T22:01:09.441Z","avatar_url":"https://github.com/breandan.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Duckietown Shell\n\n*Duckietown Shell* is a pure Python, easily distributable (no dependencies) utility for Duckietown and AI-DO participants.\n\nThe idea is that most of the functionality is implemented as Docker containers, and `dt-shell` provides a nice interface for that, so that user should not type a very long `docker run` command line.\n\nThe installation should just be, on any platform:\n\n    $ pip install --no-cache-dir --user -U duckietown-shell\n    $ dt help\n\nThat is, we should not require any other dependency beside standard cross-platform Python libraries.\n\n\n## Commands for Duckiebot setup\n\nThis starts the SD-card flashing procedure:\n\n    $ dt init-sd-card\n\nTODO: to implement\n\n\n##  Commands for AI-DO\n\n### AI-DO registration\n\nYou can register for the AI-DO via command line using:\n\n    $ dt aido18 register\n    First: ...\n    Last: ...\n    Email: ...\n    Password: ...\n\nThis also creates a remote account on the website.\n\n### AI-DO templates download\n\nThe subcommand `get-template` downloads the submission templates.\n\nDownloads the current template:\n\n    $ dt aido18 get-template TASK-LANG\n    checking out repository...\n\nWithout arguments, the program writes a list of available templates.\n\n\n### AI-DO login\n\nThe command `login` authenticates the AI-DO account. It is needed\nbefore running one of the next commands\n\n    $ dt aido18 login\n    Username: ...\n    Password: ...\n\n\n### AI-DO submissions\n\nThe command `submit` submits the entry in the current directory:\n\n    $ dt aido18 submit\n\n### Submissions status\n\nThe command `status` displays the status of the submitted entries:\n\n    $ dt aido18 status\n    jobname  task  docker hash  status\n    jobname  task  docker hash  status\n    ...\n\n\n## Commands for logs\n\nWrappers are provided for the [EasyLogs commands][easy_logs].\n\n    $ dt logs summary\n    $ dt logs download\n    $ dt logs copy\n    $ dt logs details\n    $ dt logs make-thumbnails\n    $ dt logs make-video\n\n[easy_logs]: http://docs.duckietown.org/software_devel/out/easy_logs.html\n\n### Summary, details\n\nQueries the list of logs that satisfy a query:\n\n    $ dt logs summary \"vehicle:yaf,length:\u003e120s\"\n\nShow more details about one log:\n\n    $ dt logs details 20171124170042_yaf\n\n### Download, copy\n\nDownloads logs to the local computer:\n\n    $ dt logs download 20171124170042_yaf\n\nCopies the logs to a specific directory:\n\n    $ dt logs copy -o ![output dir] 20171124170042_yaf\n    Creating ![output dir]/20171124170042_yaf.bag\n\n### Creating thumbnails\n\n    $ dt logs make-thumbnails 20171124170042_yaf\n\n### Creating videos:\n\nCreate a video of the camera data:\n\n    $ dt logs make-videos 20171124170042_yaf\n\n### Advanced configuration\n\nBy default, Duckietown Shell uses the folder `~/dt-data` for storing log data and other cache data.\n\nAlternatively, you can use the `--dt-data` argument to choose a different folder:\n\n    $ dt logs --dt-data ![dir] ![command]\n\nAlternatively, the directory can be specified using the environment variable `DT_DATA`.\n\n    $ DT_DATA=/tmp/data dt logs summary\n\n## Docker\n\nTo launch the Duckietown Shell in Docker, run the following command:\n\n`docker run -it duckietown/duckietown-shell`\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbreandan%2Fduckietown-shell","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbreandan%2Fduckietown-shell","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbreandan%2Fduckietown-shell/lists"}