Skip to content

Latest commit

 

History

History
65 lines (47 loc) · 2 KB

storage.md

File metadata and controls

65 lines (47 loc) · 2 KB

Files and storage

Default Tapioca home

  • macOS and Linux: ~/.tapioca
  • Windows: %USERPROFILE%\.tapioca

The current layout contains:

.tapioca/
├── models/       downloaded model weights and snapshots
├── adapters/     provider and imported LoRA weights with source metadata
├── recipes/      saved base-model and adapter combinations
├── voices/       reusable voice samples, transcripts, and metadata
├── runtime/      generated Python/MLX runtime environments
├── launch/       isolated coding-agent configuration
└── registry.json installed-model registry

Model directories use the resolved name and variant. For example:

~/.tapioca/models/glm-4.7-flash-q8_0/
~/.tapioca/models/flux2-klein-4b-q4-mlx/

Snapshot-based models contain the Hugging Face repository files. GGUF models usually contain one .gguf weight file.

Use another disk

Set TAPIOCA_HOME before running Tapioca:

export TAPIOCA_HOME="/Volumes/ExternalSSD/tapioca"
tapioca list

PowerShell:

$env:TAPIOCA_HOME = "D:\Tapioca"
tapioca list

Add the environment variable permanently using the operating system's normal environment settings if desired.

Release archives do not contain model weights. Leave enough free space for the download, runtime dependencies, temporary partial downloads, and outputs.

To reuse existing downloads or move weights between computers, follow Import and transfer. It explains how to:

  • import a raw .safetensors LoRA with tapioca adapter import;
  • copy the complete managed adapter library with its metadata; and
  • copy a catalog model directory and run tapioca pull MODEL to verify missing files and rebuild registration for the destination computer.

Do not copy registry.json by itself between computers. It stores absolute paths from the machine that created it.

The detailed LoRA composition and storage layout is documented in LoRA adapters.