Run’em
Describe your devops-tools, run them fast
Run’em runs a project's dev-ops tasks, in parallel, and gives you a blueprint of what those tasks are. Commands are instantly discoverable, run in parallel, and easily extensible.
Why Run’em?
- Jobs Manifest - discover tasks & onboard smoothly
- Parallel - get results quicker
- Simple - define task easily
- Extensible - add tasks, & reports quickly
- Filters - powerful task selection
- Visibility - see what you're running, & discover improvements.
- Beautiful - get graphs & metrics out of the box, then build custom reports.
Highlights
Jobs Manifest
The Jobs manifest (available via runem --help) gives you an overview and insights into
all job and tasks for a project. A single source of truth for all tasks.
This allows faster on-boarding, easier discovery, and better team communication. It makes access and visibility of tasks easier and better.
Parallel Execution
Save time by running dev-ops tasks in parallel, and by getting metrics on those runtimes.
Runem tries to run all tasks as quickly as possible, looking at resources, with dependencies.
NOTE: It is not yet a full resource analyser or dependency-execution graph, but by version 1.0.0 it will be.
Filtering
Use powerful and flexible filtering. Select or excluded tasks by tags, name and
phase. Chose the task to be run based on your needs, right now.
You can also customise filtering by adding your own command options.
See --tags, --not-tags, --jobs, --not-jobs, --phases and --not-phases.
Powerful Insights
Understand what ran, how fast, and what failed.
Quiet by Default: Focus on what matters, and reveal detail only when needed.
Quick Start
Install:
pip install runem
Optional shell completion (bash/zsh/fish):
pip install "runem[completion]"
Define a task:
`# .runem.yml
- job:
command: echo "hello world!"
Run:
runem
Run multiple commands in parallel, see timing, and keep output minimal. Need detail?
runem --verbose
Basic Use
Typical workflows are running all default jobs, filtering and viewing the job manifest &
help: Filter runem --help is your
radar—instantly mapping out every available task:
Help & Job Discovery
Agents can use the structured MCP server instead of scraping help output: Agent MCP Server
Configuration File
How and why to configure your projects .runem.yml file. How to scale up with
multi-phase configs, how to apply filters and how to configure runtime options:
Configuration
Default and Custom Reports
runem gives you basic performance metrics by default, and allows custom reporting like
code-coverage, or profiling reports:
Reports
Troubleshooting
Swift solutions to common issues: Troubleshooting & Known Issues
Contribute & Support
Brought to you by Lursight Ltd. and an open community. CONTRIBUTING.md ❤️ Sponsor
About Run’em
Run’em exists to accelerate your team’s delivery and reduce complexity. Learn about our Mission.
1 maintainer
Metadata
1 maintainer
Release files for runem 0.14.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| runem-0.14.0.tar.gz | 117.6 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| runem-0.14.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 189.4 kB
Release files / runem-0.14.0.tar.gz
| Download URL | runem-0.14.0.tar.gz |
|---|---|
| Size | 117.6 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
206031412ba45448df0e11b131d0d306b1ad12913fac132329c569a49a3c8639
|
|
BLAKE2b-256 checksum How to use checksums |
9b176db895b261e1522b2fd09a07bb34a91c7700da9abb42a31a7a43fd35a8f1
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.14.6
|
Release files / runem-0.14.0-py3-none-any.whl
| Download URL | runem-0.14.0-py3-none-any.whl |
|---|---|
| Size | 71.8 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
582e51d90cd80eae53a989c849608e6756e31ca586d48e41a5b6a80db5b2b1bb
|
|
BLAKE2b-256 checksum How to use checksums |
1688472bb4819e953c5d9c3643c7014ecc6edacb01576b73babbfaa18681c581
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.14.6
|
