Skip to content

Get up and running with Kimi, GLM, MiniMax, DeepSeek, gpt-oss, Qwen, Gemma and other models.

53.3 KB
Raw Blame
package server

import (
	"bytes"
	"cmp"
	"context"
	"crypto/sha256"
	"encoding/json"
	"errors"
	"fmt"
	"io"
	"log"
	"log/slog"
	"net"
	"net/http"
	"net/url"
	"os"
	"path/filepath"
	"runtime"
	"slices"
	"strconv"
	"strings"
	"time"

	"github.com/ollama/ollama/api"
	"github.com/ollama/ollama/envconfig"
	"github.com/ollama/ollama/manifest"
	"github.com/ollama/ollama/mlx"
	"github.com/ollama/ollama/model/parsers"
	"github.com/ollama/ollama/parser"
	"github.com/ollama/ollama/template"
	"github.com/ollama/ollama/thinking"
	"github.com/ollama/ollama/transfer"
	"github.com/ollama/ollama/types/model"
	"github.com/ollama/ollama/version"

	"golang.org/x/mod/semver"
)

// Blobs newer than this may belong to another process that has not written its
// manifest yet. They become eligible for the normal mark-and-sweep pass later.
const layerPruneGracePeriod = time.Hour

var (
	errCapabilities         = errors.New("does not support")
	errCapabilityCompletion = errors.New("completion")
	errCapabilityTools      = errors.New("tools")
	errCapabilityInsert     = errors.New("insert")
	errCapabilityVision     = errors.New("vision")
	errCapabilityAudio      = errors.New("audio")
	errCapabilityEmbedding  = errors.New("embedding")
	errCapabilityThinking   = errors.New("thinking")
	errCapabilityImage      = errors.New("image generation")
	errInsecureProtocol     = errors.New("insecure protocol http")
)

type registryOptions struct {
	Insecure bool
	Username string
	Password string
	Token    string

	CheckRedirect func(req *http.Request, via []*http.Request) error
}

type Model struct {
	Name               string `json:"name"`
	Config             model.ConfigV2
	ShortName          string
	ModelPath          string
	ModelShardPaths    []string
	DraftPath          string
	DraftShardPaths    []string
	ParentModel        string
	HasChatTemplate    bool
	HasGoTemplate      bool
	PreferChatTemplate bool // set when GGUF chat_template should take precedence over Go TEMPLATE
	AdapterPaths       []string
	ProjectorPaths     []string
	System             string
	License            []string
	Digest             string
	ManifestDigest     string
	Runner             string
	Options            map[string]any
	GenerationDefaults model.GenerationDefaults
	Messages           []api.Message

	Template       *template.Template
	templateDigest string

	// Metadata of the model blob and of each projector, read from their
	// metadata files when the model is loaded.
	metadata          ggufMetadata
	projectorMetadata []ggufMetadata
	// runnerSelection is empty when the platform's default preference selected
	// the manifest, or the explicitly requested runner otherwise.
	runnerSelection string
}

func (m *Model) IsMLX() bool {
	return m.Config.ModelFormat == "safetensors"
}

func (m *Model) isGGUF() bool {
	return m.Config.ModelFormat == "" || m.Config.ModelFormat == "gguf"
}

func (m *Model) modelPaths() []string {
	if m == nil || m.ModelPath == "" {
		return nil
	}
	paths := make([]string, 1, len(m.ModelShardPaths)+1)
	paths[0] = m.ModelPath
	return append(paths, m.ModelShardPaths...)
}

func generationDefaultsFromMetadata(md ggufMetadata) model.GenerationDefaults {
	return model.ParseGGUFGenerationDefaults(
		func(key string) (int64, bool) {
			n, ok := md.number(key)
			if !ok {
				return 0, false
			}
			if value, err := n.Int64(); err == nil {
				return value, true
			}
			value, err := n.Float64()
			if err != nil {
				return 0, false
			}
			return int64(value), true
		},
		func(key string) (float64, bool) {
			n, ok := md.number(key)
			if !ok {
				return 0, false
			}
			value, err := n.Float64()
			return value, err == nil
		},
	)
}

func appendCapability(capabilities []model.Capability, capability model.Capability) []model.Capability {
	if slices.Contains(capabilities, capability) {
		return capabilities
	}
	return append(capabilities, capability)
}

type templateCapabilitySource int

const (
	templateCapabilitySelected templateCapabilitySource = iota
	templateCapabilityGo
	templateCapabilityChat
)

// Capabilities returns the capabilities that the model supports
func (m *Model) Capabilities() []model.Capability {
	capabilities := m.capabilitiesForTemplate(templateCapabilitySelected)
	if len(capabilities) == 0 {
		slog.Warn("unknown capabilities for model", "model", m.Name)
	}

	return capabilities
}

// publicCapabilities limits decision models to decision and the vision they
// declare or ship a projector for, not vision inherited from a base model.
// Serving still uses Capabilities.
func (m *Model) publicCapabilities() []model.Capability {
	capabilities := m.Capabilities()
	if slices.Contains(capabilities, model.CapabilityDecision) {
		public := []model.Capability{model.CapabilityDecision}
		if slices.Contains(m.Config.Capabilities, "vision") || len(m.ProjectorPaths) > 0 {
			public = append(public, model.CapabilityVision)
		}
		return public
	}
	return capabilities
}

func (m *Model) capabilitiesForTemplate(source templateCapabilitySource) []model.Capability {
	capabilities := []model.Capability{}
	var modelArch string

	capabilities = m.configCapabilities(capabilities)
	capabilities, modelArch = m.ggufCapabilities(capabilities, source)
	capabilities = m.projectorCapabilities(capabilities)
	capabilities = m.templateCapabilities(capabilities, source)
	capabilities = m.parserCapabilities(capabilities)
	capabilities = m.modelFamilyCapabilities(capabilities)
	capabilities = m.filterUnsupportedCapabilities(capabilities, modelArch)

	return capabilities
}

func (m *Model) configCapabilities(capabilities []model.Capability) []model.Capability {
	for _, c := range m.Config.Capabilities {
		capabilities = appendCapability(capabilities, model.Capability(c))
	}
	return capabilities
}

func (m *Model) ggufCapabilities(capabilities []model.Capability, source templateCapabilitySource) ([]model.Capability, string) {
	if m.ModelPath == "" || !m.isGGUF() {
		return capabilities, ""
	}

	switch source {
	case templateCapabilitySelected:
		if !usesOllamaRenderedChat(m) {
			capabilities = chatTemplateCapabilities(capabilities, m.metadata.String("tokenizer.chat_template"))
		}
	case templateCapabilityChat:
		capabilities = chatTemplateCapabilities(capabilities, m.metadata.String("tokenizer.chat_template"))
	}
	switch {
	case m.metadata.String("decision.type") != "":
		capabilities = appendCapability(capabilities, model.CapabilityDecision)
	case m.metadata.Valid("pooling_type"):
		capabilities = appendCapability(capabilities, model.CapabilityEmbedding)
	default:
		// Otherwise, assume the model supports completion.
		capabilities = appendCapability(capabilities, model.CapabilityCompletion)
	}
	if m.metadata.Valid("vision.block_count") {
		capabilities = appendCapability(capabilities, model.CapabilityVision)
	}
	if m.metadata.Valid("audio.block_count") {
		capabilities = appendCapability(capabilities, model.CapabilityAudio)
	}

	return capabilities, m.metadata.String("general.architecture")
}

