What is kuma-importer?

kuma-importer is a command line tool for managing Uptime Kuma monitors as code. Uptime Kuma is a self hosted tool people use to watch whether their websites and services are online, and this project lets you define the monitors you want in a CSV or plain text file instead of clicking through a web interface to set each one up by hand. The tool grew out of the fact that managing many monitors manually in Uptime Kuma does not scale well. Instead, kuma-importer lets you write down your monitors as a list, then apply that list safely and repeatedly, so running it again does not create duplicates or break existing monitors. It ships with an interactive mode you can just run and follow along, as well as a proper command line command once installed. Getting started involves cloning the repository, creating a Python virtual environment, installing the listed dependencies, and running the main script, which then walks you through the process interactively. There is also an example CSV format showing columns like client name, monitor name, URL, monitor type, check interval, and retry settings, plus a simpler example text file listing just domain names. The README recommends always testing with a dry run option first, using consistent settings profiles, and treating the CSV file as the single source of truth for what monitors should exist. The README itself is fairly brief and does not go into detail about every command line option or how the tool talks to the Uptime Kuma API internally, relying instead on a companion Uptime Kuma API library. This project is aimed at developers and operations focused vibe coders who already run Uptime Kuma and want to manage their monitor list as a repeatable, version controlled file rather than through manual clicks. It is released under the MIT license.