{"id":19765888,"url":"https://github.com/devopsforhumans/kumaone","last_synced_at":"2026-04-22T18:51:02.865Z","repository":{"id":218613576,"uuid":"745988667","full_name":"devopsforhumans/kumaone","owner":"devopsforhumans","description":"Automation friendly bulk action CLI helper for Uptime Kuma.","archived":false,"fork":false,"pushed_at":"2024-12-10T22:25:06.000Z","size":401,"stargazers_count":2,"open_issues_count":0,"forks_count":3,"subscribers_count":1,"default_branch":"dev","last_synced_at":"2026-03-11T21:59:05.712Z","etag":null,"topics":["automation","bulk-actions","cli","incident","kuma","maintenance","monitoring","python","rich","self-hosted","status-page","typer","uptime-kuma","uptime-kuma-api","uptime-monitor"],"latest_commit_sha":null,"homepage":"https://kumaone.rtfd.io","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"bsd-3-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/devopsforhumans.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","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":"AUTHORS.md","dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2024-01-20T18:48:33.000Z","updated_at":"2025-08-20T05:03:48.000Z","dependencies_parsed_at":"2024-01-23T01:28:40.406Z","dependency_job_id":"d7478698-640a-4f66-8b00-fe1a0b926a9b","html_url":"https://github.com/devopsforhumans/kumaone","commit_stats":null,"previous_names":["dalwar23/kumaone","devopsforhumans/kumaone"],"tags_count":10,"template":false,"template_full_name":null,"purl":"pkg:github/devopsforhumans/kumaone","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/devopsforhumans%2Fkumaone","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/devopsforhumans%2Fkumaone/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/devopsforhumans%2Fkumaone/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/devopsforhumans%2Fkumaone/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/devopsforhumans","download_url":"https://codeload.github.com/devopsforhumans/kumaone/tar.gz/refs/heads/dev","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/devopsforhumans%2Fkumaone/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32150396,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-22T17:06:48.269Z","status":"ssl_error","status_checked_at":"2026-04-22T17:06:19.037Z","response_time":58,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":["automation","bulk-actions","cli","incident","kuma","maintenance","monitoring","python","rich","self-hosted","status-page","typer","uptime-kuma","uptime-kuma-api","uptime-monitor"],"created_at":"2024-11-12T04:20:03.157Z","updated_at":"2026-04-22T18:50:59.950Z","avatar_url":"https://github.com/devopsforhumans.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# kumaone\n\n[![Hatch project](https://img.shields.io/badge/%F0%9F%A5%9A-Hatch-4051b5.svg)](https://github.com/pypa/hatch)\n[![PyPI - Version](https://img.shields.io/pypi/v/kumaone.svg)](https://pypi.org/project/kumaone)\n[![PyPI - Python Version](https://img.shields.io/pypi/pyversions/kumaone.svg)](https://pypi.org/project/kumaone)\n[![Documentation Status](https://readthedocs.org/projects/kumaone/badge/?version=latest)](https://kumaone.readthedocs.io/en/latest/?badge=latest)\n\n-----\n\n**Table of Contents**\n\n- [Note](#note)\n- [Virtualenv](#virtualenv)\n- [Installation](#installation)\n\n## Note\n\n`kumaone`'s primary objective is to enable users to perform bulk action in `uptime kuma` server. A very special thanks\nto the author and contributors of the project [uptime-kuma-api](https://github.com/lucasheld/uptime-kuma-api). `kumaone`\nis built by studying and understanding the code of `uptime-kuma-api` and in places I used some parts of the code as it\nis from `uptime-kuma-api`. Appreciate the outstanding work done by the author and contributors of both\n[uptime kuma](https://github.com/louislam/uptime-kuma) and `uptime-kuma-api` project.\n\n`kumaone` is a CLI application. Designed for bulk operations mainly from reading configuration files. `kumaone` is very\nearly in development. Contribution and constructive feedbacks are always welcome.\n\n## Virtualenv\n\n- Install `pipenv` from [here](https://pipenv.pypa.io/en/latest/)\n\n- Activate virtual environment\n\n  ```shell\n  pipenv shell\n  ```\n\n  \u003e if there are no virtual environment available (e.g. first use), a virtual environment will be created and activated\n    automatically.\n\n- Install dependencies\n\n  To install dependencies with `pipenv` use the following command\n\n  ```shell\n  pipenv install\n  ```\n\n  To install `dev` dependencies use `--dev` flag\n\n  ```shell\n  pipenv install --dev\n  ```\n\n## Installation\n\n```shell\npip install kumaone\n```\n\n## Installation (Dev)\n\n```shell\npip install -e .\n```\n\n## To Do List\n\n### Info\n\n- [x] Show information about `kumaone`\n\n### Configuration\n\n- [x] Show `uptime kuma` configuration (default/custom paths).\n- [x] Create `uptime kuma` configuration (default/custom path).\n- [x] Delete `uptime kuma` configuration.\n- [ ] Edit `uptime kuma` configuration.\n\n### Monitors\n\n- Supported Monitor types (tested)\n  - [x] HTTP\n  - [x] JSON_QUERY\n  - [x] PING\n- [x] List all monitors.\n- [x] List monitor by `groups` and `processes` also.\n- [x] Show details of a monitor by ID.\n- [x] Bulk `add` monitors from file(s).\n- [x] Bulk `delete` monitors from file(s).\n- [ ] Add single monitor from `inline` dictionary data.\n- [x] Delete single Monitor by name.\n- [x] Delete single monitor by id.\n\n### Status Page\n\n- [x] List all `staus page`(s).\n- [x] See details of a `single status page`.\n- [x] Add a new `status page`.\n- [x] Add status pages from file(s).\n- [x] Delete single status page by slug.\n- [x] Delete status page from file(s).\n\n### Notification\n\n- Supported notification providers (tested)\n  - [x] Discord\n  - [x] Email(SMTP)\n  - [x] Opsgenie\n  - [x] PagerDuty\n  - [x] Rocket.Chat\n  - [x] Slack\n  - [x] Teams\n  - [x] Webhook\n- [x] List all `notification`(s).\n- [x] See details of a `single notification` by name/id.\n- [ ] Add new notification (interactive).\n- [x] Add notifications from single file.\n- [x] Delete notification by name.\n- [x] Delete notification by id.\n- [x] Delete notifications from single file.\n\n### Maintenance\n\nTBA\n\n### Incident\n\nTBA\n\n### Change Password\n\n- [ ] Change password from CLI.\n- [ ] Update password in `kumaone` config.\n\n### Cleanup\n\n- [ ] Clear heartbeats.\n- [ ] Clear statistics.\n- [ ] Clear events.\n\n### Backlog\n\n- [ ] Don't stop the program if one monitor process runs into error.\n- [ ] Add debug logs for methods.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdevopsforhumans%2Fkumaone","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdevopsforhumans%2Fkumaone","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdevopsforhumans%2Fkumaone/lists"}