func chatTemplateCapabilities(capabilities []model.Capability, chatTemplate string) []model.Capability {
	if chatTemplate == "" {
		return capabilities
	}

	if chatTemplateHasToolSupport(chatTemplate) {
		capabilities = appendCapability(capabilities, model.CapabilityTools)
	}
	if thinking.TemplateSupportsThinking(chatTemplate) {
		capabilities = appendCapability(capabilities, model.CapabilityThinking)
	}

	return capabilities
}

func chatTemplateHasToolSupport(chatTemplate string) bool {
	return strings.Contains(chatTemplate, "tools") || strings.Contains(chatTemplate, "tool_call")
}

func chatTemplateHasToolRoundTrip(chatTemplate string) bool {
	if !chatTemplateHasToolSupport(chatTemplate) {
		return false
	}

	toolCalls := strings.Contains(chatTemplate, "tool_calls") || strings.Contains(chatTemplate, "assistant_tool_call")
	return toolCalls && (strings.Contains(chatTemplate, "tool_response") ||
		strings.Contains(chatTemplate, "tool_results") ||
		strings.Contains(chatTemplate, "role'] == 'tool'") ||
		strings.Contains(chatTemplate, `role'] == "tool"`) ||
		strings.Contains(chatTemplate, `role"] == 'tool'`) ||
		strings.Contains(chatTemplate, `role"] == "tool"`) ||
		strings.Contains(chatTemplate, `message.role == 'tool'`) ||
		strings.Contains(chatTemplate, `message.role == "tool"`) ||
		strings.Contains(chatTemplate, "ipython"))
}

// chatTemplateHasToolCallIDs detects Mistral-style templates that round-trip
// tool-call IDs via the [CALL_ID] token. Go templates cannot carry the ID, so
// these templates must win the renderer preference or multi-turn tool calls
// break. This applies to any model with such a template, not just migrated
// ones.
func chatTemplateHasToolCallIDs(chatTemplate string) bool {
	return strings.Contains(chatTemplate, "[CALL_ID]") && strings.Contains(chatTemplate, "tool_call.id")
}

func goTemplateCapabilities(t *template.Template) []model.Capability {
	if t == nil {
		return nil
	}

	v, err := t.Vars()
	if err != nil {
		slog.Warn("model template contains errors", "error", err)
		return nil
	}

	var capabilities []model.Capability
	if slices.Contains(v, "tools") {
		capabilities = appendCapability(capabilities, model.CapabilityTools)
	}
	if slices.Contains(v, "suffix") {
		capabilities = appendCapability(capabilities, model.CapabilityInsert)
	}

	openingTag, closingTag := thinking.InferTags(t.Template)
	if openingTag != "" && closingTag != "" {
		capabilities = appendCapability(capabilities, model.CapabilityThinking)
	}

	return capabilities
}

func goTemplateHasToolRoundTrip(t *template.Template) bool {
	if t == nil {
		return false
	}

	v, err := t.Vars()
	if err != nil || !slices.Contains(v, "tools") || !slices.Contains(v, "toolcalls") {
		return false
	}

	raw := t.String()
	return strings.Contains(raw, `eq .Role "tool"`) ||
		strings.Contains(raw, "tool_response") ||
		strings.Contains(raw, "TOOL_RESULTS")
}

func hasMoreCapabilities(candidate, current []model.Capability) bool {
	return len(candidate) > len(current)
}

func sameCapabilities(candidate, current []model.Capability) bool {
	if len(candidate) != len(current) {
		return false
	}
	for _, c := range candidate {
		if !slices.Contains(current, c) {
			return false
		}
	}
	return true
}

func shouldPreferChatTemplate(chatTemplate string, chatTemplateCaps []model.Capability, goTemplate *template.Template, goTemplateCaps []model.Capability) bool {
	if hasMoreCapabilities(chatTemplateCaps, goTemplateCaps) {
		return !goTemplateHasToolRoundTrip(goTemplate) || chatTemplateHasToolRoundTrip(chatTemplate)
	}

	if !sameCapabilities(chatTemplateCaps, goTemplateCaps) ||
		!slices.Contains(chatTemplateCaps, model.CapabilityTools) ||
		!slices.Contains(goTemplateCaps, model.CapabilityTools) {
		return false
	}

	if chatTemplateHasToolCallIDs(chatTemplate) {
		return true
	}

	return chatTemplateHasToolRoundTrip(chatTemplate) && !goTemplateHasToolRoundTrip(goTemplate)
}

func goTemplateEnvSet() bool {
	return envconfig.GoTemplate(true) == envconfig.GoTemplate(false)
}

func capabilityNames(capabilities []model.Capability) []string {
	names := make([]string, 0, len(capabilities))
	for _, capability := range capabilities {
		names = append(names, string(capability))
	}

	return names
}

// templateSource names which chat prompt source actually runs for the model,
// reusing the same predicate the template-selection log line reports.
func (m *Model) templateSource() string {
	return selectedTemplateSource(m, m.Template != nil && shouldUseHarmony(m))
}

func selectedTemplateSource(m *Model, usesHarmony bool) string {
	switch {
	case m.Config.Renderer != "" && m.Config.Parser != "":
		return "renderer_parser"
	case m.Config.Renderer != "":
		return "renderer"
	case m.Config.Parser != "":
		return "parser"
	case usesHarmony:
		return "harmony"
	case shouldUseGoTemplate(m):
		return "go_template"
	case m.HasChatTemplate:
		return "gguf_chat_template"
	default:
		return "none"
	}
}

func capabilityLogValue(present bool, capabilities []model.Capability) any {
	if !present {
		return "null"
	}

	return capabilityNames(capabilities)
}

func (m *Model) templateSelectionCapabilities(usesHarmony bool) (goTemplate, chatTemplate, harmony, rendererParser []model.Capability) {
	if m.HasGoTemplate {
		goTemplate = m.capabilitiesForTemplate(templateCapabilityGo)
	}
	if m.HasChatTemplate {
		chatTemplate = m.capabilitiesForTemplate(templateCapabilityChat)
	}
	if usesHarmony {
		harmony = m.capabilitiesForTemplate(templateCapabilitySelected)
	}
	if m.Config.Renderer != "" || m.Config.Parser != "" {
		rendererParser = m.capabilitiesForTemplate(templateCapabilitySelected)
	}

	return goTemplate, chatTemplate, harmony, rendererParser
}

func logTemplateSelection(m *Model) {
	usesHarmony := m.Template != nil && shouldUseHarmony(m)
	goTemplateCapabilities, chatTemplateCapabilities, harmonyCapabilities, rendererParserCapabilities := m.templateSelectionCapabilities(usesHarmony)

	slog.Info("template selection",
		"model", m.Name,
		"selected", m.templateSource(),
		"renderer", m.Config.Renderer,
		"parser", m.Config.Parser,
		"go_template", capabilityLogValue(m.HasGoTemplate, goTemplateCapabilities),
		"chat_template", capabilityLogValue(m.HasChatTemplate, chatTemplateCapabilities),
		"harmony", capabilityLogValue(usesHarmony, harmonyCapabilities),
		"renderer_parser", capabilityLogValue(m.Config.Renderer != "" || m.Config.Parser != "", rendererParserCapabilities),
	)
}

func (m *Model) projectorCapabilities(capabilities []model.Capability) []model.Capability {
	if len(m.ProjectorPaths) == 0 {
		return capabilities
	}

	capabilities = appendCapability(capabilities, model.CapabilityVision)
	for _, md := range m.projectorMetadata {
		if projectorHasAudio(md) && !projectorSuppressesAudioCapability(md) {
			capabilities = appendCapability(capabilities, model.CapabilityAudio)
		}
	}

	return capabilities
}

