Skip to main content

​
Prepare Your Model

Before publishing models, make sure you have completed the Account Setup.
Currently, KoalaVault only supports models in safetensors format. Models in other formats (e.g., GGUF) are not supported yet.
1

Install koava CLI Tool

The koava is the command-line tool of KoalaVault, used to encrypt and publish your LLM models.Install the koava command-line tool with HuggingFace CLI support:
pip install -U "koava[huggingface]"
2

Authentication Setup

  1. Login to koava with your API key (generate KoalaVault API key):
koava login
# Enter your KoalaVault API key when prompted
  1. Login to HuggingFace CLI (hf) with your token (generate HuggingFace Token, choose Write access):
hf auth login
# Enter your HuggingFace token when prompted
  1. Verify the authentication status:
koava status
You should see the authentication status as below:
# Version: 0.0.11
# Authentication: Authenticated
# Username: <your-username>
# Email: <your-email>
# Server: Connected 
# Hugging Face CLI: Logged in as <your-username>
3

Encrypt & Push Model

  1. Download Qwen3-0.6B to your local directory:
hf download Qwen/Qwen3-0.6B --local-dir ./qwen3-0.6b
  1. Encrypt and push your model to KoalaVault and HuggingFace:
koava push ./qwen3-0.6b
  1. Result: the model is now created on KoalaVault and Hugging Face.
    • Hugging Face repository (default: Private): koava push creates a private repository on Hugging Face to host the full encrypted model files. 
      https://huggingface.co/<your-hf-username>/qwen3-0.6b
      To make it public: open Settings → Repository visibility → Make public.
    • Decryption keys & metadata (hosted by KoalaVault): used for authorization checks and buyer isolation to ensure controlled execution. 
      https://www.koalavault.ai/<your-koalavault-username>/qwen3-0.6b

​
Set Model Pricing & Publish

1

Set Model Pricing

  1. Visit KoalaVault.ai and navigate to My Models
  2. Locate your newly pushed model from the list
  3. Click on the model to open its detail page
  4. Navigate to the Pricing tab and click Create Pricing Strategy
  5. Configure your pricing options:
    • Set a per-deployment price (or set to 0 USDT for free models)
Your pricing strategy must be published before buyers can see it. Draft strategies are not visible to the public.
2

Publish & Share Your Model

Once your pricing is set, you’re ready to publish! Click the Publish button on your model page to make it live.
You must first make your Hugging Face repository public before you can publish your model on KoalaVault.
🎉 Congratulations! Your model is now live on the KoalaVault marketplace! 🌟

​
Start Earning Automatically

Every time someone purchases your model, payments are automatically sent to your digital wallet via blockchain transactions. No manual invoicing, no payment delays – just instant, secure payments directly to you.Share your model and start monetizing:
  • Share your model page URL with your community
  • Post on social media (Twitter, LinkedIn, Reddit)
  • Include it in your research papers or blog posts
  • Add it to your GitHub README or personal website
The more you promote your model, the more deployments you’ll get, and the more revenue you’ll earn! Build your passive income stream with KoalaVault.

​
Next Steps

Now that you’ve published your model, you can:

Master the koava CLI

Deep dive into koava’s advanced features for model encryption, management, and publishing workflows

Test Your Encrypted Model

Deploy and test your own encrypted model to experience what buyers will see