#Model Management

This guide covers the complete lifecycle of MLC models - from discovery and download to cleanup and removal.

#Available Models

The package includes a prebuilt runtime optimized for the following models:

Note: These are the only models supported for direct download. For other models, you'll need to build MLC from source (documentation coming soon).

#Model Lifecycle

#Discovering Models

Get the list of models included in the runtime:

import { MLCEngine } from '@react-native-ai/mlc';

const models = await MLCEngine.getModels();

console.log('Available models:', models);
// Output: [{ model_id: 'Llama-3.2-3B-Instruct' }, ...]

#Creating Model Instance

Create a model instance using the mlc.languageModel() method:

import { mlc } from '@react-native-ai/mlc';

const model = mlc.languageModel('Llama-3.2-3B-Instruct');

#Downloading Models

Models need to be downloaded to the device before use.

import { MLCEngine } from '@react-native-ai/mlc';

await model.download();

console.log('Download complete!');

You can track download progress:

await model.download((event) => {
  console.log(`Download: ${event.status}`);
});

#Preparing Models

After downloading, prepare the model for inference:

await model.prepare();

#Using Models

Once prepared, use the model with AI SDK functions:

import { generateText } from 'ai';

const result = await generateText({
  model,
  prompt: 'Hello! Introduce yourself briefly.',
});

console.log(result.text);

#Unloading Models

Unload the current model from memory to free resources:

await model.unload();

#Removing Downloaded Models

Delete downloaded model files to free storage:

await model.remove();