func (m *Model) templateCapabilities(capabilities []model.Capability, source templateCapabilitySource) []model.Capability {
	switch source {
	case templateCapabilitySelected:
		if m.HasGoTemplate && !shouldUseGoTemplate(m) {
			return capabilities
		}
	case templateCapabilityGo:
		if !m.HasGoTemplate {
			return capabilities
		}
	case templateCapabilityChat:
		return capabilities
	}

	for _, capability := range goTemplateCapabilities(m.Template) {
		capabilities = appendCapability(capabilities, capability)
	}

	return capabilities
}

func (m *Model) parserCapabilities(capabilities []model.Capability) []model.Capability {
	builtinParser := parsers.ParserForName(m.Config.Parser)
	if builtinParser == nil {
		return capabilities
	}

	if builtinParser.HasToolSupport() {
		capabilities = appendCapability(capabilities, model.CapabilityTools)
	}
	if builtinParser.HasThinkingSupport() {
		capabilities = appendCapability(capabilities, model.CapabilityThinking)
	}

	return capabilities
}

func (m *Model) modelFamilyCapabilities(capabilities []model.Capability) []model.Capability {
	isGptoss := slices.Contains([]string{"gptoss", "gpt-oss"}, m.Config.ModelFamily)
	if isGptoss {
		capabilities = appendCapability(capabilities, model.CapabilityThinking)
	}

	return capabilities
}

func (m *Model) filterUnsupportedCapabilities(capabilities []model.Capability, modelArch string) []model.Capability {
	if m.metadata.String("decision.type") != "" {
		capabilities = slices.DeleteFunc(capabilities, func(c model.Capability) bool {
			return c == model.CapabilityCompletion || c == model.CapabilityInsert ||
				c == model.CapabilityTools || c == model.CapabilityThinking
		})
	}
	if suppressAudioCapability(m, modelArch) {
		capabilities = slices.DeleteFunc(capabilities, func(c model.Capability) bool {
			return c == model.CapabilityAudio
		})
	}

	return capabilities
}

func suppressAudioCapability(m *Model, arch string) bool {
	if m.Config.ModelFormat == "safetensors" && m.Config.Renderer == "glimmer" {
		return true
	}
	if isNemotronSafetensors(m) {
		return true
	}

	if arch == "nemotron_h_omni" ||
		m.Config.ModelFamily == "nemotron_h_omni" ||
		slices.Contains(m.Config.ModelFamilies, "nemotron_h_omni") {
		// TODO: expose Nemotron3 audio once llama.cpp can skip or load the audio projector safely.
		return true
	}

	return false
}

func isNemotronSafetensors(m *Model) bool {
	return isNemotronSafetensorsConfig(m.Config)
}

func isNemotronSafetensorsConfig(cfg model.ConfigV2) bool {
	return cfg.ModelFormat == "safetensors" &&
		(cfg.Parser == "nemotron-3-nano" ||
			cfg.Renderer == "nemotron-3-nano" ||
			cfg.Parser == "nemotron-3.5-nano" ||
			cfg.Renderer == "nemotron-3.5-nano" ||
			cfg.ModelFamily == "nemotron_h_omni" ||
			slices.Contains(cfg.ModelFamilies, "nemotron_h_omni"))
}

func projectorHasAudio(md ggufMetadata) bool {
	// read directly: Keys reports qualified keys, the accessors qualify theirs
	for _, key := range md.Keys() {
		if key == "has_audio_encoder" || strings.HasSuffix(key, ".has_audio_encoder") {
			if b, ok := md.KV[key].(bool); ok && b {
				return true
			}
		}
	}

	return false
}

func projectorSuppressesAudioCapability(md ggufMetadata) bool {
	switch md.String("vision.projector_type") {
	case "gemma3nv":
		return true
	}

	return false
}

// CheckCapabilities checks if the model has the specified capabilities returning an error describing
// any missing or unknown capabilities
func (m *Model) CheckCapabilities(want ...model.Capability) error {
	available := m.Capabilities()
	var errs []error

	// Map capabilities to their corresponding error
	capToErr := map[model.Capability]error{
		model.CapabilityCompletion: errCapabilityCompletion,
		model.CapabilityTools:      errCapabilityTools,
		model.CapabilityInsert:     errCapabilityInsert,
		model.CapabilityVision:     errCapabilityVision,
		model.CapabilityAudio:      errCapabilityAudio,
		model.CapabilityEmbedding:  errCapabilityEmbedding,
		model.CapabilityThinking:   errCapabilityThinking,
		model.CapabilityImage:      errCapabilityImage,
		model.CapabilityDecision:   errors.New("decision"),
		model.CapabilitySpeech:     errors.New("speech"),
	}

	for _, cap := range want {
		err, ok := capToErr[cap]
		if !ok {
			slog.Error("unknown capability", "capability", cap)
			return fmt.Errorf("unknown capability: %s", cap)
		}

		if !slices.Contains(available, cap) {
			errs = append(errs, err)
		}
	}

	var err error
	if len(errs) > 0 {
		err = fmt.Errorf("%w %w", errCapabilities, errors.Join(errs...))
	}

	if slices.Contains(errs, errCapabilityThinking) {
		if m.Config.ModelFamily == "qwen3" || model.ParseName(m.Name).Model == "deepseek-r1" {
			// append a message to the existing error
			return fmt.Errorf("%w. Pull the model again to get the latest version with full thinking support", err)
		}
	}

	return err
}

func (m *Model) String() string {
	var modelfile parser.Modelfile

	modelfile.Commands = append(modelfile.Commands, parser.Command{
		Name: "model",
		Args: m.ModelPath,
	})

	for _, adapter := range m.AdapterPaths {
		modelfile.Commands = append(modelfile.Commands, parser.Command{
			Name: "adapter",
			Args: adapter,
		})
	}

	if m.DraftPath != "" {
		modelfile.Commands = append(modelfile.Commands, parser.Command{
			Name: "draft",
			Args: m.DraftPath,
		})
	}

	for _, projector := range m.ProjectorPaths {
		modelfile.Commands = append(modelfile.Commands, parser.Command{
			Name: "model",
			Args: projector,
		})
	}

	if m.Template != nil {
		modelfile.Commands = append(modelfile.Commands, parser.Command{
			Name: "template",
			Args: m.Template.String(),
		})
	}

	if m.System != "" {
		modelfile.Commands = append(modelfile.Commands, parser.Command{
			Name: "system",
			Args: m.System,
		})
	}

	if m.Config.Renderer != "" {
		modelfile.Commands = append(modelfile.Commands, parser.Command{
			Name: "renderer",
			Args: m.Config.Renderer,
		})
	}

	if m.Config.Parser != "" {
		modelfile.Commands = append(modelfile.Commands, parser.Command{
			Name: "parser",
			Args: m.Config.Parser,
		})
	}
	for _, capability := range m.Config.Capabilities {
		modelfile.Commands = append(modelfile.Commands, parser.Command{
			Name: "capability",
			Args: capability,
		})
	}

	for k, v := range m.Options {
		switch v := v.(type) {
		case []any:
			for _, s := range v {
				modelfile.Commands = append(modelfile.Commands, parser.Command{
					Name: k,
					Args: fmt.Sprintf("%v", s),
				})
			}
		default:
			modelfile.Commands = append(modelfile.Commands, parser.Command{
				Name: k,
				Args: fmt.Sprintf("%v", v),
			})
		}
	}

	for _, license := range m.License {
		modelfile.Commands = append(modelfile.Commands, parser.Command{
			Name: "license",
			Args: license,
		})
	}

	for _, msg := range m.Messages {
		modelfile.Commands = append(modelfile.Commands, parser.Command{
			Name: "message",
			Args: fmt.Sprintf("%s: %s", msg.Role, msg.Content),
		})
	}

	return modelfile.String()
}

