routes.go 42 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697989910010110210310410510610710810911011111211311411511611711811912012112212312412512612712812913013113213313413513613713813914014114214314414514614714814915015115215315415515615715815916016116216316416516616716816917017117217317417517617717817918018118218318418518618718818919019119219319419519619719819920020120220320420520620720820921021121221321421521621721821922022122222322422522622722822923023123223323423523623723823924024124224324424524624724824925025125225325425525625725825926026126226326426526626726826927027127227327427527627727827928028128228328428528628728828929029129229329429529629729829930030130230330430530630730830931031131231331431531631731831932032132232332432532632732832933033133233333433533633733833934034134234334434534634734834935035135235335435535635735835936036136236336436536636736836937037137237337437537637737837938038138238338438538638738838939039139239339439539639739839940040140240340440540640740840941041141241341441541641741841942042142242342442542642742842943043143243343443543643743843944044144244344444544644744844945045145245345445545645745845946046146246346446546646746846947047147247347447547647747847948048148248348448548648748848949049149249349449549649749849950050150250350450550650750850951051151251351451551651751851952052152252352452552652752852953053153253353453553653753853954054154254354454554654754854955055155255355455555655755855956056156256356456556656756856957057157257357457557657757857958058158258358458558658758858959059159259359459559659759859960060160260360460560660760860961061161261361461561661761861962062162262362462562662762862963063163263363463563663763863964064164264364464564664764864965065165265365465565665765865966066166266366466566666766866967067167267367467567667767867968068168268368468568668768868969069169269369469569669769869970070170270370470570670770870971071171271371471571671771871972072172272372472572672772872973073173273373473573673773873974074174274374474574674774874975075175275375475575675775875976076176276376476576676776876977077177277377477577677777877978078178278378478578678778878979079179279379479579679779879980080180280380480580680780880981081181281381481581681781881982082182282382482582682782882983083183283383483583683783883984084184284384484584684784884985085185285385485585685785885986086186286386486586686786886987087187287387487587687787887988088188288388488588688788888989089189289389489589689789889990090190290390490590690790890991091191291391491591691791891992092192292392492592692792892993093193293393493593693793893994094194294394494594694794894995095195295395495595695795895996096196296396496596696796896997097197297397497597697797897998098198298398498598698798898999099199299399499599699799899910001001100210031004100510061007100810091010101110121013101410151016101710181019102010211022102310241025102610271028102910301031103210331034103510361037103810391040104110421043104410451046104710481049105010511052105310541055105610571058105910601061106210631064106510661067106810691070107110721073107410751076107710781079108010811082108310841085108610871088108910901091109210931094109510961097109810991100110111021103110411051106110711081109111011111112111311141115111611171118111911201121112211231124112511261127112811291130113111321133113411351136113711381139114011411142114311441145114611471148114911501151115211531154115511561157115811591160116111621163116411651166116711681169117011711172117311741175117611771178117911801181118211831184118511861187118811891190119111921193119411951196119711981199120012011202120312041205120612071208120912101211121212131214121512161217121812191220122112221223122412251226122712281229123012311232123312341235123612371238123912401241124212431244124512461247124812491250125112521253125412551256125712581259126012611262126312641265126612671268126912701271127212731274127512761277127812791280128112821283128412851286128712881289129012911292129312941295129612971298129913001301130213031304130513061307130813091310131113121313131413151316131713181319132013211322132313241325132613271328132913301331133213331334133513361337133813391340134113421343134413451346134713481349135013511352135313541355135613571358135913601361136213631364136513661367136813691370137113721373137413751376137713781379138013811382138313841385138613871388138913901391139213931394139513961397139813991400140114021403140414051406140714081409141014111412141314141415141614171418141914201421142214231424142514261427142814291430143114321433143414351436143714381439144014411442144314441445144614471448144914501451145214531454145514561457145814591460146114621463146414651466146714681469147014711472147314741475147614771478147914801481148214831484148514861487148814891490149114921493149414951496149714981499150015011502150315041505150615071508150915101511151215131514151515161517151815191520152115221523152415251526152715281529153015311532153315341535153615371538153915401541154215431544154515461547154815491550155115521553155415551556155715581559156015611562156315641565156615671568156915701571157215731574157515761577157815791580158115821583158415851586158715881589159015911592159315941595159615971598159916001601160216031604160516061607160816091610161116121613161416151616161716181619162016211622162316241625162616271628162916301631163216331634163516361637163816391640164116421643164416451646164716481649165016511652165316541655
  1. package server
  2. import (
  3. "bytes"
  4. "cmp"
  5. "context"
  6. "encoding/binary"
  7. "encoding/json"
  8. "errors"
  9. "fmt"
  10. "io"
  11. "io/fs"
  12. "log/slog"
  13. "math"
  14. "net"
  15. "net/http"
  16. "net/netip"
  17. "os"
  18. "os/signal"
  19. "path/filepath"
  20. "slices"
  21. "strings"
  22. "syscall"
  23. "time"
  24. "github.com/gin-contrib/cors"
  25. "github.com/gin-gonic/gin"
  26. "golang.org/x/sync/errgroup"
  27. "github.com/ollama/ollama/api"
  28. "github.com/ollama/ollama/discover"
  29. "github.com/ollama/ollama/envconfig"
  30. "github.com/ollama/ollama/llm"
  31. "github.com/ollama/ollama/openai"
  32. "github.com/ollama/ollama/parser"
  33. "github.com/ollama/ollama/runners"
  34. "github.com/ollama/ollama/server/imageproc"
  35. "github.com/ollama/ollama/template"
  36. "github.com/ollama/ollama/types/errtypes"
  37. "github.com/ollama/ollama/types/model"
  38. "github.com/ollama/ollama/version"
  39. )
  40. var mode string = gin.DebugMode
  41. type Server struct {
  42. addr net.Addr
  43. sched *Scheduler
  44. }
  45. func init() {
  46. switch mode {
  47. case gin.DebugMode:
  48. case gin.ReleaseMode:
  49. case gin.TestMode:
  50. default:
  51. mode = gin.DebugMode
  52. }
  53. gin.SetMode(mode)
  54. }
  55. var (
  56. errRequired = errors.New("is required")
  57. errBadTemplate = errors.New("template error")
  58. )
  59. func modelOptions(model *Model, requestOpts map[string]interface{}) (api.Options, error) {
  60. opts := api.DefaultOptions()
  61. if err := opts.FromMap(model.Options); err != nil {
  62. return api.Options{}, err
  63. }
  64. if err := opts.FromMap(requestOpts); err != nil {
  65. return api.Options{}, err
  66. }
  67. return opts, nil
  68. }
  69. // scheduleRunner schedules a runner after validating inputs such as capabilities and model options.
  70. // It returns the allocated runner, model instance, and consolidated options if successful and error otherwise.
  71. func (s *Server) scheduleRunner(ctx context.Context, name string, caps []Capability, requestOpts map[string]any, keepAlive *api.Duration) (llm.LlamaServer, *Model, *api.Options, error) {
  72. if name == "" {
  73. return nil, nil, nil, fmt.Errorf("model %w", errRequired)
  74. }
  75. model, err := GetModel(name)
  76. if err != nil {
  77. return nil, nil, nil, err
  78. }
  79. if err := model.CheckCapabilities(caps...); err != nil {
  80. return nil, nil, nil, fmt.Errorf("%s %w", name, err)
  81. }
  82. opts, err := modelOptions(model, requestOpts)
  83. if err != nil {
  84. return nil, nil, nil, err
  85. }
  86. runnerCh, errCh := s.sched.GetRunner(ctx, model, opts, keepAlive)
  87. var runner *runnerRef
  88. select {
  89. case runner = <-runnerCh:
  90. case err = <-errCh:
  91. return nil, nil, nil, err
  92. }
  93. return runner.llama, model, &opts, nil
  94. }
  95. func (s *Server) GenerateHandler(c *gin.Context) {
  96. checkpointStart := time.Now()
  97. var req api.GenerateRequest
  98. if err := c.ShouldBindJSON(&req); errors.Is(err, io.EOF) {
  99. c.AbortWithStatusJSON(http.StatusBadRequest, gin.H{"error": "missing request body"})
  100. return
  101. } else if err != nil {
  102. c.AbortWithStatusJSON(http.StatusBadRequest, gin.H{"error": err.Error()})
  103. return
  104. }
  105. name := model.ParseName(req.Model)
  106. if !name.IsValid() {
  107. // Ideally this is "invalid model name" but we're keeping with
  108. // what the API currently returns until we can change it.
  109. c.JSON(http.StatusNotFound, gin.H{"error": fmt.Sprintf("model '%s' not found", req.Model)})
  110. return
  111. }
  112. // We cannot currently consolidate this into GetModel because all we'll
  113. // induce infinite recursion given the current code structure.
  114. name, err := getExistingName(name)
  115. if err != nil {
  116. c.JSON(http.StatusNotFound, gin.H{"error": fmt.Sprintf("model '%s' not found", req.Model)})
  117. return
  118. }
  119. model, err := GetModel(name.String())
  120. if err != nil {
  121. switch {
  122. case errors.Is(err, fs.ErrNotExist):
  123. c.JSON(http.StatusNotFound, gin.H{"error": fmt.Sprintf("model '%s' not found", req.Model)})
  124. case err.Error() == "invalid model name":
  125. c.JSON(http.StatusBadRequest, gin.H{"error": err.Error()})
  126. default:
  127. c.JSON(http.StatusInternalServerError, gin.H{"error": err.Error()})
  128. }
  129. return
  130. }
  131. // expire the runner
  132. if req.Prompt == "" && req.KeepAlive != nil && int(req.KeepAlive.Seconds()) == 0 {
  133. s.sched.expireRunner(model)
  134. c.JSON(http.StatusOK, api.GenerateResponse{
  135. Model: req.Model,
  136. CreatedAt: time.Now().UTC(),
  137. Response: "",
  138. Done: true,
  139. DoneReason: "unload",
  140. })
  141. return
  142. }
  143. if req.Raw && (req.Template != "" || req.System != "" || len(req.Context) > 0) {
  144. c.AbortWithStatusJSON(http.StatusBadRequest, gin.H{"error": "raw mode does not support template, system, or context"})
  145. return
  146. }
  147. caps := []Capability{CapabilityCompletion}
  148. if req.Suffix != "" {
  149. caps = append(caps, CapabilityInsert)
  150. }
  151. r, m, opts, err := s.scheduleRunner(c.Request.Context(), name.String(), caps, req.Options, req.KeepAlive)
  152. if errors.Is(err, errCapabilityCompletion) {
  153. c.JSON(http.StatusBadRequest, gin.H{"error": fmt.Sprintf("%q does not support generate", req.Model)})
  154. return
  155. } else if err != nil {
  156. handleScheduleError(c, req.Model, err)
  157. return
  158. }
  159. checkpointLoaded := time.Now()
  160. // load the model
  161. if req.Prompt == "" {
  162. c.JSON(http.StatusOK, api.GenerateResponse{
  163. Model: req.Model,
  164. CreatedAt: time.Now().UTC(),
  165. Done: true,
  166. DoneReason: "load",
  167. })
  168. return
  169. }
  170. isMllama := checkMllamaModelFamily(model)
  171. if isMllama && len(req.Images) > 1 {
  172. c.AbortWithStatusJSON(http.StatusBadRequest, gin.H{"error": "this model only supports one image: more than one image sent"})
  173. return
  174. }
  175. images := make([]llm.ImageData, len(req.Images))
  176. for i := range req.Images {
  177. if isMllama {
  178. data, aspectRatioID, err := imageproc.Preprocess(req.Images[i])
  179. if err != nil {
  180. c.AbortWithStatusJSON(http.StatusInternalServerError, gin.H{"error": "error processing image"})
  181. return
  182. }
  183. buf := new(bytes.Buffer)
  184. err = binary.Write(buf, binary.LittleEndian, data)
  185. if err != nil {
  186. c.AbortWithStatusJSON(http.StatusInternalServerError, gin.H{"error": "error processing image"})
  187. return
  188. }
  189. images[i] = llm.ImageData{ID: i, Data: buf.Bytes(), AspectRatioID: aspectRatioID}
  190. } else {
  191. images[i] = llm.ImageData{ID: i, Data: req.Images[i]}
  192. }
  193. }
  194. prompt := req.Prompt
  195. if !req.Raw {
  196. tmpl := m.Template
  197. if req.Template != "" {
  198. tmpl, err = template.Parse(req.Template)
  199. if err != nil {
  200. c.JSON(http.StatusInternalServerError, gin.H{"error": err.Error()})
  201. return
  202. }
  203. }
  204. var values template.Values
  205. if req.Suffix != "" {
  206. values.Prompt = prompt
  207. values.Suffix = req.Suffix
  208. } else {
  209. var msgs []api.Message
  210. if req.System != "" {
  211. msgs = append(msgs, api.Message{Role: "system", Content: req.System})
  212. } else if m.System != "" {
  213. msgs = append(msgs, api.Message{Role: "system", Content: m.System})
  214. }
  215. if req.Context == nil {
  216. msgs = append(msgs, m.Messages...)
  217. }
  218. for _, i := range images {
  219. imgPrompt := ""
  220. if isMllama {
  221. imgPrompt = "<|image|>"
  222. }
  223. msgs = append(msgs, api.Message{Role: "user", Content: fmt.Sprintf("[img-%d]"+imgPrompt, i.ID)})
  224. }
  225. values.Messages = append(msgs, api.Message{Role: "user", Content: req.Prompt})
  226. }
  227. var b bytes.Buffer
  228. if req.Context != nil {
  229. slog.Warn("the context field is deprecated and will be removed in a future version of Ollama")
  230. s, err := r.Detokenize(c.Request.Context(), req.Context)
  231. if err != nil {
  232. c.JSON(http.StatusInternalServerError, gin.H{"error": err.Error()})
  233. return
  234. }
  235. b.WriteString(s)
  236. }
  237. if err := tmpl.Execute(&b, values); err != nil {
  238. c.JSON(http.StatusInternalServerError, gin.H{"error": err.Error()})
  239. return
  240. }
  241. prompt = b.String()
  242. }
  243. slog.Debug("generate request", "images", len(images), "prompt", prompt)
  244. ch := make(chan any)
  245. go func() {
  246. // TODO (jmorganca): avoid building the response twice both here and below
  247. var sb strings.Builder
  248. defer close(ch)
  249. if err := r.Completion(c.Request.Context(), llm.CompletionRequest{
  250. Prompt: prompt,
  251. Images: images,
  252. Format: req.Format,
  253. Options: opts,
  254. }, func(cr llm.CompletionResponse) {
  255. res := api.GenerateResponse{
  256. Model: req.Model,
  257. CreatedAt: time.Now().UTC(),
  258. Response: cr.Content,
  259. Done: cr.Done,
  260. DoneReason: cr.DoneReason,
  261. Metrics: api.Metrics{
  262. PromptEvalCount: cr.PromptEvalCount,
  263. PromptEvalDuration: cr.PromptEvalDuration,
  264. EvalCount: cr.EvalCount,
  265. EvalDuration: cr.EvalDuration,
  266. },
  267. }
  268. if _, err := sb.WriteString(cr.Content); err != nil {
  269. ch <- gin.H{"error": err.Error()}
  270. }
  271. if cr.Done {
  272. res.TotalDuration = time.Since(checkpointStart)
  273. res.LoadDuration = checkpointLoaded.Sub(checkpointStart)
  274. if !req.Raw {
  275. tokens, err := r.Tokenize(c.Request.Context(), prompt+sb.String())
  276. if err != nil {
  277. ch <- gin.H{"error": err.Error()}
  278. return
  279. }
  280. res.Context = tokens
  281. }
  282. }
  283. ch <- res
  284. }); err != nil {
  285. ch <- gin.H{"error": err.Error()}
  286. }
  287. }()
  288. if req.Stream != nil && !*req.Stream {
  289. var r api.GenerateResponse
  290. var sb strings.Builder
  291. for rr := range ch {
  292. switch t := rr.(type) {
  293. case api.GenerateResponse:
  294. sb.WriteString(t.Response)
  295. r = t
  296. case gin.H:
  297. msg, ok := t["error"].(string)
  298. if !ok {
  299. msg = "unexpected error format in response"
  300. }
  301. c.JSON(http.StatusInternalServerError, gin.H{"error": msg})
  302. return
  303. default:
  304. c.JSON(http.StatusInternalServerError, gin.H{"error": "unexpected response"})
  305. return
  306. }
  307. }
  308. r.Response = sb.String()
  309. c.JSON(http.StatusOK, r)
  310. return
  311. }
  312. streamResponse(c, ch)
  313. }
  314. func (s *Server) EmbedHandler(c *gin.Context) {
  315. checkpointStart := time.Now()
  316. var req api.EmbedRequest
  317. err := c.ShouldBindJSON(&req)
  318. switch {
  319. case errors.Is(err, io.EOF):
  320. c.AbortWithStatusJSON(http.StatusBadRequest, gin.H{"error": "missing request body"})
  321. return
  322. case err != nil:
  323. c.AbortWithStatusJSON(http.StatusBadRequest, gin.H{"error": err.Error()})
  324. return
  325. }
  326. truncate := true
  327. if req.Truncate != nil && !*req.Truncate {
  328. truncate = false
  329. }
  330. var input []string
  331. switch i := req.Input.(type) {
  332. case string:
  333. if len(i) > 0 {
  334. input = append(input, i)
  335. }
  336. case []any:
  337. for _, v := range i {
  338. if _, ok := v.(string); !ok {
  339. c.AbortWithStatusJSON(http.StatusBadRequest, gin.H{"error": "invalid input type"})
  340. return
  341. }
  342. input = append(input, v.(string))
  343. }
  344. default:
  345. if req.Input != nil {
  346. c.AbortWithStatusJSON(http.StatusBadRequest, gin.H{"error": "invalid input type"})
  347. return
  348. }
  349. }
  350. name, err := getExistingName(model.ParseName(req.Model))
  351. if err != nil {
  352. c.JSON(http.StatusNotFound, gin.H{"error": fmt.Sprintf("model '%s' not found", req.Model)})
  353. return
  354. }
  355. r, m, opts, err := s.scheduleRunner(c.Request.Context(), name.String(), []Capability{}, req.Options, req.KeepAlive)
  356. if err != nil {
  357. handleScheduleError(c, req.Model, err)
  358. return
  359. }
  360. checkpointLoaded := time.Now()
  361. if len(input) == 0 {
  362. c.JSON(http.StatusOK, api.EmbedResponse{Model: req.Model, Embeddings: [][]float32{}})
  363. return
  364. }
  365. kvData, err := getKVData(m.ModelPath, false)
  366. if err != nil {
  367. c.JSON(http.StatusInternalServerError, gin.H{"error": err.Error()})
  368. return
  369. }
  370. var count int
  371. for i, s := range input {
  372. tokens, err := r.Tokenize(c.Request.Context(), s)
  373. if err != nil {
  374. c.JSON(http.StatusInternalServerError, gin.H{"error": err.Error()})
  375. return
  376. }
  377. ctxLen := min(opts.NumCtx, int(kvData.ContextLength()))
  378. if len(tokens) > ctxLen {
  379. if !truncate {
  380. c.JSON(http.StatusBadRequest, gin.H{"error": "input length exceeds maximum context length"})
  381. return
  382. }
  383. tokens = tokens[:ctxLen]
  384. s, err = r.Detokenize(c.Request.Context(), tokens)
  385. if err != nil {
  386. c.JSON(http.StatusInternalServerError, gin.H{"error": err.Error()})
  387. return
  388. }
  389. }
  390. count += len(tokens)
  391. input[i] = s
  392. }
  393. var g errgroup.Group
  394. embeddings := make([][]float32, len(input))
  395. for i, text := range input {
  396. g.Go(func() error {
  397. embedding, err := r.Embedding(c.Request.Context(), text)
  398. if err != nil {
  399. return err
  400. }
  401. embeddings[i] = normalize(embedding)
  402. return nil
  403. })
  404. }
  405. if err := g.Wait(); err != nil {
  406. slog.Error("embedding generation failed", "error", err)
  407. c.JSON(http.StatusInternalServerError, gin.H{"error": fmt.Errorf("failed to generate embeddings: %v", err)})
  408. return
  409. }
  410. resp := api.EmbedResponse{
  411. Model: req.Model,
  412. Embeddings: embeddings,
  413. TotalDuration: time.Since(checkpointStart),
  414. LoadDuration: checkpointLoaded.Sub(checkpointStart),
  415. PromptEvalCount: count,
  416. }
  417. c.JSON(http.StatusOK, resp)
  418. }
  419. func normalize(vec []float32) []float32 {
  420. var sum float32
  421. for _, v := range vec {
  422. sum += v * v
  423. }
  424. norm := float32(0.0)
  425. if sum > 0 {
  426. norm = float32(1.0 / math.Sqrt(float64(sum)))
  427. }
  428. for i := range vec {
  429. vec[i] *= norm
  430. }
  431. return vec
  432. }
  433. func (s *Server) EmbeddingsHandler(c *gin.Context) {
  434. var req api.EmbeddingRequest
  435. if err := c.ShouldBindJSON(&req); errors.Is(err, io.EOF) {
  436. c.AbortWithStatusJSON(http.StatusBadRequest, gin.H{"error": "missing request body"})
  437. return
  438. } else if err != nil {
  439. c.AbortWithStatusJSON(http.StatusBadRequest, gin.H{"error": err.Error()})
  440. return
  441. }
  442. name := model.ParseName(req.Model)
  443. if !name.IsValid() {
  444. c.JSON(http.StatusBadRequest, gin.H{"error": "model is required"})
  445. return
  446. }
  447. r, _, _, err := s.scheduleRunner(c.Request.Context(), name.String(), []Capability{}, req.Options, req.KeepAlive)
  448. if err != nil {
  449. handleScheduleError(c, req.Model, err)
  450. return
  451. }
  452. // an empty request loads the model
  453. if req.Prompt == "" {
  454. c.JSON(http.StatusOK, api.EmbeddingResponse{Embedding: []float64{}})
  455. return
  456. }
  457. embedding, err := r.Embedding(c.Request.Context(), req.Prompt)
  458. if err != nil {
  459. slog.Info(fmt.Sprintf("embedding generation failed: %v", err))
  460. c.JSON(http.StatusInternalServerError, gin.H{"error": fmt.Errorf("failed to generate embedding: %v", err)})
  461. return
  462. }
  463. var e []float64
  464. for _, v := range embedding {
  465. e = append(e, float64(v))
  466. }
  467. resp := api.EmbeddingResponse{
  468. Embedding: e,
  469. }
  470. c.JSON(http.StatusOK, resp)
  471. }
  472. func (s *Server) PullHandler(c *gin.Context) {
  473. var req api.PullRequest
  474. err := c.ShouldBindJSON(&req)
  475. switch {
  476. case errors.Is(err, io.EOF):
  477. c.AbortWithStatusJSON(http.StatusBadRequest, gin.H{"error": "missing request body"})
  478. return
  479. case err != nil:
  480. c.AbortWithStatusJSON(http.StatusBadRequest, gin.H{"error": err.Error()})
  481. return
  482. }
  483. name := model.ParseName(cmp.Or(req.Model, req.Name))
  484. if !name.IsValid() {
  485. c.AbortWithStatusJSON(http.StatusBadRequest, gin.H{"error": "invalid model name"})
  486. return
  487. }
  488. name, err = getExistingName(name)
  489. if err != nil {
  490. c.AbortWithStatusJSON(http.StatusBadRequest, gin.H{"error": err.Error()})
  491. return
  492. }
  493. ch := make(chan any)
  494. go func() {
  495. defer close(ch)
  496. fn := func(r api.ProgressResponse) {
  497. ch <- r
  498. }
  499. regOpts := &registryOptions{
  500. Insecure: req.Insecure,
  501. }
  502. ctx, cancel := context.WithCancel(c.Request.Context())
  503. defer cancel()
  504. if err := PullModel(ctx, name.DisplayShortest(), regOpts, fn); err != nil {
  505. ch <- gin.H{"error": err.Error()}
  506. }
  507. }()
  508. if req.Stream != nil && !*req.Stream {
  509. waitForStream(c, ch)
  510. return
  511. }
  512. streamResponse(c, ch)
  513. }
  514. func (s *Server) PushHandler(c *gin.Context) {
  515. var req api.PushRequest
  516. err := c.ShouldBindJSON(&req)
  517. switch {
  518. case errors.Is(err, io.EOF):
  519. c.AbortWithStatusJSON(http.StatusBadRequest, gin.H{"error": "missing request body"})
  520. return
  521. case err != nil:
  522. c.AbortWithStatusJSON(http.StatusBadRequest, gin.H{"error": err.Error()})
  523. return
  524. }
  525. var mname string
  526. if req.Model != "" {
  527. mname = req.Model
  528. } else if req.Name != "" {
  529. mname = req.Name
  530. } else {
  531. c.AbortWithStatusJSON(http.StatusBadRequest, gin.H{"error": "model is required"})
  532. return
  533. }
  534. ch := make(chan any)
  535. go func() {
  536. defer close(ch)
  537. fn := func(r api.ProgressResponse) {
  538. ch <- r
  539. }
  540. regOpts := &registryOptions{
  541. Insecure: req.Insecure,
  542. }
  543. ctx, cancel := context.WithCancel(c.Request.Context())
  544. defer cancel()
  545. name, err := getExistingName(model.ParseName(mname))
  546. if err != nil {
  547. ch <- gin.H{"error": err.Error()}
  548. return
  549. }
  550. if err := PushModel(ctx, name.DisplayShortest(), regOpts, fn); err != nil {
  551. ch <- gin.H{"error": err.Error()}
  552. }
  553. }()
  554. if req.Stream != nil && !*req.Stream {
  555. waitForStream(c, ch)
  556. return
  557. }
  558. streamResponse(c, ch)
  559. }
  560. // getExistingName searches the models directory for the longest prefix match of
  561. // the input name and returns the input name with all existing parts replaced
  562. // with each part found. If no parts are found, the input name is returned as
  563. // is.
  564. func getExistingName(n model.Name) (model.Name, error) {
  565. var zero model.Name
  566. existing, err := Manifests(true)
  567. if err != nil {
  568. return zero, err
  569. }
  570. var set model.Name // tracks parts already canonicalized
  571. for e := range existing {
  572. if set.Host == "" && strings.EqualFold(e.Host, n.Host) {
  573. n.Host = e.Host
  574. }
  575. if set.Namespace == "" && strings.EqualFold(e.Namespace, n.Namespace) {
  576. n.Namespace = e.Namespace
  577. }
  578. if set.Model == "" && strings.EqualFold(e.Model, n.Model) {
  579. n.Model = e.Model
  580. }
  581. if set.Tag == "" && strings.EqualFold(e.Tag, n.Tag) {
  582. n.Tag = e.Tag
  583. }
  584. }
  585. return n, nil
  586. }
  587. func (s *Server) CreateHandler(c *gin.Context) {
  588. var r api.CreateRequest
  589. if err := c.ShouldBindJSON(&r); errors.Is(err, io.EOF) {
  590. c.AbortWithStatusJSON(http.StatusBadRequest, gin.H{"error": "missing request body"})
  591. return
  592. } else if err != nil {
  593. c.AbortWithStatusJSON(http.StatusBadRequest, gin.H{"error": err.Error()})
  594. return
  595. }
  596. name := model.ParseName(cmp.Or(r.Model, r.Name))
  597. if !name.IsValid() {
  598. c.AbortWithStatusJSON(http.StatusBadRequest, gin.H{"error": errtypes.InvalidModelNameErrMsg})
  599. return
  600. }
  601. name, err := getExistingName(name)
  602. if err != nil {
  603. c.AbortWithStatusJSON(http.StatusBadRequest, gin.H{"error": err.Error()})
  604. return
  605. }
  606. if r.Path == "" && r.Modelfile == "" {
  607. c.AbortWithStatusJSON(http.StatusBadRequest, gin.H{"error": "path or Modelfile are required"})
  608. return
  609. }
  610. var sr io.Reader = strings.NewReader(r.Modelfile)
  611. if r.Path != "" && r.Modelfile == "" {
  612. f, err := os.Open(r.Path)
  613. if err != nil {
  614. c.AbortWithStatusJSON(http.StatusBadRequest, gin.H{"error": fmt.Sprintf("error reading modelfile: %s", err)})
  615. return
  616. }
  617. defer f.Close()
  618. sr = f
  619. }
  620. f, err := parser.ParseFile(sr)
  621. if err != nil {
  622. c.AbortWithStatusJSON(http.StatusBadRequest, gin.H{"error": err.Error()})
  623. return
  624. }
  625. ch := make(chan any)
  626. go func() {
  627. defer close(ch)
  628. fn := func(resp api.ProgressResponse) {
  629. ch <- resp
  630. }
  631. ctx, cancel := context.WithCancel(c.Request.Context())
  632. defer cancel()
  633. quantization := cmp.Or(r.Quantize, r.Quantization)
  634. if err := CreateModel(ctx, name, filepath.Dir(r.Path), strings.ToUpper(quantization), f, fn); errors.Is(err, errBadTemplate) {
  635. ch <- gin.H{"error": err.Error(), "status": http.StatusBadRequest}
  636. } else if err != nil {
  637. ch <- gin.H{"error": err.Error()}
  638. }
  639. }()
  640. if r.Stream != nil && !*r.Stream {
  641. waitForStream(c, ch)
  642. return
  643. }
  644. streamResponse(c, ch)
  645. }
  646. func (s *Server) DeleteHandler(c *gin.Context) {
  647. var r api.DeleteRequest
  648. if err := c.ShouldBindJSON(&r); errors.Is(err, io.EOF) {
  649. c.AbortWithStatusJSON(http.StatusBadRequest, gin.H{"error": "missing request body"})
  650. return
  651. } else if err != nil {
  652. c.AbortWithStatusJSON(http.StatusBadRequest, gin.H{"error": err.Error()})
  653. return
  654. }
  655. n := model.ParseName(cmp.Or(r.Model, r.Name))
  656. if !n.IsValid() {
  657. c.AbortWithStatusJSON(http.StatusBadRequest, gin.H{"error": fmt.Sprintf("name %q is invalid", cmp.Or(r.Model, r.Name))})
  658. return
  659. }
  660. n, err := getExistingName(n)
  661. if err != nil {
  662. c.JSON(http.StatusNotFound, gin.H{"error": fmt.Sprintf("model '%s' not found", cmp.Or(r.Model, r.Name))})
  663. return
  664. }
  665. m, err := ParseNamedManifest(n)
  666. if err != nil {
  667. switch {
  668. case os.IsNotExist(err):
  669. c.JSON(http.StatusNotFound, gin.H{"error": fmt.Sprintf("model '%s' not found", cmp.Or(r.Model, r.Name))})
  670. default:
  671. c.JSON(http.StatusInternalServerError, gin.H{"error": err.Error()})
  672. }
  673. return
  674. }
  675. if err := m.Remove(); err != nil {
  676. c.JSON(http.StatusInternalServerError, gin.H{"error": err.Error()})
  677. return
  678. }
  679. if err := m.RemoveLayers(); err != nil {
  680. c.JSON(http.StatusInternalServerError, gin.H{"error": err.Error()})
  681. return
  682. }
  683. }
  684. func (s *Server) ShowHandler(c *gin.Context) {
  685. var req api.ShowRequest
  686. err := c.ShouldBindJSON(&req)
  687. switch {
  688. case errors.Is(err, io.EOF):
  689. c.AbortWithStatusJSON(http.StatusBadRequest, gin.H{"error": "missing request body"})
  690. return
  691. case err != nil:
  692. c.AbortWithStatusJSON(http.StatusBadRequest, gin.H{"error": err.Error()})
  693. return
  694. }
  695. if req.Model != "" {
  696. // noop
  697. } else if req.Name != "" {
  698. req.Model = req.Name
  699. } else {
  700. c.AbortWithStatusJSON(http.StatusBadRequest, gin.H{"error": "model is required"})
  701. return
  702. }
  703. resp, err := GetModelInfo(req)
  704. if err != nil {
  705. switch {
  706. case os.IsNotExist(err):
  707. c.JSON(http.StatusNotFound, gin.H{"error": fmt.Sprintf("model '%s' not found", req.Model)})
  708. case err.Error() == "invalid model name":
  709. c.JSON(http.StatusBadRequest, gin.H{"error": err.Error()})
  710. default:
  711. c.JSON(http.StatusInternalServerError, gin.H{"error": err.Error()})
  712. }
  713. return
  714. }
  715. c.JSON(http.StatusOK, resp)
  716. }
  717. func GetModelInfo(req api.ShowRequest) (*api.ShowResponse, error) {
  718. name := model.ParseName(req.Model)
  719. if !name.IsValid() {
  720. return nil, errModelPathInvalid
  721. }
  722. name, err := getExistingName(name)
  723. if err != nil {
  724. return nil, err
  725. }
  726. m, err := GetModel(name.String())
  727. if err != nil {
  728. return nil, err
  729. }
  730. modelDetails := api.ModelDetails{
  731. ParentModel: m.ParentModel,
  732. Format: m.Config.ModelFormat,
  733. Family: m.Config.ModelFamily,
  734. Families: m.Config.ModelFamilies,
  735. ParameterSize: m.Config.ModelType,
  736. QuantizationLevel: m.Config.FileType,
  737. }
  738. if req.System != "" {
  739. m.System = req.System
  740. }
  741. msgs := make([]api.Message, len(m.Messages))
  742. for i, msg := range m.Messages {
  743. msgs[i] = api.Message{Role: msg.Role, Content: msg.Content}
  744. }
  745. manifest, err := ParseNamedManifest(name)
  746. if err != nil {
  747. return nil, err
  748. }
  749. resp := &api.ShowResponse{
  750. License: strings.Join(m.License, "\n"),
  751. System: m.System,
  752. Template: m.Template.String(),
  753. Details: modelDetails,
  754. Messages: msgs,
  755. ModifiedAt: manifest.fi.ModTime(),
  756. }
  757. var params []string
  758. cs := 30
  759. for k, v := range m.Options {
  760. switch val := v.(type) {
  761. case []interface{}:
  762. for _, nv := range val {
  763. params = append(params, fmt.Sprintf("%-*s %#v", cs, k, nv))
  764. }
  765. default:
  766. params = append(params, fmt.Sprintf("%-*s %#v", cs, k, v))
  767. }
  768. }
  769. resp.Parameters = strings.Join(params, "\n")
  770. for k, v := range req.Options {
  771. if _, ok := req.Options[k]; ok {
  772. m.Options[k] = v
  773. }
  774. }
  775. var sb strings.Builder
  776. fmt.Fprintln(&sb, "# Modelfile generated by \"ollama show\"")
  777. fmt.Fprintln(&sb, "# To build a new Modelfile based on this, replace FROM with:")
  778. fmt.Fprintf(&sb, "# FROM %s\n\n", m.ShortName)
  779. fmt.Fprint(&sb, m.String())
  780. resp.Modelfile = sb.String()
  781. kvData, err := getKVData(m.ModelPath, req.Verbose)
  782. if err != nil {
  783. return nil, err
  784. }
  785. delete(kvData, "general.name")
  786. delete(kvData, "tokenizer.chat_template")
  787. resp.ModelInfo = kvData
  788. if len(m.ProjectorPaths) > 0 {
  789. projectorData, err := getKVData(m.ProjectorPaths[0], req.Verbose)
  790. if err != nil {
  791. return nil, err
  792. }
  793. resp.ProjectorInfo = projectorData
  794. }
  795. return resp, nil
  796. }
  797. func getKVData(digest string, verbose bool) (llm.KV, error) {
  798. maxArraySize := 0
  799. if verbose {
  800. maxArraySize = -1
  801. }
  802. kvData, err := llm.LoadModel(digest, maxArraySize)
  803. if err != nil {
  804. return nil, err
  805. }
  806. kv := kvData.KV()
  807. if !verbose {
  808. for k := range kv {
  809. if t, ok := kv[k].([]any); len(t) > 5 && ok {
  810. kv[k] = []any{}
  811. }
  812. }
  813. }
  814. return kv, nil
  815. }
  816. func (s *Server) ListHandler(c *gin.Context) {
  817. ms, err := Manifests(true)
  818. if err != nil {
  819. c.JSON(http.StatusInternalServerError, gin.H{"error": err.Error()})
  820. return
  821. }
  822. models := []api.ListModelResponse{}
  823. for n, m := range ms {
  824. var cf ConfigV2
  825. if m.Config.Digest != "" {
  826. f, err := m.Config.Open()
  827. if err != nil {
  828. slog.Warn("bad manifest filepath", "name", n, "error", err)
  829. continue
  830. }
  831. defer f.Close()
  832. if err := json.NewDecoder(f).Decode(&cf); err != nil {
  833. slog.Warn("bad manifest config", "name", n, "error", err)
  834. continue
  835. }
  836. }
  837. // tag should never be masked
  838. models = append(models, api.ListModelResponse{
  839. Model: n.DisplayShortest(),
  840. Name: n.DisplayShortest(),
  841. Size: m.Size(),
  842. Digest: m.digest,
  843. ModifiedAt: m.fi.ModTime(),
  844. Details: api.ModelDetails{
  845. Format: cf.ModelFormat,
  846. Family: cf.ModelFamily,
  847. Families: cf.ModelFamilies,
  848. ParameterSize: cf.ModelType,
  849. QuantizationLevel: cf.FileType,
  850. },
  851. })
  852. }
  853. slices.SortStableFunc(models, func(i, j api.ListModelResponse) int {
  854. // most recently modified first
  855. return cmp.Compare(j.ModifiedAt.Unix(), i.ModifiedAt.Unix())
  856. })
  857. c.JSON(http.StatusOK, api.ListResponse{Models: models})
  858. }
  859. func (s *Server) CopyHandler(c *gin.Context) {
  860. var r api.CopyRequest
  861. if err := c.ShouldBindJSON(&r); errors.Is(err, io.EOF) {
  862. c.AbortWithStatusJSON(http.StatusBadRequest, gin.H{"error": "missing request body"})
  863. return
  864. } else if err != nil {
  865. c.AbortWithStatusJSON(http.StatusBadRequest, gin.H{"error": err.Error()})
  866. return
  867. }
  868. src := model.ParseName(r.Source)
  869. if !src.IsValid() {
  870. c.AbortWithStatusJSON(http.StatusBadRequest, gin.H{"error": fmt.Sprintf("source %q is invalid", r.Source)})
  871. return
  872. }
  873. src, err := getExistingName(src)
  874. if err != nil {
  875. c.AbortWithStatusJSON(http.StatusBadRequest, gin.H{"error": err.Error()})
  876. return
  877. }
  878. dst := model.ParseName(r.Destination)
  879. if !dst.IsValid() {
  880. c.AbortWithStatusJSON(http.StatusBadRequest, gin.H{"error": fmt.Sprintf("destination %q is invalid", r.Destination)})
  881. return
  882. }
  883. dst, err = getExistingName(dst)
  884. if err != nil {
  885. c.AbortWithStatusJSON(http.StatusBadRequest, gin.H{"error": err.Error()})
  886. return
  887. }
  888. if err := CopyModel(src, dst); errors.Is(err, os.ErrNotExist) {
  889. c.JSON(http.StatusNotFound, gin.H{"error": fmt.Sprintf("model %q not found", r.Source)})
  890. } else if err != nil {
  891. c.JSON(http.StatusInternalServerError, gin.H{"error": err.Error()})
  892. }
  893. }
  894. func (s *Server) HeadBlobHandler(c *gin.Context) {
  895. path, err := GetBlobsPath(c.Param("digest"))
  896. if err != nil {
  897. c.AbortWithStatusJSON(http.StatusBadRequest, gin.H{"error": err.Error()})
  898. return
  899. }
  900. if _, err := os.Stat(path); err != nil {
  901. c.AbortWithStatusJSON(http.StatusNotFound, gin.H{"error": fmt.Sprintf("blob %q not found", c.Param("digest"))})
  902. return
  903. }
  904. c.Status(http.StatusOK)
  905. }
  906. func (s *Server) CreateBlobHandler(c *gin.Context) {
  907. if ib, ok := intermediateBlobs[c.Param("digest")]; ok {
  908. p, err := GetBlobsPath(ib)
  909. if err != nil {
  910. c.AbortWithStatusJSON(http.StatusInternalServerError, gin.H{"error": err.Error()})
  911. return
  912. }
  913. if _, err := os.Stat(p); errors.Is(err, os.ErrNotExist) {
  914. slog.Info("evicting intermediate blob which no longer exists", "digest", ib)
  915. delete(intermediateBlobs, c.Param("digest"))
  916. } else if err != nil {
  917. c.AbortWithStatusJSON(http.StatusInternalServerError, gin.H{"error": err.Error()})
  918. return
  919. } else {
  920. c.Status(http.StatusOK)
  921. return
  922. }
  923. }
  924. path, err := GetBlobsPath(c.Param("digest"))
  925. if err != nil {
  926. c.AbortWithStatusJSON(http.StatusBadRequest, gin.H{"error": err.Error()})
  927. return
  928. }
  929. _, err = os.Stat(path)
  930. switch {
  931. case errors.Is(err, os.ErrNotExist):
  932. // noop
  933. case err != nil:
  934. c.AbortWithStatusJSON(http.StatusInternalServerError, gin.H{"error": err.Error()})
  935. return
  936. default:
  937. c.Status(http.StatusOK)
  938. return
  939. }
  940. layer, err := NewLayer(c.Request.Body, "")
  941. if err != nil {
  942. c.AbortWithStatusJSON(http.StatusInternalServerError, gin.H{"error": err.Error()})
  943. return
  944. }
  945. if layer.Digest != c.Param("digest") {
  946. c.AbortWithStatusJSON(http.StatusBadRequest, gin.H{"error": fmt.Sprintf("digest mismatch, expected %q, got %q", c.Param("digest"), layer.Digest)})
  947. return
  948. }
  949. c.Status(http.StatusCreated)
  950. }
  951. func isLocalIP(ip netip.Addr) bool {
  952. if interfaces, err := net.Interfaces(); err == nil {
  953. for _, iface := range interfaces {
  954. addrs, err := iface.Addrs()
  955. if err != nil {
  956. continue
  957. }
  958. for _, a := range addrs {
  959. if parsed, _, err := net.ParseCIDR(a.String()); err == nil {
  960. if parsed.String() == ip.String() {
  961. return true
  962. }
  963. }
  964. }
  965. }
  966. }
  967. return false
  968. }
  969. func allowedHost(host string) bool {
  970. host = strings.ToLower(host)
  971. if host == "" || host == "localhost" {
  972. return true
  973. }
  974. if hostname, err := os.Hostname(); err == nil && host == strings.ToLower(hostname) {
  975. return true
  976. }
  977. tlds := []string{
  978. "localhost",
  979. "local",
  980. "internal",
  981. }
  982. // check if the host is a local TLD
  983. for _, tld := range tlds {
  984. if strings.HasSuffix(host, "."+tld) {
  985. return true
  986. }
  987. }
  988. return false
  989. }
  990. func allowedHostsMiddleware(addr net.Addr) gin.HandlerFunc {
  991. return func(c *gin.Context) {
  992. if addr == nil {
  993. c.Next()
  994. return
  995. }
  996. if addr, err := netip.ParseAddrPort(addr.String()); err == nil && !addr.Addr().IsLoopback() {
  997. c.Next()
  998. return
  999. }
  1000. host, _, err := net.SplitHostPort(c.Request.Host)
  1001. if err != nil {
  1002. host = c.Request.Host
  1003. }
  1004. if addr, err := netip.ParseAddr(host); err == nil {
  1005. if addr.IsLoopback() || addr.IsPrivate() || addr.IsUnspecified() || isLocalIP(addr) {
  1006. c.Next()
  1007. return
  1008. }
  1009. }
  1010. if allowedHost(host) {
  1011. if c.Request.Method == http.MethodOptions {
  1012. c.AbortWithStatus(http.StatusNoContent)
  1013. return
  1014. }
  1015. c.Next()
  1016. return
  1017. }
  1018. c.AbortWithStatus(http.StatusForbidden)
  1019. }
  1020. }
  1021. func (s *Server) GenerateRoutes() http.Handler {
  1022. config := cors.DefaultConfig()
  1023. config.AllowWildcard = true
  1024. config.AllowBrowserExtensions = true
  1025. config.AllowHeaders = []string{"Authorization", "Content-Type", "User-Agent", "Accept", "X-Requested-With"}
  1026. openAIProperties := []string{"lang", "package-version", "os", "arch", "retry-count", "runtime", "runtime-version", "async"}
  1027. for _, prop := range openAIProperties {
  1028. config.AllowHeaders = append(config.AllowHeaders, "x-stainless-"+prop)
  1029. }
  1030. config.AllowOrigins = envconfig.Origins()
  1031. r := gin.Default()
  1032. r.Use(
  1033. cors.New(config),
  1034. allowedHostsMiddleware(s.addr),
  1035. )
  1036. r.POST("/api/pull", s.PullHandler)
  1037. r.POST("/api/generate", s.GenerateHandler)
  1038. r.POST("/api/chat", s.ChatHandler)
  1039. r.POST("/api/embed", s.EmbedHandler)
  1040. r.POST("/api/embeddings", s.EmbeddingsHandler)
  1041. r.POST("/api/create", s.CreateHandler)
  1042. r.POST("/api/push", s.PushHandler)
  1043. r.POST("/api/copy", s.CopyHandler)
  1044. r.DELETE("/api/delete", s.DeleteHandler)
  1045. r.POST("/api/show", s.ShowHandler)
  1046. r.POST("/api/blobs/:digest", s.CreateBlobHandler)
  1047. r.HEAD("/api/blobs/:digest", s.HeadBlobHandler)
  1048. r.GET("/api/ps", s.PsHandler)
  1049. // Compatibility endpoints
  1050. r.POST("/v1/chat/completions", openai.ChatMiddleware(), s.ChatHandler)
  1051. r.POST("/v1/completions", openai.CompletionsMiddleware(), s.GenerateHandler)
  1052. r.POST("/v1/embeddings", openai.EmbeddingsMiddleware(), s.EmbedHandler)
  1053. r.GET("/v1/models", openai.ListMiddleware(), s.ListHandler)
  1054. r.GET("/v1/models/:model", openai.RetrieveMiddleware(), s.ShowHandler)
  1055. for _, method := range []string{http.MethodGet, http.MethodHead} {
  1056. r.Handle(method, "/", func(c *gin.Context) {
  1057. c.String(http.StatusOK, "Ollama is running")
  1058. })
  1059. r.Handle(method, "/api/tags", s.ListHandler)
  1060. r.Handle(method, "/api/version", func(c *gin.Context) {
  1061. c.JSON(http.StatusOK, gin.H{"version": version.Version})
  1062. })
  1063. }
  1064. return r
  1065. }
  1066. func Serve(ln net.Listener) error {
  1067. level := slog.LevelInfo
  1068. if envconfig.Debug() {
  1069. level = slog.LevelDebug
  1070. }
  1071. slog.Info("server config", "env", envconfig.Values())
  1072. handler := slog.NewTextHandler(os.Stderr, &slog.HandlerOptions{
  1073. Level: level,
  1074. AddSource: true,
  1075. ReplaceAttr: func(_ []string, attr slog.Attr) slog.Attr {
  1076. if attr.Key == slog.SourceKey {
  1077. source := attr.Value.Any().(*slog.Source)
  1078. source.File = filepath.Base(source.File)
  1079. }
  1080. return attr
  1081. },
  1082. })
  1083. slog.SetDefault(slog.New(handler))
  1084. blobsDir, err := GetBlobsPath("")
  1085. if err != nil {
  1086. return err
  1087. }
  1088. if err := fixBlobs(blobsDir); err != nil {
  1089. return err
  1090. }
  1091. if !envconfig.NoPrune() {
  1092. if _, err := Manifests(false); err != nil {
  1093. slog.Warn("corrupt manifests detected, skipping prune operation. Re-pull or delete to clear", "error", err)
  1094. } else {
  1095. // clean up unused layers and manifests
  1096. if err := PruneLayers(); err != nil {
  1097. return err
  1098. }
  1099. manifestsPath, err := GetManifestPath()
  1100. if err != nil {
  1101. return err
  1102. }
  1103. if err := PruneDirectory(manifestsPath); err != nil {
  1104. return err
  1105. }
  1106. }
  1107. }
  1108. ctx, done := context.WithCancel(context.Background())
  1109. schedCtx, schedDone := context.WithCancel(ctx)
  1110. sched := InitScheduler(schedCtx)
  1111. s := &Server{addr: ln.Addr(), sched: sched}
  1112. http.Handle("/", s.GenerateRoutes())
  1113. slog.Info(fmt.Sprintf("Listening on %s (version %s)", ln.Addr(), version.Version))
  1114. srvr := &http.Server{
  1115. // Use http.DefaultServeMux so we get net/http/pprof for
  1116. // free.
  1117. //
  1118. // TODO(bmizerany): Decide if we want to make this
  1119. // configurable so it is not exposed by default, or allow
  1120. // users to bind it to a different port. This was a quick
  1121. // and easy way to get pprof, but it may not be the best
  1122. // way.
  1123. Handler: nil,
  1124. }
  1125. // listen for a ctrl+c and stop any loaded llm
  1126. signals := make(chan os.Signal, 1)
  1127. signal.Notify(signals, syscall.SIGINT, syscall.SIGTERM)
  1128. go func() {
  1129. <-signals
  1130. srvr.Close()
  1131. schedDone()
  1132. sched.unloadAllRunners()
  1133. done()
  1134. }()
  1135. // Locate and log what runners are present at startup
  1136. var runnerNames []string
  1137. for v := range runners.GetAvailableServers() {
  1138. runnerNames = append(runnerNames, v)
  1139. }
  1140. slog.Info("Dynamic LLM libraries", "runners", runnerNames)
  1141. slog.Debug("Override detection logic by setting OLLAMA_LLM_LIBRARY")
  1142. s.sched.Run(schedCtx)
  1143. // At startup we retrieve GPU information so we can get log messages before loading a model
  1144. // This will log warnings to the log in case we have problems with detected GPUs
  1145. gpus := discover.GetGPUInfo()
  1146. gpus.LogDetails()
  1147. err = srvr.Serve(ln)
  1148. // If server is closed from the signal handler, wait for the ctx to be done
  1149. // otherwise error out quickly
  1150. if !errors.Is(err, http.ErrServerClosed) {
  1151. return err
  1152. }
  1153. <-ctx.Done()
  1154. return nil
  1155. }
  1156. func waitForStream(c *gin.Context, ch chan interface{}) {
  1157. c.Header("Content-Type", "application/json")
  1158. for resp := range ch {
  1159. switch r := resp.(type) {
  1160. case api.ProgressResponse:
  1161. if r.Status == "success" {
  1162. c.JSON(http.StatusOK, r)
  1163. return
  1164. }
  1165. case gin.H:
  1166. status, ok := r["status"].(int)
  1167. if !ok {
  1168. status = http.StatusInternalServerError
  1169. }
  1170. if errorMsg, ok := r["error"].(string); ok {
  1171. c.JSON(status, gin.H{"error": errorMsg})
  1172. return
  1173. } else {
  1174. c.JSON(status, gin.H{"error": "unexpected error format in progress response"})
  1175. return
  1176. }
  1177. default:
  1178. c.JSON(http.StatusInternalServerError, gin.H{"error": "unexpected progress response"})
  1179. return
  1180. }
  1181. }
  1182. c.JSON(http.StatusInternalServerError, gin.H{"error": "unexpected end of progress response"})
  1183. }
  1184. func streamResponse(c *gin.Context, ch chan any) {
  1185. c.Header("Content-Type", "application/x-ndjson")
  1186. c.Stream(func(w io.Writer) bool {
  1187. val, ok := <-ch
  1188. if !ok {
  1189. return false
  1190. }
  1191. bts, err := json.Marshal(val)
  1192. if err != nil {
  1193. slog.Info(fmt.Sprintf("streamResponse: json.Marshal failed with %s", err))
  1194. return false
  1195. }
  1196. // Delineate chunks with new-line delimiter
  1197. bts = append(bts, '\n')
  1198. if _, err := w.Write(bts); err != nil {
  1199. slog.Info(fmt.Sprintf("streamResponse: w.Write failed with %s", err))
  1200. return false
  1201. }
  1202. return true
  1203. })
  1204. }
  1205. func (s *Server) PsHandler(c *gin.Context) {
  1206. models := []api.ProcessModelResponse{}
  1207. for _, v := range s.sched.loaded {
  1208. model := v.model
  1209. modelDetails := api.ModelDetails{
  1210. Format: model.Config.ModelFormat,
  1211. Family: model.Config.ModelFamily,
  1212. Families: model.Config.ModelFamilies,
  1213. ParameterSize: model.Config.ModelType,
  1214. QuantizationLevel: model.Config.FileType,
  1215. }
  1216. mr := api.ProcessModelResponse{
  1217. Model: model.ShortName,
  1218. Name: model.ShortName,
  1219. Size: int64(v.estimatedTotal),
  1220. SizeVRAM: int64(v.estimatedVRAM),
  1221. Digest: model.Digest,
  1222. Details: modelDetails,
  1223. ExpiresAt: v.expiresAt,
  1224. }
  1225. // The scheduler waits to set expiresAt, so if a model is loading it's
  1226. // possible that it will be set to the unix epoch. For those cases, just
  1227. // calculate the time w/ the sessionDuration instead.
  1228. var epoch time.Time
  1229. if v.expiresAt == epoch {
  1230. mr.ExpiresAt = time.Now().Add(v.sessionDuration)
  1231. }
  1232. models = append(models, mr)
  1233. }
  1234. slices.SortStableFunc(models, func(i, j api.ProcessModelResponse) int {
  1235. // longest duration remaining listed first
  1236. return cmp.Compare(j.ExpiresAt.Unix(), i.ExpiresAt.Unix())
  1237. })
  1238. c.JSON(http.StatusOK, api.ProcessResponse{Models: models})
  1239. }
  1240. func (s *Server) ChatHandler(c *gin.Context) {
  1241. checkpointStart := time.Now()
  1242. var req api.ChatRequest
  1243. if err := c.ShouldBindJSON(&req); errors.Is(err, io.EOF) {
  1244. c.AbortWithStatusJSON(http.StatusBadRequest, gin.H{"error": "missing request body"})
  1245. return
  1246. } else if err != nil {
  1247. c.AbortWithStatusJSON(http.StatusBadRequest, gin.H{"error": err.Error()})
  1248. return
  1249. }
  1250. // expire the runner
  1251. if len(req.Messages) == 0 && req.KeepAlive != nil && int(req.KeepAlive.Seconds()) == 0 {
  1252. model, err := GetModel(req.Model)
  1253. if err != nil {
  1254. switch {
  1255. case os.IsNotExist(err):
  1256. c.JSON(http.StatusNotFound, gin.H{"error": fmt.Sprintf("model '%s' not found", req.Model)})
  1257. case err.Error() == "invalid model name":
  1258. c.JSON(http.StatusBadRequest, gin.H{"error": err.Error()})
  1259. default:
  1260. c.JSON(http.StatusInternalServerError, gin.H{"error": err.Error()})
  1261. }
  1262. return
  1263. }
  1264. s.sched.expireRunner(model)
  1265. c.JSON(http.StatusOK, api.ChatResponse{
  1266. Model: req.Model,
  1267. CreatedAt: time.Now().UTC(),
  1268. Message: api.Message{Role: "assistant"},
  1269. Done: true,
  1270. DoneReason: "unload",
  1271. })
  1272. return
  1273. }
  1274. caps := []Capability{CapabilityCompletion}
  1275. if len(req.Tools) > 0 {
  1276. caps = append(caps, CapabilityTools)
  1277. }
  1278. name := model.ParseName(req.Model)
  1279. if !name.IsValid() {
  1280. c.JSON(http.StatusBadRequest, gin.H{"error": "model is required"})
  1281. return
  1282. }
  1283. name, err := getExistingName(name)
  1284. if err != nil {
  1285. c.JSON(http.StatusBadRequest, gin.H{"error": "model is required"})
  1286. return
  1287. }
  1288. r, m, opts, err := s.scheduleRunner(c.Request.Context(), name.String(), caps, req.Options, req.KeepAlive)
  1289. if errors.Is(err, errCapabilityCompletion) {
  1290. c.JSON(http.StatusBadRequest, gin.H{"error": fmt.Sprintf("%q does not support chat", req.Model)})
  1291. return
  1292. } else if err != nil {
  1293. handleScheduleError(c, req.Model, err)
  1294. return
  1295. }
  1296. checkpointLoaded := time.Now()
  1297. if len(req.Messages) == 0 {
  1298. c.JSON(http.StatusOK, api.ChatResponse{
  1299. Model: req.Model,
  1300. CreatedAt: time.Now().UTC(),
  1301. Message: api.Message{Role: "assistant"},
  1302. Done: true,
  1303. DoneReason: "load",
  1304. })
  1305. return
  1306. }
  1307. msgs := append(m.Messages, req.Messages...)
  1308. if req.Messages[0].Role != "system" && m.System != "" {
  1309. msgs = append([]api.Message{{Role: "system", Content: m.System}}, msgs...)
  1310. }
  1311. prompt, images, err := chatPrompt(c.Request.Context(), m, r.Tokenize, opts, msgs, req.Tools)
  1312. if err != nil {
  1313. slog.Error("chat prompt error", "error", err)
  1314. c.JSON(http.StatusInternalServerError, gin.H{"error": err.Error()})
  1315. return
  1316. }
  1317. slog.Debug("chat request", "images", len(images), "prompt", prompt)
  1318. ch := make(chan any)
  1319. go func() {
  1320. defer close(ch)
  1321. var sb strings.Builder
  1322. var toolCallIndex int = 0
  1323. if err := r.Completion(c.Request.Context(), llm.CompletionRequest{
  1324. Prompt: prompt,
  1325. Images: images,
  1326. Format: req.Format,
  1327. Options: opts,
  1328. }, func(r llm.CompletionResponse) {
  1329. res := api.ChatResponse{
  1330. Model: req.Model,
  1331. CreatedAt: time.Now().UTC(),
  1332. Message: api.Message{Role: "assistant", Content: r.Content},
  1333. Done: r.Done,
  1334. DoneReason: r.DoneReason,
  1335. Metrics: api.Metrics{
  1336. PromptEvalCount: r.PromptEvalCount,
  1337. PromptEvalDuration: r.PromptEvalDuration,
  1338. EvalCount: r.EvalCount,
  1339. EvalDuration: r.EvalDuration,
  1340. },
  1341. }
  1342. if r.Done {
  1343. res.TotalDuration = time.Since(checkpointStart)
  1344. res.LoadDuration = checkpointLoaded.Sub(checkpointStart)
  1345. }
  1346. // TODO: tool call checking and filtering should be moved outside of this callback once streaming
  1347. // however this was a simple change for now without reworking streaming logic of this (and other)
  1348. // handlers
  1349. if req.Stream != nil && !*req.Stream || len(req.Tools) == 0 {
  1350. ch <- res
  1351. return
  1352. }
  1353. // Streaming tool calls:
  1354. // If tools are recognized, use a flag to track the sending of a tool downstream
  1355. // This ensures that content is cleared from the message on the last chunk sent
  1356. sb.WriteString(r.Content)
  1357. if toolCalls, ok := m.parseToolCalls(sb.String()); ok {
  1358. res.Message.ToolCalls = toolCalls
  1359. for i := range toolCalls {
  1360. toolCalls[i].Function.Index = toolCallIndex
  1361. toolCallIndex++
  1362. }
  1363. res.Message.Content = ""
  1364. sb.Reset()
  1365. ch <- res
  1366. return
  1367. }
  1368. if r.Done {
  1369. // Send any remaining content if no tool calls were detected
  1370. if toolCallIndex == 0 {
  1371. res.Message.Content = sb.String()
  1372. }
  1373. ch <- res
  1374. }
  1375. }); err != nil {
  1376. ch <- gin.H{"error": err.Error()}
  1377. }
  1378. }()
  1379. if req.Stream != nil && !*req.Stream {
  1380. var resp api.ChatResponse
  1381. var sb strings.Builder
  1382. for rr := range ch {
  1383. switch t := rr.(type) {
  1384. case api.ChatResponse:
  1385. sb.WriteString(t.Message.Content)
  1386. resp = t
  1387. case gin.H:
  1388. msg, ok := t["error"].(string)
  1389. if !ok {
  1390. msg = "unexpected error format in response"
  1391. }
  1392. c.JSON(http.StatusInternalServerError, gin.H{"error": msg})
  1393. return
  1394. default:
  1395. c.JSON(http.StatusInternalServerError, gin.H{"error": "unexpected response"})
  1396. return
  1397. }
  1398. }
  1399. resp.Message.Content = sb.String()
  1400. if len(req.Tools) > 0 {
  1401. if toolCalls, ok := m.parseToolCalls(sb.String()); ok {
  1402. resp.Message.ToolCalls = toolCalls
  1403. resp.Message.Content = ""
  1404. }
  1405. }
  1406. c.JSON(http.StatusOK, resp)
  1407. return
  1408. }
  1409. streamResponse(c, ch)
  1410. }
  1411. func handleScheduleError(c *gin.Context, name string, err error) {
  1412. switch {
  1413. case errors.Is(err, errCapabilities), errors.Is(err, errRequired):
  1414. c.JSON(http.StatusBadRequest, gin.H{"error": err.Error()})
  1415. case errors.Is(err, context.Canceled):
  1416. c.JSON(499, gin.H{"error": "request canceled"})
  1417. case errors.Is(err, ErrMaxQueue):
  1418. c.JSON(http.StatusServiceUnavailable, gin.H{"error": err.Error()})
  1419. case errors.Is(err, os.ErrNotExist):
  1420. c.JSON(http.StatusNotFound, gin.H{"error": fmt.Sprintf("model %q not found, try pulling it first", name)})
  1421. default:
  1422. c.JSON(http.StatusInternalServerError, gin.H{"error": err.Error()})
  1423. }
  1424. }