{"id":20504022,"url":"https://github.com/lapce/tiron","last_synced_at":"2025-07-08T23:03:46.111Z","repository":{"id":231612104,"uuid":"782215085","full_name":"lapce/tiron","owner":"lapce","description":"Reasonable Automation Engine","archived":false,"fork":false,"pushed_at":"2024-04-17T14:03:42.000Z","size":166,"stargazers_count":77,"open_issues_count":1,"forks_count":0,"subscribers_count":5,"default_branch":"main","last_synced_at":"2025-04-13T20:48:06.361Z","etag":null,"topics":["configuration-management","infrastructure-automation","remote-execution"],"latest_commit_sha":null,"homepage":"https://tiron.run","language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/lapce.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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":"2024-04-04T21:24:36.000Z","updated_at":"2025-03-21T08:46:04.000Z","dependencies_parsed_at":"2024-04-15T21:34:36.226Z","dependency_job_id":"0329e4af-be27-4395-9362-79907c3bbbd4","html_url":"https://github.com/lapce/tiron","commit_stats":null,"previous_names":["lapce/lapon","lapce/tiron"],"tags_count":8,"template":false,"template_full_name":null,"purl":"pkg:github/lapce/tiron","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lapce%2Ftiron","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lapce%2Ftiron/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lapce%2Ftiron/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lapce%2Ftiron/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/lapce","download_url":"https://codeload.github.com/lapce/tiron/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lapce%2Ftiron/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":264363744,"owners_count":23596501,"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":["configuration-management","infrastructure-automation","remote-execution"],"created_at":"2024-11-15T19:35:41.900Z","updated_at":"2025-07-08T23:03:46.069Z","avatar_url":"https://github.com/lapce.png","language":"Rust","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n  \n  # Tiron\n  \n  **Reasonable Automation Engine**\n\u003c/div\u003e\n\n\u003cdiv align=\"center\"\u003e\n  \u003ca href=\"https://github.com/lapce/tiron/actions/workflows/ci.yml\" target=\"_blank\"\u003e\n    \u003cimg src=\"https://github.com/lapce/tiron/actions/workflows/ci.yml/badge.svg\" /\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://discord.gg/GK4uSQMT4X\" target=\"_blank\"\u003e\n    \u003cimg src=\"https://img.shields.io/discord/946858761413328946?logo=discord\" /\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://github.com/lapce/tiron/releases\" target=\"_blank\"\u003e\n    \u003cimg src=\"https://img.shields.io/github/v/release/lapce/tiron\" /\u003e\n  \u003c/a\u003e\n\u003c/div\u003e\n\n**Tiron** is an automation tool that's easy to use and aims to be as fast as possible. It’s agentless by using SSH and has a TUI for the outputs of the tasks. There is an example Tiron configuration [here](https://github.com/lapce/tiron/tree/main/examples/example_tiron_project).\n\n\u003cdiv align=\"center\"\u003e\n  \u003cimg width=\"894\" alt=\"Screenshot\" src=\"https://github.com/lapce/tiron/assets/1169480/0c53b83e-901b-410e-afc3-3a4aa4917b93\"\u003e\n\u003c/div\u003e\n\n## Features\n* **No YAML:** Tiron uses [HCL](https://github.com/hashicorp/hcl) as the configuration language.\n* **Agentless:** By using SSH, Tiron connects to the remote machines without the need to install an agent first.\n* **TUI:** Tiron has a built in terminal user interfaces to display the outputs of the running tasks.\n* **Correctness:** Tiron pre validates all the runbook files and will throw errors before the task is started to execute.\n* **Speed:** On validating all the input, Tiron also pre populates all the data for tasks, and send them to the remote machines in one go to save the roundtrips between the client and remote.  \n* **LSP:** Tiron provides a LSP server which can provide syntax highlighting, linting, formatting, code jumps, completion etc. \n\n## Quickstart\n\nRun below to install latest Tiron binary to ```/usr/local/bin```\n```bash\ncurl -sL https://tiron.run/install.sh | sh\n```\n\nMore information can be found in the [docs](https://tiron.run/docs/getting-started/overview/).\n\n## Usage\n\nTo run a Tiron runbook\n\n```console\n$ tiron run\n```\n\nFull usage:\n\n```console\n$ tiron -h\n\nA reasonable automation engine\n\nUsage: tiron \u003cCOMMAND\u003e\n\nCommands:\n  run     Run Tiron runbooks\n  check   Check Tiron runbooks\n  fmt     Format Tiron runbooks\n  action  Show Tiron action docs\n  help    Print this message or the help of the given subcommand(s)\n\nOptions:\n  -h, --help     Print help\n  -V, --version  Print version\n```\n\n## TUI Navigation\n\n| Key                               | Action                |\n| --------------------------------- | ------------          |\n| \u003ckbd\u003ej\u003c/kbd\u003e                      | Scroll down           |\n| \u003ckbd\u003ek\u003c/kbd\u003e                      | Scroll up             |\n| \u003ckbd\u003ed\u003c/kbd\u003e                      | Page down             |\n| \u003ckbd\u003eu\u003c/kbd\u003e                      | Page up               |\n| \u003ckbd\u003eg\u003c/kbd\u003e                      | Jump to top           |\n| \u003ckbd\u003eG\u003c/kbd\u003e                      | Jump to bottom        |\n| \u003ckbd\u003en\u003c/kbd\u003e                      | Next Host             |\n| \u003ckbd\u003ep\u003c/kbd\u003e                      | Previous Host         |\n| \u003ckbd\u003eCtrl+n\u003c/kbd\u003e                 | Next Run              |\n| \u003ckbd\u003eCtrl+p\u003c/kbd\u003e                 | Previous Run          |\n\n## License\nTiron is licensed under the Apache 2.0 license.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flapce%2Ftiron","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flapce%2Ftiron","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flapce%2Ftiron/lists"}