// GetModel loads a model without constraining the runner, letting manifest
// lists resolve to the preferred child.
func GetModel(name string) (*Model, error) {
	return GetModelForRunner(name, "")
}

// GetModelForRunner returns model metadata for name, selecting runner from a
// manifest list when one is specified.
func GetModelForRunner(name, runner string) (*Model, error) {
	n := model.ParseName(name)
	mf, err := manifest.ParseNamedManifestForRunner(n, runner)
	if err != nil {
		return nil, err
	}
	return modelFromManifest(n, mf)
}

func modelFromManifest(n model.Name, mf *manifest.Manifest) (*Model, error) {
	manifestDigest := mf.SelectedDigest()
	if manifestDigest == "" {
		manifestDigest = mf.Digest()
	}

	m := &Model{
		Name:           n.String(),
		ShortName:      n.DisplayShortest(),
		Digest:         mf.Digest(),
		ManifestDigest: manifestDigest,
		Runner:         mf.Runner,
		Template:       template.DefaultTemplate,
	}

	if mf.Config.Digest != "" {
		if parsed, ok := mf.ParsedConfig(); ok {
			m.Config = parsed
		} else {
			filename, err := manifest.BlobsPath(mf.Config.Digest)
			if err != nil {
				return nil, err
			}

			configFile, err := os.Open(filename)
			if err != nil {
				return nil, err
			}
			defer configFile.Close()

			if err := json.NewDecoder(configFile).Decode(&m.Config); err != nil {
				return nil, err
			}
		}
		m.GenerationDefaults = m.Config.GenerationDefaults
	}

	modelHasPooling := false
	ggufChatTemplate := ""
	for _, layer := range mf.Layers {
		// Nothing below reads a tensor layer, and resolving a path costs a
		// syscall each. Named rather than allowlisting the types below, so a new
		// layer type is slower here instead of silently unread.
		if layer.MediaType == manifest.MediaTypeImageTensor {
			continue
		}

		filename, err := manifest.BlobsPath(layer.Digest)
		if err != nil {
			return nil, err
		}

		switch layer.MediaType {
		case "application/vnd.ollama.image.model":
			if m.ModelPath != "" {
				m.ModelShardPaths = append(m.ModelShardPaths, filename)
				break
			}
			m.ModelPath = filename
			m.ParentModel = layer.From
			if m.isGGUF() {
				md, err := readGGUFMetadata(layer.Digest)
				if err != nil {
					slog.Error("couldn't read model metadata", "error", err)
					break
				}
				m.metadata = md
				ggufChatTemplate = md.String("tokenizer.chat_template")
				m.HasChatTemplate = ggufChatTemplate != ""
				modelHasPooling = md.Valid("pooling_type")
				m.GenerationDefaults = generationDefaultsFromMetadata(md)
			}
		case manifest.MediaTypeImageDraft:
			if m.DraftPath == "" {
				m.DraftPath = filename
			} else {
				m.DraftShardPaths = append(m.DraftShardPaths, filename)
			}
		case "application/vnd.ollama.image.embed":
			// Deprecated in versions  > 0.1.2
			// TODO: remove this warning in a future version
			slog.Info("WARNING: model contains embeddings, but embeddings in modelfiles have been deprecated and will be ignored.")
		case "application/vnd.ollama.image.adapter":
			m.AdapterPaths = append(m.AdapterPaths, filename)
		case "application/vnd.ollama.image.projector":
			m.ProjectorPaths = append(m.ProjectorPaths, filename)
			if md, err := readGGUFMetadata(layer.Digest); err != nil {
				slog.Error("couldn't read projector metadata", "error", err)
			} else {
				m.projectorMetadata = append(m.projectorMetadata, md)
			}
		case "application/vnd.ollama.image.prompt",
			"application/vnd.ollama.image.template":
			m.HasGoTemplate = true
			m.templateDigest = layer.Digest
			bts, err := os.ReadFile(filename)
			if err != nil {
				return nil, err
			}

			m.Template, err = template.Parse(string(bts))
			if err != nil {
				return nil, err
			}
		case "application/vnd.ollama.image.system":
			bts, err := os.ReadFile(filename)
			if err != nil {
				return nil, err
			}

			m.System = string(bts)
		case "application/vnd.ollama.image.params":
			params, err := os.Open(filename)
			if err != nil {
				return nil, err
			}
			defer params.Close()

			// parse model options parameters into a map so that we can see which fields have been specified explicitly
			if err = json.NewDecoder(params).Decode(&m.Options); err != nil {
				return nil, err
			}
		case "application/vnd.ollama.image.messages":
			msgs, err := os.Open(filename)
			if err != nil {
				return nil, err
			}
			defer msgs.Close()

			if err = json.NewDecoder(msgs).Decode(&m.Messages); err != nil {
				return nil, err
			}
		case "application/vnd.ollama.image.license":
			bts, err := os.ReadFile(filename)
			if err != nil {
				return nil, err
			}
			m.License = append(m.License, string(bts))
		}
	}

	ggufCaps := chatTemplateCapabilities(nil, ggufChatTemplate)
	goCaps := goTemplateCapabilities(m.Template)
	usesHarmony := m.Template != nil && shouldUseHarmony(m)
	if !goTemplateEnvSet() && m.HasGoTemplate && ggufChatTemplate != "" && m.Config.Renderer == "" && m.Config.Parser == "" && !usesHarmony && shouldPreferChatTemplate(ggufChatTemplate, ggufCaps, m.Template, goCaps) {
		m.PreferChatTemplate = true
	}

	if m.ModelPath != "" && m.isGGUF() && !modelHasPooling && !m.HasChatTemplate && (!m.HasGoTemplate || !envconfig.GoTemplate(true)) && m.Config.Renderer == "" && m.Config.Parser == "" && !usesHarmony && m.metadata.String("decision.type") == "" {
		slog.Warn("model is missing tokenizer.chat_template and Go TEMPLATE support is unavailable; chat responses may be poorly formatted", "model", m.Name, "env", "OLLAMA_GO_TEMPLATE=1")
	}

	return m, nil
}

// CopyModel copies src to dst, returning a warning when a manifest list is
// narrowed to the children held locally.
func CopyModel(src, dst model.Name) (string, error) {
	if !dst.IsFullyQualified() {
		return "", model.Unqualified(dst)
	}
	if !src.IsFullyQualified() {
		return "", model.Unqualified(src)
	}

	if src.Filepath() == dst.Filepath() {
		return "", nil
	}

	data, err := manifest.ReadManifestData(src)
	if err != nil {
		return "", err
	}

	data, warning, err := narrowManifestListToLocal(data)
	if err != nil {
		return "", err
	}

	return warning, manifest.WriteManifestData(dst, data)
}

