komal

Browse KöMaL (Mathematical and Physical Journal for High Schools) competition problems from the command line.

komal is a single pure-Go binary. No API key required.

Install

go install github.com/tamnd/komal-cli/cmd/komal@latest

Or grab a prebuilt binary from the releases, or run the container image:

docker run --rm ghcr.io/tamnd/komal:latest --help

Usage

# List this month's math problems
komal problems --month 202605

# Physics problems for April 2026
komal problems --month 202604 --subject fiz

# Output as JSON
komal problems --month 202605 -o json

# Table output with limit
komal problems --month 202605 -o table -n 10

Commands

Command	Description
problems	List problems from a KöMaL competition month
version	Show version information

Problems flags

-m, --month string     year-month in YYYYMM format, e.g. 202605 (required)
-s, --subject string   subject: mat|fiz|inf (default "mat")

Global flags

-o, --output string    output format: table|json|jsonl|csv|tsv|url|raw (default "auto")
-n, --limit int        limit number of records (0 = all)
    --fields strings   comma-separated columns to include
    --no-header        omit header row
    --template string  Go text/template per record
    --timeout duration per-request timeout (default 30s)
    --delay duration   minimum spacing between requests
    --retries int      retry attempts on 429/5xx (default 3)

License

Apache-2.0. See LICENSE.