kernels

List kernels

Changed on

List kernels with optional filtering, sorting, and pagination

get/api/kernels

Request

  • Base URL: https://huggingface.co
  • URL: https://huggingface.co/api/kernels
  • Auth: HTTP bearer

Query parameters

searchstring

Filter by search term

string
OR
string[]
string
OR
string[]
string
OR
string[]
string
OR
string[]
sort'downloads' | 'likes' | 'lastModified' | 'trendingScore' | 'likes30d' | '_id' | 'id'

Sort field (e.g. downloads, likes, lastModified, trendingScore)

direction'1' | '-1'

Sort direction: 1 for ascending, -1 for descending

limitinteger

Maximum number of results to return

cursorstring

Pagination cursor from Link header

fullboolean

Return full kernel info including author, sha, lastModified, files, gated

gatedboolean

Filter by gated

'author' | 'cardData' | 'disabled' | 'downloads' | 'downloadsAllTime' | 'gated' | 'lastModified' | 'createdAt' | 'likes' | 'private' | 'sha' | 'files' | 'tags' | 'trendingScore' | 'buildMetadata' | 'supportedDriverFamilies' | 'resourceGroup' | 'arxivIds'
OR
string[]

Response

List of kernels

_idstring required
idstring required

Kernel ID in format namespace/name

authorstring

Namespace (user or organization) of the kernel

privateboolean

Whether the kernel is private

cardDataobject

Kernel card metadata

disabledboolean

Whether the kernel is disabled

downloadsinteger

Number of downloads in the last 30 days

downloadsAllTimeinteger

Total number of downloads

lastModifiedstring date-time

Last modification timestamp

createdAtstring date-time

Creation timestamp

likesinteger

Number of likes

shastring

Current commit SHA

filesstring[]

List of files in the kernel

tagsstring[]

Kernel tags

trendingScorenumber

Trending score

supportedDriverFamiliesstring[]

Driver families supported by the kernel (derived from build metadata)

Changes

  • 4a440619c9feRevision changes
    • warning

      removed the optional property /// from the response with the status

    • warning

      added the new 2.11 enum value to the //// response property for the response status

    • warning

      added the new 2.12 enum value to the //// response property for the response status

    • warning

      added the new 2.13 enum value to the //// response property for the response status

    • warning

      added the new 2.14 enum value to the //// response property for the response status

    • info

      added the optional property /// to the response with the status

  • bd17546f47b8Revision changes
    • breaking

      the ///// response's property type changed from no type to string for status

    • breaking

      the //// response's property type changed from no type to boolean for status

    • breaking

      the //// response's property type changed from no type to string for status

    • breaking

      the //// response's property type changed from no type to string for status

    • breaking

      the //// response's property type changed from no type to string for status

    • breaking

      the //// response's property type changed from no type to string for status

    • breaking

      the // response's property type changed from no type to string for status

    • info

      for the query request parameter direction, the type was generalized from no type to string

    • info

      for the query request parameter sort, the type was generalized from no type to string

    • info

      added subschema #2 subschema #3 to the / response property anyOf list for the response status

    • info

      removed subschema #2 subschema #3 from the / response property anyOf list for the response status

    • info

      the / response's property pattern was changed from ^((\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-((0[13578]|1[02])-(0[1-9]|[12]\d|3[01])|(0[469]|11)-(0[1-9]|[12]\d|30)|(02)-(0[1-9]|1\d|2[0-8])))T([01]\d|2[0-3]):[0-5]\d:[0-5]\d(\.\d+)?(Z)$ to ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$ for the status

    • info

      the / response's property pattern was changed from ^((\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-((0[13578]|1[02])-(0[1-9]|[12]\d|3[01])|(0[469]|11)-(0[1-9]|[12]\d|30)|(02)-(0[1-9]|1\d|2[0-8])))T([01]\d|2[0-3]):[0-5]\d:[0-5]\d(\.\d+)?(Z)$ to ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$ for the status