// narrowManifestListToLocal drops manifest list children whose manifests are
// not local, returning the rewritten document and a warning naming what went.
func narrowManifestListToLocal(data []byte) ([]byte, string, error) {
	var mf manifest.Manifest
	if err := json.Unmarshal(data, &mf); err != nil {
		return nil, "", err
	}
	if mf.MediaType != manifest.MediaTypeManifestList {
		return data, "", nil
	}

	var kept []manifest.Manifest
	var dropped []string
	for _, child := range mf.Manifests {
		if _, err := resolveShowManifestChild(child); err != nil {
			if !errors.Is(err, os.ErrNotExist) {
				return nil, "", err
			}
			dropped = append(dropped, cmp.Or(child.Runner, "unknown"))
			continue
		}
		kept = append(kept, child)
	}

	if len(dropped) == 0 {
		return data, "", nil
	}
	if len(kept) == 0 {
		return nil, "", fmt.Errorf("%w: pull one of %s before copying", manifest.ErrNoCompatibleManifest, strings.Join(dropped, ", "))
	}

	narrowed := mf
	narrowed.Manifests = kept
	out, err := json.Marshal(narrowed)
	if err != nil {
		return nil, "", err
	}

	var runners []string
	for _, child := range kept {
		runners = append(runners, cmp.Or(child.Runner, "unknown"))
	}
	warning := fmt.Sprintf("Warning: discarded %s (not pulled locally); copy contains %s",
		strings.Join(dropped, ", "), strings.Join(runners, ", "))

	return out, warning, nil
}

func PruneLayers() error {
	var candidates []string
	p, err := manifest.BlobsPath("")
	if err != nil {
		return err
	}

	blobs, err := os.ReadDir(p)
	if err != nil {
		slog.Info(fmt.Sprintf("couldn't read dir '%s': %v", p, err))
		return err
	}

	for _, blob := range blobs {
		if blob.IsDir() {
			continue
		}

		info, err := blob.Info()
		if err != nil {
			slog.Error("couldn't stat blob", "blob", blob.Name(), "error", err)
			continue
		}
		if time.Since(info.ModTime()) < layerPruneGracePeriod {
			continue
		}

		name := blob.Name()
		name = strings.ReplaceAll(name, "-", ":")

		_, err = manifest.BlobsPath(name)
		if err != nil {
			if errors.Is(err, manifest.ErrInvalidDigestFormat) {
				// remove invalid blobs (e.g. partial downloads)
				if err := os.Remove(filepath.Join(p, blob.Name())); err != nil {
					slog.Error("couldn't remove blob", "blob", blob.Name(), "error", err)
				}
			}

			continue
		}

		candidates = append(candidates, name)
	}

	slog.Info(fmt.Sprintf("total blobs: %d", len(candidates)))

	removed, err := manifest.RemoveUnreferencedBlobs(candidates...)
	if err != nil {
		slog.Error(fmt.Sprintf("couldn't remove unused layers: %v", err))
		return nil
	}
	pruneGGUFMetadata()

	slog.Info(fmt.Sprintf("total unused blobs removed: %d", len(removed)))

	return nil
}

func PushModel(ctx context.Context, name string, regOpts *registryOptions, fn func(api.ProgressResponse)) error {
	n := model.ParseName(name)
	fn(api.ProgressResponse{Status: "retrieving manifest"})

	if n.ProtocolScheme == "http" && !regOpts.Insecure {
		return errInsecureProtocol
	}

	manifestJSON, err := manifest.ReadManifestData(n)
	if err != nil {
		fn(api.ProgressResponse{Status: "couldn't retrieve manifest"})
		return err
	}

	var stored manifest.Manifest
	if err := json.Unmarshal(manifestJSON, &stored); err != nil {
		fn(api.ProgressResponse{Status: "couldn't retrieve manifest"})
		return err
	}

	var layers []manifest.Layer
	manifestMediaType := manifest.MediaTypeManifest

	if stored.MediaType == manifest.MediaTypeManifestList {
		layers, err = pushLayersForManifestList(stored)
		if err != nil {
			return err
		}
		manifestMediaType = manifest.MediaTypeManifestList
	} else {
		mf, err := manifest.ParseNamedManifest(n)
		if err != nil {
			fn(api.ProgressResponse{Status: "couldn't retrieve manifest"})
			return err
		}

		layers = append(layers, mf.Layers...)
		if mf.Config.Digest != "" {
			layers = append(layers, mf.Config)
		}

		if !hasTensorLayers(layers) {
			manifestJSON, err = json.Marshal(mf)
			if err != nil {
				return err
			}
		}
	}

	// Use fast transfer for models with tensor layers (many small blobs)
	if hasTensorLayers(layers) {
		if err := pushWithTransfer(ctx, n, layers, manifestJSON, manifestMediaType, regOpts, fn); err != nil {
			return err
		}
		fn(api.ProgressResponse{Status: "success"})
		return nil
	}

	for _, layer := range layers {
		if err := uploadBlob(ctx, n, layer, regOpts, fn); err != nil {
			slog.Info(fmt.Sprintf("error uploading blob: %v", err))
			return err
		}
	}

	fn(api.ProgressResponse{Status: "pushing manifest"})
	requestURL := n.BaseURL()
	requestURL = requestURL.JoinPath("v2", n.DisplayNamespaceModel(), "manifests", n.Tag)

	headers := make(http.Header)
	headers.Set("Content-Type", manifestMediaType)
	resp, err := makeRequestWithRetry(ctx, http.MethodPut, requestURL, headers, bytes.NewReader(manifestJSON), regOpts)
	if err != nil {
		return err
	}
	defer resp.Body.Close()

	fn(api.ProgressResponse{Status: "success"})

	return nil
}

func pushLayersForManifestList(parent manifest.Manifest) ([]manifest.Layer, error) {
	seen := make(map[string]struct{})
	var layers []manifest.Layer

	addLayer := func(layer manifest.Layer) error {
		if layer.Digest == "" {
			return nil
		}
		if _, ok := seen[layer.Digest]; ok {
			return nil
		}
		if layer.Size == 0 {
			p, err := manifest.BlobsPath(layer.Digest)
			if err != nil {
				return err
			}
			fi, err := os.Stat(p)
			if err != nil {
				return err
			}
			layer.Size = fi.Size()
		}
		seen[layer.Digest] = struct{}{}
		layers = append(layers, layer)
		return nil
	}

	for _, child := range parent.Manifests {
		childDigest := child.BlobDigest()
		if childDigest == "" {
			return nil, errors.New("manifest list child is missing digest")
		}
		// Resolve before sizing the child: its descriptor carries no size, so
		// addLayer would stat a missing blob and lose the actionable error.
		resolved, err := resolveShowManifestChild(child)
		if err != nil {
			if errors.Is(err, os.ErrNotExist) {
				// pull materializes only the selected child; the others stay
				// bare references until pulled explicitly.
				return nil, fmt.Errorf("manifest child for runner %q is not local; pull it with --runner %s before pushing", child.Runner, child.Runner)
			}
			return nil, err
		}

		if err := addLayer(manifest.Layer{
			MediaType: manifest.MediaTypeManifest,
			Digest:    childDigest,
		}); err != nil {
			return nil, err
		}

		for _, layer := range resolved.Layers {
			if err := addLayer(layer); err != nil {
				return nil, err
			}
		}
		if err := addLayer(resolved.Config); err != nil {
			return nil, err
		}
	}

	return layers, nil
}

