# harsxv/tinystatus

Tiny status page generated by a Python script

Repository: https://github.com/harsxv/tinystatus
Canonical: https://ross.abutalabs.com/products/tinystatus
Homepage: https://status.harry.id/
Language: Python
License: MIT
License Family: permissive
Topics: monitoring, monitoring-tool, status, status-page, hacktoberfest, hacktoberfest2024, hacktoberfest-accepted, python, python3
Last push: 2024-10-31T03:53:16+00:00

## Health v2 (maintenance only)
Score: 24/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 0, release rhythm 40, longevity 52
- inputs: {"age_days": 729, "days_push": 671, "days_rel": 678, "gap_med": 7, "n_releases_24m": 4}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1594, forks 93 (observed 2026-08-28T04:05:08.988374+00:00)

## What it is
TinyStatus is a lightweight Python script that monitors HTTP endpoints, ping hosts, and TCP ports, then generates a static, responsive status page with incident history. Service checks are configured via a simple YAML file, and the output HTML can be served from any web server.

## Use cases
- generate a status page for my self-hosted services
- monitor http endpoints and open ports with a simple script
- show uptime and incident history on a lightweight status page
- self-hosted alternative to hosted status page services
- check if my servers are up and publish results as html
- track service outages and maintenance windows on a public page

## When to choose
- you want a minimal, dependency-light status page without running a full monitoring stack like Uptime Kuma or Zabbix
- you prefer YAML-based configuration and static HTML output served by any web server
- you need both light and dark themes, service grouping, and incident history out of the box
- you are comfortable running a Python 3.11+ script continuously or via cron

## When to avoid
- you need alerting via email, Slack, or other notification channels
- you require distributed monitoring, agents, or metrics collection beyond simple up/down checks
- you want a dynamic dashboard with real-time updates rather than periodically regenerated static pages
- you need team collaboration features or multi-user incident management

## Facets
- artifact type: application
- maturity: active
- function: monitoring, templating, configuration-management
- domain: monitoring, self-hosted, web-development
- platform: python, self-hosted, cli
- tags: status-page, uptime-monitoring, static-site-generation, yaml-configuration, incident-history, light-dark-theme, hacktoberfest, devops, linux, macos

## Member repositories
- harsxv/tinystatus (main) score 24

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:05:08.988374+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T03:54:11.633219+00:00, confidence not recorded.
  - readme: https://github.com/harsxv/tinystatus (fetched 2026-08-28T04:05:08.988374+00:00, sha 189701549bc9)
  - homepage: https://status.harry.id/ (fetched 2026-08-29T11:24:56.553542+00:00, sha 0d15708fbc6e)
- Data as of 2026-08-30T08:39:29.467469+00:00.