{"$schema":"https://json-schema.org/draft/2020-12/schema","$id":"https://localllmguide.com/schema/local-ai-reference.v1.json","title":"LocalLLMGuide Reference Dataset v1","type":"object","required":["dataset_metadata","sources","claims","models","model_artifacts","software","hardware","compatibility_records","hardware_fit_records","benchmark_results","network_events","pages","relationships","freshness_rules"],"properties":{"dataset_metadata":{"$ref":"#/$defs/DatasetMetadata"},"sources":{"type":"array","items":{"$ref":"#/$defs/Source"}},"claims":{"type":"array","items":{"$ref":"#/$defs/Claim"}},"licenses":{"type":"array","items":{"$ref":"#/$defs/LicenseRecord"}},"models":{"type":"array","items":{"$ref":"#/$defs/Model"}},"model_artifacts":{"type":"array","items":{"$ref":"#/$defs/ModelArtifact"}},"software":{"type":"array","items":{"$ref":"#/$defs/SoftwareProduct"}},"hardware":{"type":"array","items":{"$ref":"#/$defs/HardwareProduct"}},"compatibility_records":{"type":"array","items":{"$ref":"#/$defs/CompatibilityRecord"}},"hardware_fit_records":{"type":"array","items":{"$ref":"#/$defs/HardwareFitRecord"}},"benchmark_results":{"type":"array","items":{"$ref":"#/$defs/BenchmarkResult"}},"network_events":{"type":"array","items":{"$ref":"#/$defs/NetworkEvent"}},"price_observations":{"type":"array","items":{"$ref":"#/$defs/PriceObservation"}},"pages":{"type":"array","items":{"$ref":"#/$defs/Page"}},"relationships":{"type":"array","items":{"$ref":"#/$defs/Relationship"}},"freshness_rules":{"type":"array","items":{"$ref":"#/$defs/FreshnessRule"}}},"$defs":{"ISODate":{"type":"string","format":"date"},"ISODateTime":{"type":"string","format":"date-time"},"Identifier":{"type":"string","pattern":"^[a-z0-9][a-z0-9._:-]*$"},"DatasetMetadata":{"type":"object","required":["schema_version","generated_at","research_cutoff","site_version"],"properties":{"schema_version":{"type":"string"},"generated_at":{"$ref":"#/$defs/ISODateTime"},"research_cutoff":{"$ref":"#/$defs/ISODate"},"site_version":{"type":"string"},"notes":{"type":"string"}}},"Source":{"type":"object","required":["id","url","title","owner","source_type","retrieved_at","status"],"properties":{"id":{"$ref":"#/$defs/Identifier"},"url":{"type":"string","format":"uri"},"title":{"type":"string"},"owner":{"type":"string"},"source_type":{"enum":["manufacturer_vendor_primary","official_model_card","official_repository","official_release_notes","license_or_terms","paper_or_technical_report","benchmark_owner","independent_benchmark","government_statistics","community_observation","editorial_estimate","audited_site","internal_editorial_provenance"]},"publication_date":{"$ref":"#/$defs/ISODate"},"updated_date":{"$ref":"#/$defs/ISODate"},"retrieved_at":{"$ref":"#/$defs/ISODateTime"},"last_checked_at":{"$ref":"#/$defs/ISODateTime"},"content_hash":{"type":"string"},"status":{"enum":["active","redirected","removed","unavailable","changed_requires_review"]},"notes":{"type":"string"}}},"Claim":{"type":"object","required":["id","subject_entity_id","field_path","claim_type","source_ids","source_authority","local_verification","confidence","freshness","last_verified_at"],"properties":{"id":{"$ref":"#/$defs/Identifier"},"subject_entity_id":{"$ref":"#/$defs/Identifier"},"field_path":{"type":"string"},"value":{},"claim_type":{"enum":["specification","compatibility","license","price","privacy_behavior","vendor_performance_claim","measured_performance","editorial_estimate","editorial_recommendation","lifecycle","release_status","setup_instruction"]},"source_ids":{"type":"array","minItems":1,"items":{"$ref":"#/$defs/Identifier"}},"source_authority":{"enum":["primary","strong_secondary","community","editorial"]},"local_verification":{"enum":["reproduced","partially_reproduced","not_reproduced","not_applicable"]},"confidence":{"enum":["high","medium","low","unknown","conflicting"]},"freshness":{"enum":["current","review_due","stale","source_removed","conflicting_evidence"]},"version_scope":{"type":"object","additionalProperties":{"type":["string","number","boolean"]}},"hardware_scope":{"type":"object","additionalProperties":{"type":["string","number","boolean"]}},"effective_from":{"$ref":"#/$defs/ISODate"},"last_verified_at":{"$ref":"#/$defs/ISODateTime"},"next_review_at":{"$ref":"#/$defs/ISODateTime"},"notes":{"type":"string"}}},"LicenseRecord":{"type":"object","required":["id","name","classification","source_id","version_or_effective_date"],"properties":{"id":{"$ref":"#/$defs/Identifier"},"name":{"type":"string"},"classification":{"enum":["permissive_software","open_model_custom","community_license","source_available","proprietary_free","commercial","research_only","noncommercial","unknown"]},"source_id":{"$ref":"#/$defs/Identifier"},"version_or_effective_date":{"type":"string"},"commercial_use":{"enum":["generally_permitted_subject_to_terms","restricted","noncommercial_only","unknown"]},"redistribution":{"enum":["permitted_subject_to_terms","restricted","prohibited","unknown"]},"derivatives":{"enum":["permitted_subject_to_terms","restricted","prohibited","unknown"]},"hosted_service":{"enum":["addressed","not_addressed","restricted","unknown"]},"aup_id":{"$ref":"#/$defs/Identifier"},"summary_not_legal_advice":{"type":"string"}}},"ContextSpec":{"type":"object","properties":{"native_tokens":{"type":"integer","minimum":0},"extended_tokens":{"type":"integer","minimum":0},"extension_method":{"type":"string"},"tested_practical_tokens":{"type":"integer","minimum":0},"tested_practical_evidence_id":{"$ref":"#/$defs/Identifier"}}},"Model":{"type":"object","required":["id","slug","name","provider","family","lifecycle","deployment_class","model_types","architecture_type","official_weight_status"],"properties":{"id":{"$ref":"#/$defs/Identifier"},"slug":{"type":"string"},"name":{"type":"string"},"provider":{"type":"string"},"family":{"type":"string"},"variant":{"type":"string"},"release_date":{"$ref":"#/$defs/ISODate"},"lifecycle":{"enum":["current_recommended_candidate","current_specialized","current_compatibility","superseded","legacy","experimental","preview","api_only_weights_unverified","deprecated"]},"successor_model_ids":{"type":"array","items":{"$ref":"#/$defs/Identifier"}},"deployment_class":{"enum":["edge","consumer","workstation","multi_gpu","server_datacenter"]},"model_types":{"type":"array","items":{"enum":["text_chat","reasoning","code","embedding","reranker","vision_language","multimodal","audio","speech_to_text","text_to_speech","image_generation","safety"]}},"architecture_type":{"enum":["dense_transformer","moe","latent_moe","mamba_transformer_hybrid","ssm_hybrid","embedding_encoder","cross_encoder_reranker","colbert_multi_vector","diffusion","other"]},"total_parameters":{"type":"number","minimum":0},"active_parameters":{"type":"number","minimum":0},"effective_parameters":{"type":"number","minimum":0},"parameter_notes":{"type":"string"},"modalities_input":{"type":"array","items":{"type":"string"}},"modalities_output":{"type":"array","items":{"type":"string"}},"context":{"$ref":"#/$defs/ContextSpec"},"languages":{"type":"array","items":{"type":"string"}},"reasoning_controls":{"type":"array","items":{"type":"string"}},"tool_calling_training":{"enum":["documented","not_documented","none","unknown"]},"structured_output_training":{"enum":["documented","not_documented","none","unknown"]},"official_weight_status":{"enum":["official_downloadable","official_gated","api_only","weights_unverified","withdrawn"]},"license_id":{"$ref":"#/$defs/Identifier"},"artifact_ids":{"type":"array","items":{"$ref":"#/$defs/Identifier"}},"claim_ids":{"type":"array","items":{"$ref":"#/$defs/Identifier"}}}},"ModelArtifact":{"type":"object","required":["id","model_id","format","official_status","precision_or_quantization"],"properties":{"id":{"$ref":"#/$defs/Identifier"},"model_id":{"$ref":"#/$defs/Identifier"},"format":{"enum":["safetensors","gguf","mlx","onnx","awq","gptq","exl3","tensorrt_llm","mxfp4","nvfp4","fp8","bf16","other"]},"precision_or_quantization":{"type":"string"},"official_status":{"enum":["official","vendor_partner","third_party_trusted","third_party_unverified"]},"repository_url":{"type":"string","format":"uri"},"file_name":{"type":"string"},"size_bytes":{"type":"integer","minimum":0},"checksum":{"type":"string"},"vision_encoder_bytes":{"type":"integer","minimum":0},"audio_encoder_bytes":{"type":"integer","minimum":0},"runtime_compatibility_ids":{"type":"array","items":{"$ref":"#/$defs/Identifier"}},"license_id":{"$ref":"#/$defs/Identifier"},"last_verified_at":{"$ref":"#/$defs/ISODateTime"}}},"APICompatibility":{"type":"object","properties":{"chat_completions":{"type":"string"},"responses":{"type":"string"},"completions":{"type":"string"},"embeddings":{"type":"string"},"audio_transcriptions":{"type":"string"},"audio_speech":{"type":"string"},"images":{"type":"string"},"models":{"type":"string"},"anthropic_messages":{"type":"string"},"tools":{"type":"string"},"structured_outputs":{"type":"string"},"streaming":{"type":"string"},"notes":{"type":"string"}}},"SoftwareProduct":{"type":"object","required":["id","slug","name","primary_layer","roles","license_id","current_version","verified_at"],"properties":{"id":{"$ref":"#/$defs/Identifier"},"slug":{"type":"string"},"name":{"type":"string"},"primary_layer":{"enum":["model_distribution","artifact_format","inference_engine","runtime_server","router_gateway","desktop_application","web_application","rag_platform","rag_component","agent_or_coding_harness","multimodal_engine","developer_framework"]},"roles":{"type":"array","items":{"type":"string"}},"license_id":{"$ref":"#/$defs/Identifier"},"current_version":{"type":"string"},"release_date":{"$ref":"#/$defs/ISODate"},"verified_at":{"$ref":"#/$defs/ISODateTime"},"operating_systems":{"type":"array","items":{"type":"string"}},"hardware_backends":{"type":"array","items":{"type":"string"}},"artifact_formats":{"type":"array","items":{"type":"string"}},"api_compatibility":{"$ref":"#/$defs/APICompatibility"},"features":{"type":"array","items":{"type":"string"}},"locality_rating":{"enum":["L0_local_inference_only","L1_local_core_workflow","L2_fully_self_hostable","L3_verified_offline_airgap_capable","unknown"]},"network_event_ids":{"type":"array","items":{"$ref":"#/$defs/Identifier"}},"claim_ids":{"type":"array","items":{"$ref":"#/$defs/Identifier"}}}},"MemorySpec":{"type":"object","properties":{"system_ram_bytes":{"type":"integer","minimum":0},"vram_bytes":{"type":"integer","minimum":0},"unified_memory_bytes":{"type":"integer","minimum":0},"memory_bandwidth_gb_s":{"type":"number","minimum":0},"topology":{"enum":["cpu_dram","discrete_gpu","unified_memory","coherent_cpu_gpu","distributed_multi_gpu","other"]},"allocatable_gpu_memory_bytes":{"type":"integer","minimum":0},"notes":{"type":"string"}}},"HardwareProduct":{"type":"object","required":["id","slug","name","vendor","product_type","market_status","memory"],"properties":{"id":{"$ref":"#/$defs/Identifier"},"slug":{"type":"string"},"name":{"type":"string"},"vendor":{"type":"string"},"family":{"type":"string"},"sku":{"type":"string"},"product_type":{"enum":["laptop","desktop","mini_pc","gpu","workstation","server_appliance","edge_device","capacity_profile"]},"market_status":{"enum":["announced","shipping","legacy_existing_owner","discontinued","unknown"]},"announcement_date":{"$ref":"#/$defs/ISODate"},"availability_date":{"$ref":"#/$defs/ISODate"},"memory":{"$ref":"#/$defs/MemorySpec"},"accelerator_architecture":{"type":"string"},"power_spec_watts":{"type":"number","minimum":0},"price_observation_ids":{"type":"array","items":{"$ref":"#/$defs/Identifier"}},"supported_backend_claim_ids":{"type":"array","items":{"$ref":"#/$defs/Identifier"}},"independent_benchmark_ids":{"type":"array","items":{"$ref":"#/$defs/Identifier"}},"claim_ids":{"type":"array","items":{"$ref":"#/$defs/Identifier"}}}},"CompatibilityRecord":{"type":"object","required":["id","model_or_artifact_id","software_id","software_version","feature","status","verified_at","evidence_claim_ids"],"properties":{"id":{"$ref":"#/$defs/Identifier"},"model_or_artifact_id":{"$ref":"#/$defs/Identifier"},"software_id":{"$ref":"#/$defs/Identifier"},"software_version":{"type":"string"},"hardware_id":{"$ref":"#/$defs/Identifier"},"operating_system":{"type":"string"},"backend":{"type":"string"},"feature":{"enum":["load","text_generation","vision","audio","embeddings","reranking","tool_calling","parallel_tool_calling","structured_output","chat_template","long_context","api_chat","api_responses","api_anthropic_messages"]},"status":{"enum":["verified_working","partially_working","documented_not_tested","unsupported","broken","unknown"]},"verified_at":{"$ref":"#/$defs/ISODateTime"},"evidence_claim_ids":{"type":"array","minItems":1,"items":{"$ref":"#/$defs/Identifier"}},"notes":{"type":"string"}}},"HardwareFitRecord":{"type":"object","required":["id","model_artifact_id","hardware_id","runtime_id","context_tokens","concurrent_sequences","fit_label","evidence_type"],"properties":{"id":{"$ref":"#/$defs/Identifier"},"model_artifact_id":{"$ref":"#/$defs/Identifier"},"hardware_id":{"$ref":"#/$defs/Identifier"},"runtime_id":{"$ref":"#/$defs/Identifier"},"runtime_version":{"type":"string"},"backend":{"type":"string"},"context_tokens":{"type":"integer","minimum":0},"concurrent_sequences":{"type":"integer","minimum":1},"kv_precision":{"type":"string"},"offload_mode":{"enum":["full_accelerator","partial_offload","cpu_only","unified_memory","multi_gpu"]},"weights_bytes":{"type":"integer","minimum":0},"kv_bytes":{"type":"integer","minimum":0},"runtime_workspace_min_bytes":{"type":"integer","minimum":0},"runtime_workspace_max_bytes":{"type":"integer","minimum":0},"modality_bytes":{"type":"integer","minimum":0},"os_reserve_bytes":{"type":"integer","minimum":0},"fit_label":{"enum":["comfortable_capacity","fits","tight","offload_required","swap_dependent","unknown_architecture","does_not_fit"]},"evidence_type":{"enum":["measured","architecture_derived_estimate","estimated","rough_planning_estimate"]},"performance_status":{"enum":["measured_interactive","measured_slow","unmeasured","not_applicable"]},"benchmark_result_ids":{"type":"array","items":{"$ref":"#/$defs/Identifier"}},"verified_at":{"$ref":"#/$defs/ISODateTime"}}},"BenchmarkResult":{"type":"object","required":["id","evidence_class","test_date","hardware_id","software_id","software_version","model_artifact_id","context_tokens","prompt_tokens","output_tokens"],"properties":{"id":{"$ref":"#/$defs/Identifier"},"evidence_class":{"enum":["A_vendor","B_independent_reproduced","C_community_anecdote","D_localllmguide_reproduced"]},"test_date":{"$ref":"#/$defs/ISODate"},"hardware_id":{"$ref":"#/$defs/Identifier"},"operating_system":{"type":"string"},"driver_version":{"type":"string"},"software_id":{"$ref":"#/$defs/Identifier"},"software_version":{"type":"string"},"backend":{"type":"string"},"model_artifact_id":{"$ref":"#/$defs/Identifier"},"context_tokens":{"type":"integer","minimum":0},"prompt_tokens":{"type":"integer","minimum":0},"output_tokens":{"type":"integer","minimum":0},"concurrency":{"type":"integer","minimum":1},"prompt_tokens_per_second":{"type":"number","minimum":0},"decode_tokens_per_second":{"type":"number","minimum":0},"time_to_first_token_ms":{"type":"number","minimum":0},"peak_memory_bytes":{"type":"integer","minimum":0},"wall_power_watts":{"type":"number","minimum":0},"sustained_duration_seconds":{"type":"number","minimum":0},"source_claim_ids":{"type":"array","items":{"$ref":"#/$defs/Identifier"}},"notes":{"type":"string"}}},"NetworkEvent":{"type":"object","required":["id","software_id","feature","trigger","destination","data_types","required_or_optional","can_disable","vendor_documented","verified_at"],"properties":{"id":{"$ref":"#/$defs/Identifier"},"software_id":{"$ref":"#/$defs/Identifier"},"feature":{"type":"string"},"trigger":{"type":"string"},"destination":{"type":"string"},"data_types":{"type":"array","items":{"type":"string"}},"required_or_optional":{"enum":["required","optional","setup_only","unknown"]},"can_disable":{"enum":["yes","no","unknown"]},"works_offline_after_disable":{"enum":["yes","no","partial","unknown"]},"vendor_documented":{"type":"boolean"},"independently_verified":{"type":"boolean"},"verified_at":{"$ref":"#/$defs/ISODateTime"},"claim_ids":{"type":"array","items":{"$ref":"#/$defs/Identifier"}},"notes":{"type":"string"}}},"PriceObservation":{"type":"object","required":["id","subject_entity_id","price_type","amount","currency","region","observed_at","source_id"],"properties":{"id":{"$ref":"#/$defs/Identifier"},"subject_entity_id":{"$ref":"#/$defs/Identifier"},"price_type":{"enum":["msrp","vendor_list","street_observation","api_input_per_million","api_output_per_million","gpu_hour","subscription","electricity_per_kwh"]},"amount":{"type":"number","minimum":0},"currency":{"type":"string"},"region":{"type":"string"},"configuration":{"type":"string"},"observed_at":{"$ref":"#/$defs/ISODateTime"},"expires_or_review_at":{"$ref":"#/$defs/ISODateTime"},"source_id":{"$ref":"#/$defs/Identifier"}}},"Page":{"type":"object","required":["id","route","title","page_type","status","published_at","last_content_reviewed_at","next_review_due_at"],"properties":{"id":{"$ref":"#/$defs/Identifier"},"route":{"type":"string","pattern":"^/"},"canonical_route":{"type":"string","pattern":"^/"},"redirect_from":{"type":"array","items":{"type":"string","pattern":"^/"}},"title":{"type":"string"},"page_type":{"enum":["hub","model_record","software_record","hardware_record","comparison","guide","reference","troubleshooting","tool","methodology","source_registry","changelog","status_dashboard"]},"status":{"enum":["draft","published","redirect","deprecated","archived"]},"entity_ids":{"type":"array","items":{"$ref":"#/$defs/Identifier"}},"claim_ids":{"type":"array","items":{"$ref":"#/$defs/Identifier"}},"published_at":{"$ref":"#/$defs/ISODateTime"},"last_content_reviewed_at":{"$ref":"#/$defs/ISODateTime"},"dynamic_data_refreshed_at":{"$ref":"#/$defs/ISODateTime"},"next_review_due_at":{"$ref":"#/$defs/ISODateTime"},"review_owner":{"type":"string"},"template_version":{"type":"string"}}},"Relationship":{"type":"object","required":["id","from_entity_id","relationship_type","to_entity_id"],"properties":{"id":{"$ref":"#/$defs/Identifier"},"from_entity_id":{"$ref":"#/$defs/Identifier"},"relationship_type":{"enum":["member_of_family","successor_to","supersedes","derived_from","available_as_artifact","runs_on_software","compatible_with_hardware","recommended_for_task","uses_component","requires_component","has_license","supported_by_source","troubleshoots","compared_with"]},"to_entity_id":{"$ref":"#/$defs/Identifier"},"claim_ids":{"type":"array","items":{"$ref":"#/$defs/Identifier"}}}},"FreshnessRule":{"type":"object","required":["id","data_class","routine_review_days","trigger_events"],"properties":{"id":{"$ref":"#/$defs/Identifier"},"data_class":{"enum":["runtime_capability","install_instruction","api_compatibility","model_discovery","model_specification","model_license","legacy_model","hardware_specification","hardware_recommendation","hardware_price","api_price","cloud_gpu_price","benchmark","privacy_behavior","troubleshooting","evergreen_concept","source_link"]},"routine_review_days":{"type":"integer","minimum":1},"trigger_events":{"type":"array","items":{"type":"string"}},"stale_behavior":{"enum":["hide_recommendation","show_warning","queue_review","archive","redirect"]},"owner":{"type":"string"}}}}}