Docs/Start here

Install & connect Infimal

Install the native Rust CLI, connect your account, and open the terminal dashboard.

Install the native CLI

Run the installer in a macOS or Linux terminal. It detects Apple Silicon, Intel, ARM64 or x86_64, verifies the SHA-256 checksum, and installs infimal in ~/.local/bin. No Python or administrator access is needed. Windows users can run it inside WSL.

Terminal / reference
curl -fsSL https://infimal.ai/install.sh | sh

Connect your account

Open Set up CLI from your dashboard, or visit /cli/. Sign in and create a named full-access key for your computer. Copy it once, run the command below, and paste it at the hidden prompt. The key is verified and saved locally.

Terminal / reference
infimal login --key
infimal whoami
infimal

Get comfortable

Press Tab to switch between navigation and content. Arrow keys work in the focused area; Enter opens a selection. Ctrl-K searches commands. Press g or ? for the guide. The layout adapts to your terminal size.

Terminal / reference
infimal tui --demo
infimal guide
infimal models list --json

Configure your environment

The saved credentials file is readable only by its owner and stores a separate key for each API URL. Do not place a key in command arguments, source code or URLs.

VariablePurpose
INFIMAL_API_URLAPI origin; defaults to https://api.infimal.ai
INFIMAL_API_KEYOverrides the locally saved credential
INFIMAL_CONFIG_DIRCredential directory; defaults to ~/.config/infimal
INFIMAL_INSTALL_DIRInstaller destination; defaults to ~/.local/bin
INFIMAL_INSTALL_VERSIONPin a published version when running the installer

Update Infimal

Run the same installer again. It verifies the new binary before replacing your current installation and keeps your credentials.

Terminal / reference
curl -fsSL https://infimal.ai/install.sh | sh

Python model authoring

The Python SDK is the authoring library for App, Endpoint, Scale and Batch declarations; it has no command of its own. The native CLI runs your module through it for infimal apps plan, apply and deploy, so install it in the environment that has your model code, or point INFIMAL_PYTHON at that interpreter.

Terminal / reference
python -m pip install infimal
infimal apps plan --help