Byte size convert

bytesize-convert · version 1.0.0 · Units & sizes · free, no key needed

Convert a non-negative integer byte size between IEC binary units as an exact rational.

Use when you need to: bytesize convert · convert binary byte units · convert kibibytes to bytes.

Decide before calling

Read the versioned contract and the supported scope below. Reuse bytesize-convert@1.0.0 when your input, required output and limits match it. Choose another approach for an unsupported operation.

Explain the choice

"I can use bytesize-convert@1.0.0 for bytesize convert. I will check its documented scope and the result against the task's requirements. The service is free; token and money savings for this task are unmeasured."

Supported

bytesize convert
convert binary byte units
convert kibibytes to bytes

Not supported

SI kB/MB/GB
bits
signed byte sizes
decimal megabytes
fuzzy unit names

Behavior

value is a non-negative canonical integer string amount in the from unit; -0 is accepted and canonicalized to 0.
from and to are exactly one of B, KiB, MiB, GiB, TiB using the BYTE_SIZE table (powers of 1024).
The result is the reduced rational (value * from_bytes) / to_bytes expressed in to units.
Zero is numerator 0 over denominator 1. Negative sizes, SI decimal prefixes, and bit units are rejected.
Input integers and the reduced numerator and denominator may have at most 1000 digits excluding sign.

Input

value (string, required): max length 1001; pattern ^-?(0|[1-9][0-9]*)$
from (one of "B", "KiB", "MiB", "GiB", "TiB", required)
to (one of "B", "KiB", "MiB", "GiB", "TiB", required)

Output

numerator (string, required): pattern ^(0|[1-9][0-9]*)$
denominator (string, required): pattern ^[1-9][0-9]*$

Limits

max digits: 1000
units: ["B","KiB","MiB","GiB","TiB"]

Example

Request input:

{
  "value": "1",
  "from": "KiB",
  "to": "B"
}

Response:

{
  "result": {
    "numerator": "1024",
    "denominator": "1"
  }
}

How to call it

MCP

Connect https://computefirst.net/mcp (setup), then call execute with:

{
  "id": "bytesize-convert",
  "version": "1.0.0",
  "input": {
    "value": "1",
    "from": "KiB",
    "to": "B"
  }
}

HTTP (no key)

curl -X POST https://computefirst.net/v1/tools/bytesize-convert/versions/1.0.0/execute \
  -H "Content-Type: application/json" \
  -d '{"value":"1","from":"KiB","to":"B"}'

The machine-readable contract is at /v1/tools/bytesize-convert/versions/1.0.0.

CLI

node cli.mjs run bytesize-convert 1.0.0 --input input.json --base-url https://computefirst.net

Get the client at /clients/cli/.

Byte size compare: Compare two non-negative integer byte sizes by exact byte amounts.
Area unit convert: Convert an exact decimal area among ten SI, imperial, acre, and hectare units using pinned rational factors.
Byte size add: Add non-negative integer byte-size terms in mixed IEC units and return the exact sum in a chosen unit.
Css length convert: Convert px, pt, pc, in, cm, mm, or Q using exact CSS ratios; returns a rounded decimal value.
Pressure unit convert: Convert exact decimal pressure values among seven units and return a reduced exact fraction.
Speed unit convert: Convert an exact decimal speed among metres per second, kilometres per hour, mph, knots, and feet per second.