radmah-cli

The rady command-line interface for the RadMah AI platform. (radmah is registered as an alias for operators who prefer the full brand — both resolve to the same binary.)

Requires Python 3.10 or newer. Versions in lockstep with radmah-sdk (rady --version reports the installed version).

What it does

rady auth login                                    # persistent OS-keyring credential
rady fabricate preview "200 account records"       # create a reviewed draft
rady fabricate approve <preview-id>                 # generate after approval
rady chat                                          # interactive AI assistant REPL
rady jobs list                                     # see your recent platform jobs
rady jobs wait <id>                                # block on a running job
rady jobs evidence <id>                            # sealed evidence bundle summary

rady --help lists every command group.

Architecture

• One package, same commands across Free, Sovereign, and Enterprise tiers — the only difference is the --base-url (or RADMAH_API_URL) the user points it at. Free + Sovereign default to https://api.radmah.ai; Enterprise customers point it at their own deployment's API URL (e.g. https://radmah.example.com). An https:// deployment on your private network (an RFC 1918 address or a name under .internal) needs an explicit opt-in: rady --allow-private-base-url <command> (the flag goes before the command) or export RADMAH_ALLOW_PRIVATE_BASE_URL=1, the same setting the SDK reads; export RADMAH_CA_BUNDLE when its certificate comes from your own CA. An http:// URL you give rady needs neither, as before 1.3.0; when its host is not this machine, rady prints a one-line warning on stderr, because the key crosses the network unencrypted. RADMAH_ALLOW_PRIVATE_BASE_URL=0 refuses private endpoints outright. Every command, rady ics techniques and rady jobs error included, goes through the SDK's transport and these rules. Cloud metadata endpoints are always refused, and a server's region redirect never carries the key from a public host, or from an http:// endpoint, to a host on your network.
• Credentials are stored in the OS-native credential store (macOS Keychain, Windows Credential Manager, Linux Secret Service) via the keyring library. No plaintext API keys on disk.
• All engine execution happens server-side — the CLI is a thin wrapper around the SDK which is a thin wrapper around the REST API. No engine code ever reaches the user's machine through this package, and every command works from this package alone.
• Rich output everywhere — progress spinners, colored outcome markers, tables, hints. The CLI is chatty by design.

Install

python3 -m pip install radmah-cli
rady --version

The install pulls radmah-sdk as a dependency. rady (and its radmah alias) appear on $PATH via the [project.scripts] entry in pyproject.toml.

Licence

Proprietary (LicenseRef-Proprietary); see the LICENSE file shipped with the package. You may read the source and use the unmodified package to access the RadMah AI platform under your account agreement; you may not copy, modify, redistribute or reuse it.