{"id":16110818,"url":"https://github.com/theobrigitte/kimsufi-notifier","last_synced_at":"2025-04-09T23:14:36.799Z","repository":{"id":253493553,"uuid":"310347377","full_name":"TheoBrigitte/kimsufi-notifier","owner":"TheoBrigitte","description":"Availability bot notifier for OVH Eco and Kimsufi servers via Telegram and/or OpsGenie","archived":false,"fork":false,"pushed_at":"2025-02-16T07:19:36.000Z","size":1146,"stargazers_count":62,"open_issues_count":3,"forks_count":14,"subscribers_count":5,"default_branch":"main","last_synced_at":"2025-04-09T23:14:32.475Z","etag":null,"topics":["dedicated-server","kimsufi","notify","ovh","ovhcloud","telegram","telegram-bot"],"latest_commit_sha":null,"homepage":"https://t.me/KimsufiNotifierBot","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/TheoBrigitte.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":"2020-11-05T15:52:10.000Z","updated_at":"2025-03-11T13:43:17.000Z","dependencies_parsed_at":null,"dependency_job_id":"38bb2d03-bcd8-45ca-a3f7-20a9d0c1d71f","html_url":"https://github.com/TheoBrigitte/kimsufi-notifier","commit_stats":null,"previous_names":["theobrigitte/kimsufi-notifier"],"tags_count":14,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TheoBrigitte%2Fkimsufi-notifier","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TheoBrigitte%2Fkimsufi-notifier/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TheoBrigitte%2Fkimsufi-notifier/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TheoBrigitte%2Fkimsufi-notifier/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/TheoBrigitte","download_url":"https://codeload.github.com/TheoBrigitte/kimsufi-notifier/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248125591,"owners_count":21051770,"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":["dedicated-server","kimsufi","notify","ovh","ovhcloud","telegram","telegram-bot"],"created_at":"2024-10-09T19:39:33.895Z","updated_at":"2025-04-09T23:14:36.771Z","avatar_url":"https://github.com/TheoBrigitte.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n    \u003cimg src=\"assets/kimsufi-logo.webp\" alt=\"Kimsufi logo\" height=\"100px\"\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://github.com/TheoBrigitte/kimsufi-notifier/releases\"\u003e\u003cimg src=\"https://img.shields.io/github/release/TheoBrigitte/kimsufi-notifier.svg\" alt=\"Github release\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://github.com/TheoBrigitte/kimsufi-notificer/actions/workflows/go.yaml\"\u003e\u003cimg src=\"https://github.com/TheoBrigitte/kimsufi-notifier/actions/workflows/go.yaml/badge.svg\" alt=\"Github action\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n## About \u003cimg src=\"./assets/info.svg\" width=\"24\"\u003e\n\n[OVH Eco dedicated servers](https://eco.ovhcloud.com) are known for their low prices and high demand. As a result, they are often out of stock. This program is used to check for server availability, and to place order for servers. Note: the previous Bash script collection was moved to [`bash`](https://github.com/TheoBrigitte/kimsufi-notifier/tree/bash) branch.\n\nThis is my playground to learn how the OVH API works, it is then ported into a Telegram Bot at [https://t.me/KimsufiNotifierBot](https://t.me/KimsufiNotifierBot) which is more user-friendly and provides more features.\n\n## Features \u003cimg src=\"./assets/star.svg\" width=\"24\"\u003e\n\n- [List available servers](#list-available-servers) from OVH Eco catalog\n- [Check availability](#check-availability) of a specific server in one or multiple datacenters\n- [Order a server](#order-a-server) directly from the command line\n\n## Quickstart \u003cimg src=\"./assets/rocket.svg\" width=\"24\"\u003e\n\n### Using pre-built binaries\n\nDownload the latest release from the [Github releases page](https://github.com/TheoBrigitte/kimsufi-notifier/releases).\n\n### Using Go\n\n```\ngo install github.com/TheoBrigitte/kimsufi-notifier\nkimsufi-notifier\n```\n\n### Examples \u003cimg src=\"./assets/bash.svg\" width=\"24\"\u003e\n\n#### List available servers\n\nList servers from OVH Eco catalog in a specific country and from a specific category.\n\n```\n$ kimsufi-notifier list --category kimsufi\nplanCode          category    name                             price        status         datacenters\n--------          --------    ----                             -----        ------         -----------\n24ska01           Kimsufi     KS-A | Intel i7-6700k            4.99 EUR     unavailable\n25skle01          Kimsufi     KS-LE-1                          9.99 EUR     available      bhs\n25skleb01         Kimsufi     KS-LE-B                          9.99 EUR     available      bhs, fra, gra, waw\n25sklea01         Kimsufi     KS-LE-A                          9.99 EUR     available      bhs, fra, gra, waw\n25skled01         Kimsufi     KS-LE-D                          12.99 EUR    unavailable\n25sklec01         Kimsufi     KS-LE-C                          12.99 EUR    unavailable\n25sklee01         Kimsufi     KS-LE-E                          14.99 EUR    unavailable\n25skle02          Kimsufi     KS-LE-2                          15.99 EUR    unavailable\n24sk40            Kimsufi     KS-4 | Intel Xeon-E3 1230 v6     16.99 EUR    available      bhs, fra, gra\n24sk10            Kimsufi     KS-1 | Intel Xeon-D 1520         16.99 EUR    available      bhs\n24sk20            Kimsufi     KS-2 | Intel Xeon-D 1540         18.99 EUR    unavailable\n24sk30            Kimsufi     KS-3 | Intel Xeon-E3 1245 v5     18.99 EUR    unavailable\n...\n```\n\n#### Check availability\n\nCheck availability of a specific server in all datacenters.\n\n```\n$ kimsufi-notifier check --plan-code 25skle01\nplanCode    memory                storage              status         datacenters\n--------    ------                -------              ------         -----------\n25skle01    ram-16g-noecc-1333    softraid-2x480ssd    unavailable\n25skle01    ram-16g-noecc-1333    softraid-2x960ssd    unavailable\n25skle01    ram-16g-noecc-1333    softraid-3x2000sa    unavailable\n25skle01    ram-16g-noecc-1333    softraid-3x480ssd    unavailable\n25skle01    ram-32g-noecc-1333    softraid-2x480ssd    unavailable\n25skle01    ram-32g-noecc-1333    softraid-2x960ssd    unavailable\n25skle01    ram-32g-noecc-1333    softraid-3x2000sa    available      bhs\n25skle01    ram-32g-noecc-1333    softraid-3x480ssd    unavailable\n```\n\n#### Order a server\n\nPlace an order a specific server, the order is only placed and not payed for. The order can then be completed by following the URL provided in the output.\n\n```\n$ kimsufi-notifier order --plan-code 25skle01 --datacenter bhs --item-option memory=ram-32g-noecc-1333-25skle01,storage=softraid-3x2000sa-25skle01\n\u003e cart created id=dd413a3a-1eed-473c-bbe4-2a1c4f3d02c0\n\u003e cart item added id=299679179\n\u003e cart item configured: dedicated_os=none_64.en\n\u003e cart item configured: dedicated_datacenter=bhs\n\u003e cart item configured: region=europe\n\u003e cart option set: memory=ram-32g-noecc-1333-25skle01\n\u003e cart option set: storage=softraid-3x2000sa-25skle01\n\u003e cart option set: bandwidth=bandwidth-300-unguaranteed-25skle\n\u003e cart assigned\n\u003e order completed: url=https://www.ovh.com/cgi-bin/order/display-order.cgi?orderId=xxxxxxxxx\u0026orderPassword=xxxxxxxxxx\n ```\n\n More info on usage can be found in [USAGE.md](USAGE.md).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftheobrigitte%2Fkimsufi-notifier","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftheobrigitte%2Fkimsufi-notifier","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftheobrigitte%2Fkimsufi-notifier/lists"}