Public local-first CLI

Ask IDA, from the terminal.

Ask IDA CLI is the regular user-facing command-line surface for local status, public explanations, signed catalog discovery, model downloads, local inference, read-only public leaderboard results, and explicit kernel-telemetry sharing. The public CLI stays separate from proprietary Hub authority and private training environments.

Local by default

The CLI keeps discovery, status, inference, and public explanations local. Network access is reserved for an explicit catalog refresh or model download, an anonymous read-only leaderboard query, or an operator-invoked telemetry share. The Hub serves bounded public metadata; it does not receive model bytes or local paths.

What it does

A small public surface with clear edges.

Inspect locally Check status, list locally available models, and read the bundled public explanation material without calling a private service.
Refresh deliberately Ask for the anonymous Hub catalog only when you invoke the catalog command; the response is bounded, signed, and versioned.
Resolve locally Download public model artifacts from the configured public host and verify their immutable revision and content hash before inference.
Fail closed Missing signatures, stale catalog metadata, unverified artifacts, legacy serialized weights, and unsupported hosts are rejected.
Command surface

Explicit actions, local results.

The public release keeps the ordinary user workflow visible without turning the CLI into a private operator console.

Status

ida status

Inspect the local CLI and runtime state without contacting a private service.

Catalog

ida catalog

Refresh the signed Hub dependency catalog on explicit request.

Explain

ida explain <query>

Search the bundled public documentation snapshot locally.

Models

ida model list

List locally resolved model state and public catalog metadata.

Download

ida model download

Fetch a public artifact only from the configured host and verify it before use.

Inference

ida ask

Run local inference with a model directory or approved public model identifier.

Public read

ida leaderboard list

Read confirmed public results through an anonymous, read-only HTTPS request. There is no submission or publication path.

Explicit sharing

ida telemetry

Inspect the local sharing boundary or explicitly validate and share an allowed kernel receipt. Sharing is disabled by default.

Install from source

Use the public repository directly.

The public repository carries the regular CLI code, public documentation bundle, and released verification key. It does not carry proprietary Hub authority, private prompts, private corpora, training runtimes, private Ask IDA receipts, workbooks, credentials, or deployment secrets.

git clone https://github.com/The-Hidden-Canopy/IDA_CLI-Public.git
cd IDA_CLI-Public
python -m pip install -e ".[runtime]"
ida status

Reviewed catalog entries remain catalog metadata until their immutable artifact attestation is complete. Experimental public IDs are opt-in and are not capability claims.

Support public research

Support the work behind the tools.

Donations help fund continued research and development across The Hidden Canopy ecosystem, including public interfaces, local-first tooling, evaluation, and the private native infrastructure behind Neural Forge.