Skip to main content

Usage

For help:

Description

The push command is the recommended way to publish models to KoalaVault. It combines four steps into one:
  1. Create: Create the model on KoalaVault
  2. Encrypt: Convert safetensors files to encrypted format, insert compliance block into README.md and add LICENSE.KOALAVAULT (see Hugging Face Compliance for more details)
  3. Upload: Upload metadata to KoalaVault
  4. Publish: Create model on Hugging Face (private repository by default) and upload complete encrypted files, then update KoalaVault with Hugging Face URL and README
This is the easiest way for most users to publish their models.
Currently, KoalaVault only supports safetensors format files. Convert your model to safetensors format first if needed.

Examples

Advanced

Arguments

MODEL_PATH

Path to the directory containing your model files (required).

Options

—name, -n

Model name to be created on both KoalaVault and Hugging Face (defaults to directory name).

—description, -d

Model description for marketplace listing on KoalaVault.

—force, -f

Force encryption (overwrite backup) and upload (overwrite remote).

—public

Hugging Face Compliance: By default, the push command creates a private Hugging Face repository to ensure compliance with platform requirements for encrypted models. You can manually publish the repository on Hugging Face if needed.
Create a public Hugging Face repository instead of private (default: private).

Publishing Your Hugging Face Repository after push

After using push, your model will be available on Hugging Face as a private repository. To make it public:
  1. Visit your repository on Hugging Face: https://huggingface.co/your-username/model-name
  2. Click on Settings in the repository menu
  3. Scroll down to Repository visibility
  4. Click Make public and confirm

Related Commands

See also