func PullModel(ctx context.Context, name string, runner string, regOpts *registryOptions, fn func(api.ProgressResponse)) error {
	n := model.ParseName(name)

	// build deleteMap to prune unused layers
	deleteMap := make(map[string]struct{})
	existingDigests, err := manifest.ReferencedBlobDigestsForName(n)
	if errors.Is(err, os.ErrNotExist) {
		// noop
	} else if err != nil {
		slog.Warn("pulling model with bad existing manifest", "name", name, "error", err)
	} else {
		for _, digest := range existingDigests {
			if blob, err := manifest.BlobsPath(digest); err == nil {
				if _, err := os.Stat(blob); err == nil {
					deleteMap[digest] = struct{}{}
				}
			}
		}
	}

	if n.ProtocolScheme == "http" && !regOpts.Insecure {
		return errInsecureProtocol
	}

	fn(api.ProgressResponse{Status: "pulling manifest"})

	mf, manifestData, err := pullModelManifest(ctx, n, regOpts)
	if err != nil {
		return fmt.Errorf("pull model manifest: %s", err)
	}
	selectedChildDigest := ""
	if mf.MediaType == manifest.MediaTypeManifestList {
		var childDigest string
		mf, childDigest, err = pullSelectedManifest(ctx, n, mf, runner, regOpts, fn)
		if err != nil {
			return err
		}
		selectedChildDigest = childDigest
	} else if runner != "" {
		// The registry served a plain manifest, so there is no variant to
		// select. Honor an explicit runner request by rejecting a declared
		// mismatch instead of silently pulling whatever is stored. Manifests
		// without runner metadata cannot be checked before their config blob
		// is local, so they proceed as before.
		if mf.Runner != "" && !strings.EqualFold(mf.Runner, runner) {
			return fmt.Errorf("%w for runners: %s", manifest.ErrNoCompatibleManifest, runner)
		}
	}

	// Checked against the selected child: a manifest list carries no layers of
	// its own, so testing the parent would skip the gate entirely.
	if requiresMLX(mf) {
		if err := mlx.CheckInit(); err != nil {
			slog.Debug("MLX is unavailable for safetensors model pull", "error", err)
			return errors.New("this model requires MLX support, but the MLX runtime is not available")
		}
	}

	if err := checkModelRequires(ctx, n, mf, regOpts); err != nil {
		return err
	}

	var layers []manifest.Layer
	layers = append(layers, mf.Layers...)
	if mf.Config.Digest != "" {
		layers = append(layers, mf.Config)
	}

	// Use fast transfer for models with tensor layers (many small blobs)
	if hasTensorLayers(layers) {
		if err := pullWithTransfer(ctx, n, layers, manifestData, regOpts, fn); err != nil {
			return err
		}
		writePullDowngradeAnchor(n, mf, manifestData, selectedChildDigest)
		fn(api.ProgressResponse{Status: "success"})
		return nil
	}

	skipVerify := make(map[string]bool)
	for _, layer := range layers {
		cacheHit, err := downloadBlob(ctx, downloadOpts{
			n:       n,
			digest:  layer.Digest,
			regOpts: regOpts,
			fn:      fn,
		})
		if err != nil {
			return err
		}
		// If any download of a given digest was not a cache hit,
		// always verify it. Without this guard, a config entry
		// sharing a digest with a layer can overwrite the layer's
		// false (needs verification) with true (cache hit), since
		// the blob now exists on disk from the first download.
		if existing, ok := skipVerify[layer.Digest]; !ok {
			skipVerify[layer.Digest] = cacheHit
		} else {
			skipVerify[layer.Digest] = existing && cacheHit
		}
		delete(deleteMap, layer.Digest)
	}

	fn(api.ProgressResponse{Status: "verifying sha256 digest"})
	for _, layer := range layers {
		if skipVerify[layer.Digest] {
			continue
		}
		if err := verifyBlob(layer.Digest); err != nil {
			if errors.Is(err, errDigestMismatch) {
				fp, err := manifest.BlobsPath(layer.Digest)
				if err != nil {
					return err
				}
				if err := os.Remove(fp); err != nil {
					slog.Info(fmt.Sprintf("couldn't remove file with digest mismatch '%s': %v", fp, err))
				}
				removeGGUFMetadata(layer.Digest)
			}
			return err
		}
	}

	for _, layer := range layers {
		delete(deleteMap, layer.Digest)
	}
	delete(deleteMap, mf.Config.Digest)

	fn(api.ProgressResponse{Status: "writing manifest"})

	if err := manifest.WriteManifestData(n, manifestData); err != nil {
		slog.Info(fmt.Sprintf("couldn't write manifest for %s", n.DisplayShortest()))
		return err
	}

	writePullDowngradeAnchor(n, mf, manifestData, selectedChildDigest)

	slog.Debug("manifest written", "name", n.DisplayShortest(), "sha256", fmt.Sprintf("%x", sha256.Sum256(manifestData)), "size", len(manifestData))

	if !envconfig.NoPrune() && len(deleteMap) > 0 {
		fn(api.ProgressResponse{Status: "removing unused layers"})
		if _, err := manifest.RemoveUnreferencedBlobs(candidateBlobDigests(deleteMap)...); err != nil {
			fn(api.ProgressResponse{Status: fmt.Sprintf("couldn't remove unused layers: %v", err)})
		}
	}

	fn(api.ProgressResponse{Status: "success"})

	return nil
}

// requiresMLX reports whether serving mf needs the MLX runtime. A declared
// runner is authoritative; manifests predating runner metadata are judged by
// their tensor layers.
func requiresMLX(mf *manifest.Manifest) bool {
	if mf.Runner != "" {
		return strings.EqualFold(mf.Runner, manifest.RunnerMLX)
	}
	return hasTensorLayers(mf.Layers)
}

// hasTensorLayers checks if any layer has tensor media type.
func hasTensorLayers(layers []manifest.Layer) bool {
	for _, layer := range layers {
		if layer.MediaType == manifest.MediaTypeImageTensor {
			return true
		}
	}
	return false
}

func candidateBlobDigests(m map[string]struct{}) []string {
	digests := make([]string, 0, len(m))
	for digest := range m {
		digests = append(digests, digest)
	}

	return digests
}

// checkModelRequires makes sure the model is compatible with the local
// Ollama version before any model layers are downloaded.
func checkModelRequires(ctx context.Context, n model.Name, mf *manifest.Manifest, regOpts *registryOptions) error {
	if mf == nil || mf.Config.Digest == "" {
		return nil
	}

	if err := verifyBlob(mf.Config.Digest); err != nil {
		if !errors.Is(err, os.ErrNotExist) && !errors.Is(err, errDigestMismatch) {
			return err
		}
		if err := downloadWithTransfer(ctx, n, []manifest.Layer{mf.Config}, regOpts, func(api.ProgressResponse) {}); err != nil {
			slog.Debug("skipping requires check: config fetch failed", "model", n.DisplayShortest(), "error", err)
			return nil
		}
		if err := verifyBlob(mf.Config.Digest); err != nil {
			slog.Debug("skipping requires check: config verify failed", "model", n.DisplayShortest(), "error", err)
			return nil
		}
	}

	blobPath, err := manifest.BlobsPath(mf.Config.Digest)
	if err != nil {
		return err
	}
	data, err := os.ReadFile(blobPath)
	if err != nil {
		return err
	}

	var cfg model.ConfigV2
	if err := json.Unmarshal(data, &cfg); err != nil {
		return err
	}

	return checkPullRequires(cfg.Requires, version.Version)
}

// checkPullRequires reports whether the pulling client satisfies the model's
// declared minimum version.
func checkPullRequires(requires, clientVersion string) error {
	if requires == "" {
		return nil
	}
	if clientVersion == "0.0.0" {
		return nil
	}
	requires = "v" + strings.TrimPrefix(requires, "v")
	if !semver.IsValid(requires) {
		slog.Debug("ignoring malformed requires version", "requires", requires)
		return nil
	}
	// Prerelease builds must be able to test models targeting their release.
	currentVersion, _, _ := strings.Cut(semver.Canonical("v"+clientVersion), "-")
	if semver.Compare(requires, currentVersion) > 0 {
		return fmt.Errorf("model requires ollama version %s or newer (current version is v%s)", requires, clientVersion)
	}
	return nil
}

