{"id":24514904,"url":"https://github.com/kociumba/skydriver","last_synced_at":"2025-11-03T18:56:31.638Z","repository":{"id":250948068,"uuid":"835480528","full_name":"kociumba/SkyDriver","owner":"kociumba","description":"Bazaar info in your terminal","archived":false,"fork":false,"pushed_at":"2024-11-15T22:49:58.000Z","size":10302,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-01-22T01:14:40.351Z","etag":null,"topics":["cli","go","skyblock"],"latest_commit_sha":null,"homepage":"https://kociumba.github.io/SkyDriver/","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/kociumba.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":"2024-07-29T23:44:14.000Z","updated_at":"2024-11-15T22:50:01.000Z","dependencies_parsed_at":"2024-07-31T01:16:06.441Z","dependency_job_id":"7d43c2d3-a7bb-46b3-a6b0-edeca651135a","html_url":"https://github.com/kociumba/SkyDriver","commit_stats":null,"previous_names":["kociumba/skydriver"],"tags_count":8,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kociumba%2FSkyDriver","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kociumba%2FSkyDriver/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kociumba%2FSkyDriver/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kociumba%2FSkyDriver/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/kociumba","download_url":"https://codeload.github.com/kociumba/SkyDriver/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243716216,"owners_count":20336105,"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":["cli","go","skyblock"],"created_at":"2025-01-22T01:15:00.755Z","updated_at":"2025-10-24T21:04:23.993Z","avatar_url":"https://github.com/kociumba.png","language":"Go","readme":"# SkyDriver\n\n\u003c!-- TOC --\u003e\n- [SkyDriver](#skydriver)\n  - [Features](#features)\n  - [Usage](#usage)\n  - [Examples](#examples)\n  - [FAQ (not actually because this has 0 users 😭)](#faq-not-actually-because-this-has-0-users-)\n\u003c!-- TOC --\u003e\n\nSkyDriver is a companion application for Hypixel Skyblock, currently in early development.\n\n## Features\n\n\u003e [!IMPORTANT]\n\u003e There is a big update in v0.0.4 with a new prediction algorithm.\n\u003e To read more about it go to [notes](notes.md)\n\n\u003e [!WARNING]\n\u003e **Do not depend on the predictions.**\n\u003e They are purely for providing broad insights into the market. \u003cbr\u003e\n\u003e Always do your own research before flipping lots of coins.\n\nThe primary focus of SkyDriver is on bazaar data and flipping, with plans for future expansion. If you have ideas or suggestions for improvements, please [open an issue](https://github.com/kociumba/SkyDriver/issues/new/choose).\n\nSkyDriver generates a detailed breakdown of bazaar data sourced from the Hypixel API. This data is accessible via a public endpoint, meaning you do not need a Hypixel API key to utilize SkyDriver.\n\nThe current output format is as follows:\n\n- Command:\n\n```console\nSkyDriver -limit 100000 -sell 100000\n```\n\n- Output:\n  \n```\n╔═══════════════════════════════╦═════════╦════════╦══════════╦═══════════════════════════════╦════════════════════╗\n║Product/price limit: 100000.00 ║SellPrice║BuyPrice║Difference║         Weekly Trafic         ║Predicted/Confidence║\n╠═══════════════════════════════╬═════════╬════════╬══════════╬═══════════════════════════════╬════════════════════╣\n║1.  FINE_AQUAMARINE_GEM        ║22217.20 ║39409.20║17192.00  ║Sell:317284    |  Buy:190413   ║▼ -43.47/100.00%    ║\n║2.  ENCHANTED_CAKE             ║18028.53 ║34975.14║16946.61  ║Sell:102213    |  Buy:149330   ║▲ 0.32/60.00%       ║\n║3.  MAGMA_CREAM_DISTILLATE     ║4611.41  ║16657.69║12046.28  ║Sell:110370    |  Buy:31200    ║▼ -63.92/100.00%    ║\n║4.  HAMSTER_WHEEL              ║59745.58 ║68212.58║8466.99   ║Sell:432596    |  Buy:429592   ║▼ -57.53/100.00%    ║\n║5.  GLACITE_JEWEL              ║44873.70 ║53025.92║8152.22   ║Sell:199886    |  Buy:122002   ║▼ -12.57/80.00%     ║\n║6.  GOBLIN_EGG_YELLOW          ║2503.59  ║9990.90 ║7487.31   ║Sell:112769    |  Buy:74976    ║▼ -70.28/100.00%    ║\n║7.  FOUL_FLESH                 ║27898.44 ║34999.35║7100.91   ║Sell:337081    |  Buy:301615   ║▼ -58.41/100.00%    ║\n║8.  ENCHANTMENT_REJUVENATE_1   ║19854.46 ║26949.95║7095.49   ║Sell:317132    |  Buy:35152    ║▼ -59.01/100.00%    ║\n║9.  ENCHANTED_GLOWSTONE        ║51016.56 ║56943.24║5926.68   ║Sell:167883    |  Buy:147181   ║▲ 17.95/40.00%      ║\n║10. FINE_PERIDOT_GEM           ║42509.63 ║48399.20║5889.57   ║Sell:644392    |  Buy:749316   ║▼ -37.09/80.00%     ║\n╚═══════════════════════════════╩═════════╩════════╩══════════╩═══════════════════════════════╩════════════════════╝\n```\n\n\u003c!--As you may have noticed, there is a price limit feature that can be enforced. This is done by passing `-limit (price)` as an argument to SkyDriver, which restricts the results to products with an instant buy price below this value.--\u003e\n \n## Usage\n\nTo use SkyDriver, download the latest release from [releases](https://github.com/kociumba/SkyDriver/releases).\n\n\u003e [!TIP]\n\u003e If you have the latest version of [go](https://golang.org/doc/install) installed, you can run `go install -ldflags=\"-s -w\" github.com/kociumba/SkyDriver` to install SkyDriver and automatically add it to path.\n\u003e\n\u003e On windows the built binary will lack an icon and any other typical data when istalled this way.\n\nYou can run SkyDriver to retrieve a list of the 10 products with the highest price differences, or use the `-limit` option to filter items within your flipping budget.\n\nUse the `-sell` option followed by the number of sales per week to filter out items with fewer sales than specified.\n\n**New in v0.0.4**\n\nThe `-search` option allows you to search for items by part of their name. For example, searching for flawless will include all items with \"flawless\" in their name. To display a specific number of items, use the `-max` flag to set the maximum number of items to display.\n\nWith the release of v0.0.4, you can now set these flags in the cli interface.\n\nIf a value of the arguments is not passed, SkyDriver will prompt you to enter it in.\nThis can be skipped by just leaving the prompts blank or passing the `-skip` flag.\n\n**New in v0.0.6**\n\nYou can now use the `-json` flag to export results in JSON in this [schema](api/schema.json). This is all of the data shown in the normal table output.\nThe output is in a human readable format and ready for processing in tools like [jq](https://stedolan.github.io/jq/).\n\n\u003e [!TIP]\n\u003e The `-json` flag disables the prompts so you will have to set the parameters using other flags.\n\n**New in v0.0.7**\n\nThe prediction output now uses smoothing functions to normalize the values. You can now choose between different smoothing functions using the `-smooth` flag:\n- `none`: Raw values without modification *(Skydriver experience before v0.0.7)*\n- `sigmoid`: Sigmoid function *(The default if no -smooth flag is passed in, seemd to give the best results)*\n- `tanh`: Hyperbolic tangent function\n- `saturating`: Saturating linear function\n- `piecewise`: Piecewise smoothing function\n\nAll smoothing functions are documented in detail in [notes.md](notes.md).\n\n**New in v0.0.8**\n\nThe app now uses a configuration file to store the prediction weights. The file is located in `~/.skydriver/config.toml` *That is `C:\\Users\\\u003cusername\u003e\\.skydriver\\config.toml` for windows users*. Right now only the wights for the prediction are configurable but there are plans to add more, like for example themes.\n\n## Examples\n\n```console\nSkyDriver -search flawless -max 100\n```\n\nThis command will display up to 100 items that contain the word \"flawless\" in their name.\n\n```console\nSkyDriver -json -search flawless -max 100 | jq '.results | length'\n```\n\nThis command will pipe the output from SkyDriver into jq and return the number of search results found on the bazaar.\n\n```console\nSkyDriver -limit 10000000 -sell 100000 -max 100\n```\n\nThis command will display the top 100 items that have more than 100,000 sales per week and a sell price below 10,000,000.\n\n\u003e [!NOTE]\n\u003e SkyDriver filters items that have less than 100 buy and sell price, as well as items that are sold less than 10 times a week.\n\u003e \n\u003e This behaviour is turned off when searching and only items with 0 sell price and 0 buy price are filtered.\n\n\u003cdetails\u003e\n  \u003csummary\u003ePro tip 😎\u003c/summary\u003e\n\n\u003e [!TIP]\n\u003e Run `SkyDriver -max 10000000` to show a very long table of all the items on the bazaar.\n\n\u003c/details\u003e\n\n## FAQ (not actually because this has 0 users 😭)\n\n**Q:** Why? \u003cbr\u003e\n**A:** I enjoy command line interfaces, and retrieving data this way feels more intuitive to me. 🙂\n\n**Q:** Why not create a mod? \u003cbr\u003e\n**A:** I am most familiar with Go, and the Java ecosystem is a shithole (my condolences to all java devs out there 💀).\n\n**Q:** How do I [blank]? \u003cbr\u003e\n**A:** If you are having trouble with using SkyDriver, read any \nresource out there on cli apps and if you get past opening the app and your issues persists, \nplease [open an issue](https://github.com/kociumba/SkyDriver/issues/new/choose)\n\n**Q:** What is the prediction? \u003cbr\u003e\n**A:** The prediction comes from data collected through the bazaar API and helps you figure out if flipping an item will be profitable. If the prediction is positive, it means you're likely to make a profit; if it's negative, it's probably not worth it. The bigger the number, the higher the expected profit. Confidence shows how many of the seven internal indicators agree on whether the item will be profitable or not. For more info, check out the [model](notes.md)\n\u003e [!CAUTION]\n\u003e This model was made by me (a dumbass) and you should not soly rely on it.\n\u003e If you loose all your coins because you bet on something SkyDriver said was going to be profitable, that's on you.\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkociumba%2Fskydriver","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkociumba%2Fskydriver","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkociumba%2Fskydriver/lists"}