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, and local inference. 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. The Hub serves bounded, signed dependency 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.

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, 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.