func pullSelectedManifest(ctx context.Context, n model.Name, parent *manifest.Manifest, runner string, regOpts *registryOptions, fn func(api.ProgressResponse)) (*manifest.Manifest, string, error) {
	child, err := manifest.SelectManifestReferenceForRunner(parent.Manifests, runner)
	if err != nil {
		return nil, "", err
	}

	childDigest := child.BlobDigest()
	if childDigest == "" {
		return nil, "", errors.New("manifest list child is missing digest")
	}

	layer, err := remoteBlobLayer(ctx, n, childDigest, manifest.MediaTypeManifest, regOpts)
	if err != nil {
		return nil, "", err
	}

	// The child manifest is metadata; model progress starts with its layers.
	if err := downloadWithTransfer(ctx, n, []manifest.Layer{layer}, regOpts, func(api.ProgressResponse) {}); err != nil {
		return nil, "", err
	}

	if err := verifyBlob(childDigest); err != nil {
		return nil, "", err
	}
	blobPath, err := manifest.BlobsPath(childDigest)
	if err != nil {
		return nil, "", err
	}
	data, err := os.ReadFile(blobPath)
	if err != nil {
		return nil, "", err
	}

	var mf manifest.Manifest
	if err := json.Unmarshal(data, &mf); err != nil {
		return nil, "", err
	}
	if mf.MediaType == manifest.MediaTypeManifestList {
		return nil, "", errors.New("nested manifest lists are not supported")
	}
	if mf.Runner == "" {
		mf.Runner = child.Runner
	}
	if mf.Format == "" {
		mf.Format = child.Format
	}

	return &mf, childDigest, nil
}

func remoteBlobLayer(ctx context.Context, n model.Name, digest, mediaType string, regOpts *registryOptions) (manifest.Layer, error) {
	requestURL := n.BaseURL().JoinPath("v2", n.DisplayNamespaceModel(), "blobs", digest)
	resp, err := makeRequestWithRetry(ctx, http.MethodHead, requestURL, nil, nil, regOpts)
	if err != nil {
		return manifest.Layer{}, err
	}
	defer resp.Body.Close()

	size, err := strconv.ParseInt(resp.Header.Get("Content-Length"), 10, 64)
	if err != nil {
		return manifest.Layer{}, err
	}

	return manifest.Layer{
		MediaType: mediaType,
		Digest:    digest,
		Size:      size,
	}, nil
}

func downloadWithTransfer(ctx context.Context, n model.Name, layers []manifest.Layer, regOpts *registryOptions, fn func(api.ProgressResponse)) error {
	blobs := make([]transfer.Blob, len(layers))
	for i, layer := range layers {
		blobs[i] = transfer.Blob{
			Digest: layer.Digest,
			Size:   layer.Size,
		}
	}

	destDir, err := manifest.BlobsPath("")
	if err != nil {
		return err
	}

	base := n.BaseURL()
	if base.Scheme != "http" && regOpts != nil && regOpts.Insecure {
		base.Scheme = "http"
	}
	baseURL := base.String()

	var totalSize int64
	for _, blob := range blobs {
		totalSize += blob.Size
	}

	progress := func(completed, total int64) {
		fn(api.ProgressResponse{
			Status:    "pulling model",
			Digest:    "sha256:model",
			Total:     total,
			Completed: completed,
		})
	}

	getToken := func(ctx context.Context, challenge transfer.AuthChallenge) (string, error) {
		return getAuthorizationToken(ctx, registryChallenge{
			Realm:   challenge.Realm,
			Service: challenge.Service,
			Scope:   challenge.Scope,
		}, base.Host)
	}

	if err := transfer.Download(ctx, transfer.DownloadOptions{
		Blobs:             blobs,
		BaseURL:           baseURL,
		DestDir:           destDir,
		Repository:        n.DisplayNamespaceModel(),
		BodyConcurrency:   max(1, int(envconfig.MaxTransferStreams())),
		Progress:          progress,
		Token:             regOpts.Token,
		GetToken:          getToken,
		Logger:            slog.Default(),
		AllowPrivateHosts: regOpts != nil && regOpts.Insecure,
	}); err != nil {
		return err
	}

	return nil
}

// writePullDowngradeAnchor writes a legacy manifest at the pulled name so a
// pre-manifest-list daemon can load the model and its garbage collector
// retains the referenced blobs.
func writePullDowngradeAnchor(n model.Name, mf *manifest.Manifest, manifestData []byte, selectedChildDigest string) {
	manifestDigests := []string{fmt.Sprintf("sha256:%x", sha256.Sum256(manifestData))}
	if selectedChildDigest != "" {
		manifestDigests = append(manifestDigests, selectedChildDigest)
	}
	// Best effort: the pull itself succeeded, so a failed downgrade anchor is
	// logged rather than failing the request.
	if err := manifest.WriteLegacyAnchor(n, mf, manifestDigests...); err != nil {
		slog.Warn("couldn't write downgrade anchor for pulled model", "model", n.DisplayShortest(), "error", err)
	}
}

// pullWithTransfer uses the simplified x/transfer package for downloading blobs.
func pullWithTransfer(ctx context.Context, n model.Name, layers []manifest.Layer, manifestData []byte, regOpts *registryOptions, fn func(api.ProgressResponse)) error {
	if err := downloadWithTransfer(ctx, n, layers, regOpts, fn); err != nil {
		return err
	}

	// Write manifest
	fn(api.ProgressResponse{Status: "writing manifest"})

	if err := manifest.WriteManifestData(n, manifestData); err != nil {
		return err
	}

	slog.Debug("manifest written", "name", n.DisplayShortest(), "sha256", fmt.Sprintf("%x", sha256.Sum256(manifestData)), "size", len(manifestData))
	return nil
}

// pushWithTransfer uses the simplified x/transfer package for uploading blobs and manifest.
func pushWithTransfer(ctx context.Context, n model.Name, layers []manifest.Layer, manifestJSON []byte, manifestMediaType string, regOpts *registryOptions, fn func(api.ProgressResponse)) error {
	blobs := make([]transfer.Blob, len(layers))
	for i, layer := range layers {
		blobs[i] = transfer.Blob{
			Digest: layer.Digest,
			Size:   layer.Size,
			From:   layer.From,
		}
	}

	srcDir, err := manifest.BlobsPath("")
	if err != nil {
		return err
	}

	base := n.BaseURL()
	if base.Scheme != "http" && regOpts != nil && regOpts.Insecure {
		base.Scheme = "http"
	}
	baseURL := base.String()

	var totalSize int64
	for _, blob := range blobs {
		totalSize += blob.Size
	}

	progress := func(completed, total int64) {
		fn(api.ProgressResponse{
			Status:    "pushing model",
			Digest:    "sha256:model",
			Total:     total,
			Completed: completed,
		})
	}

	getToken := func(ctx context.Context, challenge transfer.AuthChallenge) (string, error) {
		return getAuthorizationToken(ctx, registryChallenge{
			Realm:   challenge.Realm,
			Service: challenge.Service,
			Scope:   challenge.Scope,
		}, base.Host)
	}

	return transfer.Upload(ctx, transfer.UploadOptions{
		Blobs:             blobs,
		BaseURL:           baseURL,
		SrcDir:            srcDir,
		BodyConcurrency:   max(1, int(envconfig.MaxTransferStreams())),
		Progress:          progress,
		Token:             regOpts.Token,
		GetToken:          getToken,
		Logger:            slog.Default(),
		Manifest:          manifestJSON,
		ManifestMediaType: manifestMediaType,
		ManifestRef:       n.Tag,
		Repository:        n.DisplayNamespaceModel(),
		AllowPrivateHosts: regOpts != nil && regOpts.Insecure,
	})
}

