{"openapi":"3.1.0","info":{"title":"modelread API","version":"0.2.0","description":"Hardware-aware fit, speed and launch commands for Hugging Face models. MCP: https://modelread.com/mcp"},"paths":{"/api/health":{"get":{"summary":"Health","operationId":"health_api_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/hardware":{"get":{"summary":"Hardware","operationId":"hardware_api_hardware_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/estimate":{"get":{"summary":"Estimate","operationId":"estimate_api_estimate_get","parameters":[{"name":"repo","in":"query","required":true,"schema":{"type":"string","title":"Repo"}},{"name":"hw","in":"query","required":false,"schema":{"type":"string","default":"rtx3090","title":"Hw"}},{"name":"ctx","in":"query","required":false,"schema":{"type":"integer","default":8192,"title":"Ctx"}},{"name":"ram","in":"query","required":false,"schema":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Ram"}},{"name":"kv","in":"query","required":false,"schema":{"type":"string","default":"f16","title":"Kv"}},{"name":"vision","in":"query","required":false,"schema":{"type":"boolean","default":false,"title":"Vision"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/ask":{"post":{"summary":"Api Ask","operationId":"api_ask_api_ask_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/ask/stream":{"post":{"summary":"Api Ask Stream","description":"Server-sent events: status → query → draft (deterministic answer) → final (with LLM rerank/summary).","operationId":"api_ask_stream_api_ask_stream_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/measurements":{"post":{"summary":"Api Submit","description":"Opt-in measurement submission (closed loop). No IP stored; validated, normalized, quarantined if implausible.","operationId":"api_submit_api_measurements_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/probes":{"post":{"summary":"Api Probes","description":"Opt-in skill-probe submission (per-domain accuracy for a repo/quant).","operationId":"api_probes_api_probes_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}},"get":{"summary":"Api Probes Get","operationId":"api_probes_get_api_probes_get","parameters":[{"name":"repo","in":"query","required":true,"schema":{"type":"string","title":"Repo"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/coefficients":{"get":{"summary":"Api Coeff","operationId":"api_coeff_api_coefficients_get","parameters":[{"name":"runtime","in":"query","required":false,"schema":{"type":"string","default":"llama.cpp","title":"Runtime"}},{"name":"backend","in":"query","required":false,"schema":{"type":"string","default":"cuda","title":"Backend"}},{"name":"device","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Device"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/matrix":{"get":{"summary":"Api Matrix","description":"Precomputed best variant per top model per hardware preset (32K context).","operationId":"api_matrix_api_matrix_get","parameters":[{"name":"hw","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Hw"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/changes":{"get":{"summary":"Api Changes","description":"What's new / changed on the Hub this week (curator diff log).","operationId":"api_changes_api_changes_get","parameters":[{"name":"days","in":"query","required":false,"schema":{"type":"integer","default":7,"title":"Days"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":100,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/traits":{"get":{"summary":"Api Traits","operationId":"api_traits_api_traits_get","parameters":[{"name":"repo","in":"query","required":true,"schema":{"type":"string","title":"Repo"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/search":{"get":{"summary":"Api Search","operationId":"api_search_api_search_get","parameters":[{"name":"task","in":"query","required":false,"schema":{"type":"string","default":"chat","title":"Task"}},{"name":"max_params_b","in":"query","required":false,"schema":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Max Params B"}},{"name":"q","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Q"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":20,"title":"Limit"}},{"name":"match","in":"query","required":false,"schema":{"type":"boolean","default":false,"title":"Match"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/facts":{"get":{"summary":"Api Facts","operationId":"api_facts_api_facts_get","parameters":[{"name":"repo","in":"query","required":true,"schema":{"type":"string","title":"Repo"}},{"name":"derivatives","in":"query","required":false,"schema":{"type":"boolean","default":true,"title":"Derivatives"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/facts/hardware":{"get":{"summary":"Api Facts Hardware","operationId":"api_facts_hardware_api_facts_hardware_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/facts/coefficients":{"get":{"summary":"Api Facts Coefficients","description":"Recomputed at most every 5 minutes (one pass is many small queries; a 1-vCPU host under load took 30 s+),\nserved stale while a refresh runs.","operationId":"api_facts_coefficients_api_facts_coefficients_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}}},"components":{"schemas":{"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}}},"servers":[{"url":"https://modelread.com"}]}