DocsModels

Download from Hugging Face

tensai searches Hugging Face and downloads models itself. No account on tensai's side, an optional token on yours.

Search and discover

Models, then the Discover tab. It opens on Recommended for your device, then Popular on Hugging Face. Search by name, or paste the link of a repo or of a file: only Hugging Face links are accepted.

Filter with Fits my phone, and sort by downloads, likes, recent or size. The badges tell what a model offers: Tools, Thinking, Vision, and Gated when it needs a licence.

The Discover tab of Models: Recommended for your device with the phone's RAM, the filters above the list, and models marked Runs wellThe Discover tab of Models: Recommended for your device with the phone's RAM, the filters above the list, and models marked Runs well
Discover: Recommended for your device comes first, with the filters above it.

Choose a file

A repo page lists the GGUF files a phone can load, each with its fit, and marks the Recommended one. The readme is there too. Download shows the size before you tap.

A Hugging Face repo page in tensai: Choose a file, with the size and the fit of each quantization, and a Download button showing the sizeA Hugging Face repo page in tensai: Choose a file, with the size and the fit of each quantization, and a Download button showing the size
Choose a file: size and fit for each quantization.

Downloads

  • Downloads run in the background and show their progress in a notification, with Pause and Cancel.
  • Several downloads queue up. A paused or interrupted one resumes where it stopped.
  • On mobile data tensai asks first. Settings, Downloads, Download on mobile data lets you allow it for good.
  • A file that does not match the expected size or checksum fails instead of being added.
  • When it is done, the model is in Models, On device, ready to load.
Models, On device: a download in progress with its size, speed and time left, with Pause and Cancel, above two models marked Tight fit and Runs wellModels, On device: a download in progress with its size, speed and time left, with Pause and Cancel, above two models marked Tight fit and Runs well
A download in progress, with Pause and Cancel.

Gated models and the token

Some models are gated: you accept their licence on the Hugging Face site, with your account. tensai cannot do that for you.

  1. Accept the licence on the model's Hugging Face page.
  2. Create a read token in your Hugging Face account settings.
  3. In tensai: Settings, Downloads, Hugging Face token. Paste it and save.

The token stays on the phone. tensai checks it when you save it; with no connection it says Token saved, but it could not be checked. If Hugging Face refuses it, replace it, or remove it to keep downloading public models.

A gated model's page in tensai: the Gated badge, the message to accept its licence on the Hugging Face site and add a token in Settings, and an Open Settings buttonA gated model's page in tensai: the Gated badge, the message to accept its licence on the Hugging Face site and add a token in Settings, and an Open Settings button
A gated model: accept its licence, then add a token in Settings.

What leaves the phone

Searching and downloading send requests to Hugging Face, which sees your IP address and, if you added one, your token. Nothing else goes out. See Privacy.