func pullModelManifest(ctx context.Context, n model.Name, regOpts *registryOptions) (*manifest.Manifest, []byte, error) {
	requestURL := n.BaseURL().JoinPath("v2", n.DisplayNamespaceModel(), "manifests", n.Tag)

	headers := make(http.Header)
	headers.Set("Accept", strings.Join([]string{manifest.MediaTypeManifestList, manifest.MediaTypeManifest}, ", "))
	resp, err := makeRequestWithRetry(ctx, http.MethodGet, requestURL, headers, nil, regOpts)
	if err != nil {
		return nil, nil, err
	}
	defer resp.Body.Close()

	data, err := io.ReadAll(resp.Body)
	if err != nil {
		return nil, nil, err
	}

	var m manifest.Manifest
	if err := json.Unmarshal(data, &m); err != nil {
		return nil, nil, err
	}

	return &m, data, err
}

// GetSHA256Digest returns the SHA256 hash of a given buffer and returns it, and the size of buffer
func GetSHA256Digest(r io.Reader) (string, int64) {
	h := sha256.New()
	n, err := io.Copy(h, r)
	if err != nil {
		log.Fatal(err)
	}

	return fmt.Sprintf("sha256:%x", h.Sum(nil)), n
}

var errUnauthorized = errors.New("unauthorized: access denied")

func makeRequestWithRetry(ctx context.Context, method string, requestURL *url.URL, headers http.Header, body io.ReadSeeker, regOpts *registryOptions) (*http.Response, error) {
	for range 2 {
		resp, err := makeRequest(ctx, method, requestURL, headers, body, regOpts)
		if err != nil {
			if !errors.Is(err, context.Canceled) {
				slog.Info(fmt.Sprintf("request failed: %v", err))
			}

			return nil, err
		}

		switch {
		case resp.StatusCode == http.StatusUnauthorized:
			resp.Body.Close()

			// Handle authentication error with one retry
			challenge := parseRegistryChallenge(resp.Header.Get("www-authenticate"))
			token, err := getAuthorizationToken(ctx, challenge, requestURL.Host)
			if err != nil {
				return nil, err
			}
			regOpts.Token = token
			if body != nil {
				_, err = body.Seek(0, io.SeekStart)
				if err != nil {
					return nil, err
				}
			}
		case resp.StatusCode == http.StatusNotFound:
			resp.Body.Close()
			return nil, os.ErrNotExist
		case resp.StatusCode >= http.StatusBadRequest:
			defer resp.Body.Close()
			responseBody, err := io.ReadAll(resp.Body)
			if err != nil {
				return nil, fmt.Errorf("%d: %s", resp.StatusCode, err)
			}
			return nil, fmt.Errorf("%d: %s", resp.StatusCode, responseBody)
		default:
			return resp, nil
		}
	}

	return nil, errUnauthorized
}

// testMakeRequestDialContext specifies the dial function for the http client in
// makeRequest. It can be used to resolve hosts in model names to local
// addresses for testing. For example, the model name ("example.com/my/model")
// can be directed to push/pull from "127.0.0.1:1234".
//
// This is not safe to set across goroutines. It should be set in
// the main test goroutine, and not by tests marked to run in parallel with
// t.Parallel().
//
// It should be cleared after use, otherwise it will affect other tests.
//
// Ideally we would have some set this up the stack, but the code is not
// structured in a way that makes this easy, so this will have to do for now.
var testMakeRequestDialContext func(ctx context.Context, network, addr string) (net.Conn, error)

var errBlockedRedirect = errors.New("blocked redirect to a different host")

// isAllowedHost reports whether host may receive cross-host redirects.
var allowedRedirectHosts = []string{"ollama.com", "ollama.ai", "hf.co", "huggingface.co"}

func isAllowedHost(host string) bool {
	for _, h := range allowedRedirectHosts {
		if host == h || strings.HasSuffix(host, "."+h) {
			return true
		}
	}
	return false
}

func makeRequest(ctx context.Context, method string, requestURL *url.URL, headers http.Header, body io.Reader, regOpts *registryOptions) (*http.Response, error) {
	if requestURL.Scheme != "http" && regOpts != nil && regOpts.Insecure {
		requestURL.Scheme = "http"
	}

	req, err := http.NewRequestWithContext(ctx, method, requestURL.String(), body)
	if err != nil {
		return nil, err
	}

	if headers != nil {
		req.Header = headers
	}

	if regOpts != nil {
		if regOpts.Token != "" {
			req.Header.Set("Authorization", "Bearer "+regOpts.Token)
		} else if regOpts.Username != "" && regOpts.Password != "" {
			req.SetBasicAuth(regOpts.Username, regOpts.Password)
		}
	}

	req.Header.Set("User-Agent", fmt.Sprintf("ollama/%s (%s %s) Go/%s", version.Version, runtime.GOARCH, runtime.GOOS, runtime.Version()))

	if s := req.Header.Get("Content-Length"); s != "" {
		contentLength, err := strconv.ParseInt(s, 10, 64)
		if err != nil {
			return nil, err
		}

		req.ContentLength = contentLength
	}

	var checkRedirect func(req *http.Request, via []*http.Request) error
	if regOpts != nil {
		checkRedirect = regOpts.CheckRedirect
	}
	if checkRedirect == nil {
		insecure := regOpts != nil && regOpts.Insecure
		// Default redirect policy: same-host only, so a registry can't steer
		// manifest or blob requests at internal addresses. CDN-backed
		// registries redirect among their own hosts, allowed via
		// isAllowedHost. --insecure opts out for trusted LAN/local registries.
		checkRedirect = func(req *http.Request, via []*http.Request) error {
			if len(via) > 10 {
				return errMaxRedirectsExceeded
			}
			if insecure || req.URL.Host == via[0].URL.Host {
				return nil
			}
			if isAllowedHost(via[0].URL.Hostname()) && isAllowedHost(req.URL.Hostname()) {
				return nil
			}
			return errBlockedRedirect
		}
	}

	c := &http.Client{
		CheckRedirect: checkRedirect,
	}
	if testMakeRequestDialContext != nil {
		tr := http.DefaultTransport.(*http.Transport).Clone()
		tr.DialContext = testMakeRequestDialContext
		c.Transport = tr
	}
	return c.Do(req)
}

func getValue(header, key string) string {
	startIdx := strings.Index(header, key+"=")
	if startIdx == -1 {
		return ""
	}

	// Move the index to the starting quote after the key.
	startIdx += len(key) + 2
	endIdx := startIdx

	for endIdx < len(header) {
		if header[endIdx] == '"' {
			if endIdx+1 < len(header) && header[endIdx+1] != ',' { // If the next character isn't a comma, continue
				endIdx++
				continue
			}
			break
		}
		endIdx++
	}
	return header[startIdx:endIdx]
}

func parseRegistryChallenge(authStr string) registryChallenge {
	authStr = strings.TrimPrefix(authStr, "Bearer ")

	return registryChallenge{
		Realm:   getValue(authStr, "realm"),
		Service: getValue(authStr, "service"),
		Scope:   getValue(authStr, "scope"),
	}
}

var errDigestMismatch = errors.New("digest mismatch, file must be downloaded again")

func verifyBlob(digest string) error {
	fp, err := manifest.BlobsPath(digest)
	if err != nil {
		return err
	}

	f, err := os.Open(fp)
	if err != nil {
		return err
	}
	defer f.Close()

	fileDigest, _ := GetSHA256Digest(f)
	if digest != fileDigest {
		return fmt.Errorf("%w: want %s, got %s", errDigestMismatch, digest, fileDigest)
	}

	return nil
}