nvidia-nat 1.1.0a20251020__py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (480) hide show
  1. aiq/__init__.py +66 -0
  2. nat/agent/__init__.py +0 -0
  3. nat/agent/base.py +265 -0
  4. nat/agent/dual_node.py +72 -0
  5. nat/agent/prompt_optimizer/__init__.py +0 -0
  6. nat/agent/prompt_optimizer/prompt.py +68 -0
  7. nat/agent/prompt_optimizer/register.py +149 -0
  8. nat/agent/react_agent/__init__.py +0 -0
  9. nat/agent/react_agent/agent.py +394 -0
  10. nat/agent/react_agent/output_parser.py +104 -0
  11. nat/agent/react_agent/prompt.py +44 -0
  12. nat/agent/react_agent/register.py +168 -0
  13. nat/agent/reasoning_agent/__init__.py +0 -0
  14. nat/agent/reasoning_agent/reasoning_agent.py +227 -0
  15. nat/agent/register.py +23 -0
  16. nat/agent/rewoo_agent/__init__.py +0 -0
  17. nat/agent/rewoo_agent/agent.py +593 -0
  18. nat/agent/rewoo_agent/prompt.py +107 -0
  19. nat/agent/rewoo_agent/register.py +175 -0
  20. nat/agent/tool_calling_agent/__init__.py +0 -0
  21. nat/agent/tool_calling_agent/agent.py +246 -0
  22. nat/agent/tool_calling_agent/register.py +129 -0
  23. nat/authentication/__init__.py +14 -0
  24. nat/authentication/api_key/__init__.py +14 -0
  25. nat/authentication/api_key/api_key_auth_provider.py +96 -0
  26. nat/authentication/api_key/api_key_auth_provider_config.py +124 -0
  27. nat/authentication/api_key/register.py +26 -0
  28. nat/authentication/credential_validator/__init__.py +14 -0
  29. nat/authentication/credential_validator/bearer_token_validator.py +557 -0
  30. nat/authentication/exceptions/__init__.py +14 -0
  31. nat/authentication/exceptions/api_key_exceptions.py +38 -0
  32. nat/authentication/http_basic_auth/__init__.py +0 -0
  33. nat/authentication/http_basic_auth/http_basic_auth_provider.py +81 -0
  34. nat/authentication/http_basic_auth/register.py +30 -0
  35. nat/authentication/interfaces.py +96 -0
  36. nat/authentication/oauth2/__init__.py +14 -0
  37. nat/authentication/oauth2/oauth2_auth_code_flow_provider.py +140 -0
  38. nat/authentication/oauth2/oauth2_auth_code_flow_provider_config.py +39 -0
  39. nat/authentication/oauth2/oauth2_resource_server_config.py +124 -0
  40. nat/authentication/oauth2/register.py +25 -0
  41. nat/authentication/register.py +20 -0
  42. nat/builder/__init__.py +0 -0
  43. nat/builder/builder.py +317 -0
  44. nat/builder/component_utils.py +320 -0
  45. nat/builder/context.py +321 -0
  46. nat/builder/embedder.py +24 -0
  47. nat/builder/eval_builder.py +166 -0
  48. nat/builder/evaluator.py +29 -0
  49. nat/builder/framework_enum.py +25 -0
  50. nat/builder/front_end.py +73 -0
  51. nat/builder/function.py +714 -0
  52. nat/builder/function_base.py +380 -0
  53. nat/builder/function_info.py +625 -0
  54. nat/builder/intermediate_step_manager.py +206 -0
  55. nat/builder/llm.py +25 -0
  56. nat/builder/retriever.py +25 -0
  57. nat/builder/user_interaction_manager.py +78 -0
  58. nat/builder/workflow.py +160 -0
  59. nat/builder/workflow_builder.py +1365 -0
  60. nat/cli/__init__.py +14 -0
  61. nat/cli/cli_utils/__init__.py +0 -0
  62. nat/cli/cli_utils/config_override.py +231 -0
  63. nat/cli/cli_utils/validation.py +37 -0
  64. nat/cli/commands/__init__.py +0 -0
  65. nat/cli/commands/configure/__init__.py +0 -0
  66. nat/cli/commands/configure/channel/__init__.py +0 -0
  67. nat/cli/commands/configure/channel/add.py +28 -0
  68. nat/cli/commands/configure/channel/channel.py +34 -0
  69. nat/cli/commands/configure/channel/remove.py +30 -0
  70. nat/cli/commands/configure/channel/update.py +30 -0
  71. nat/cli/commands/configure/configure.py +33 -0
  72. nat/cli/commands/evaluate.py +139 -0
  73. nat/cli/commands/info/__init__.py +14 -0
  74. nat/cli/commands/info/info.py +47 -0
  75. nat/cli/commands/info/list_channels.py +32 -0
  76. nat/cli/commands/info/list_components.py +128 -0
  77. nat/cli/commands/mcp/__init__.py +14 -0
  78. nat/cli/commands/mcp/mcp.py +986 -0
  79. nat/cli/commands/object_store/__init__.py +14 -0
  80. nat/cli/commands/object_store/object_store.py +227 -0
  81. nat/cli/commands/optimize.py +90 -0
  82. nat/cli/commands/registry/__init__.py +14 -0
  83. nat/cli/commands/registry/publish.py +88 -0
  84. nat/cli/commands/registry/pull.py +118 -0
  85. nat/cli/commands/registry/registry.py +36 -0
  86. nat/cli/commands/registry/remove.py +108 -0
  87. nat/cli/commands/registry/search.py +153 -0
  88. nat/cli/commands/sizing/__init__.py +14 -0
  89. nat/cli/commands/sizing/calc.py +297 -0
  90. nat/cli/commands/sizing/sizing.py +27 -0
  91. nat/cli/commands/start.py +257 -0
  92. nat/cli/commands/uninstall.py +81 -0
  93. nat/cli/commands/validate.py +47 -0
  94. nat/cli/commands/workflow/__init__.py +14 -0
  95. nat/cli/commands/workflow/templates/__init__.py.j2 +0 -0
  96. nat/cli/commands/workflow/templates/config.yml.j2 +17 -0
  97. nat/cli/commands/workflow/templates/pyproject.toml.j2 +25 -0
  98. nat/cli/commands/workflow/templates/register.py.j2 +4 -0
  99. nat/cli/commands/workflow/templates/workflow.py.j2 +50 -0
  100. nat/cli/commands/workflow/workflow.py +37 -0
  101. nat/cli/commands/workflow/workflow_commands.py +403 -0
  102. nat/cli/entrypoint.py +141 -0
  103. nat/cli/main.py +60 -0
  104. nat/cli/register_workflow.py +522 -0
  105. nat/cli/type_registry.py +1069 -0
  106. nat/control_flow/__init__.py +0 -0
  107. nat/control_flow/register.py +20 -0
  108. nat/control_flow/router_agent/__init__.py +0 -0
  109. nat/control_flow/router_agent/agent.py +329 -0
  110. nat/control_flow/router_agent/prompt.py +48 -0
  111. nat/control_flow/router_agent/register.py +91 -0
  112. nat/control_flow/sequential_executor.py +166 -0
  113. nat/data_models/__init__.py +14 -0
  114. nat/data_models/agent.py +34 -0
  115. nat/data_models/api_server.py +843 -0
  116. nat/data_models/authentication.py +245 -0
  117. nat/data_models/common.py +171 -0
  118. nat/data_models/component.py +60 -0
  119. nat/data_models/component_ref.py +179 -0
  120. nat/data_models/config.py +434 -0
  121. nat/data_models/dataset_handler.py +169 -0
  122. nat/data_models/discovery_metadata.py +305 -0
  123. nat/data_models/embedder.py +27 -0
  124. nat/data_models/evaluate.py +130 -0
  125. nat/data_models/evaluator.py +26 -0
  126. nat/data_models/front_end.py +26 -0
  127. nat/data_models/function.py +64 -0
  128. nat/data_models/function_dependencies.py +80 -0
  129. nat/data_models/gated_field_mixin.py +242 -0
  130. nat/data_models/interactive.py +246 -0
  131. nat/data_models/intermediate_step.py +302 -0
  132. nat/data_models/invocation_node.py +38 -0
  133. nat/data_models/llm.py +27 -0
  134. nat/data_models/logging.py +26 -0
  135. nat/data_models/memory.py +27 -0
  136. nat/data_models/object_store.py +44 -0
  137. nat/data_models/optimizable.py +119 -0
  138. nat/data_models/optimizer.py +149 -0
  139. nat/data_models/profiler.py +54 -0
  140. nat/data_models/registry_handler.py +26 -0
  141. nat/data_models/retriever.py +30 -0
  142. nat/data_models/retry_mixin.py +35 -0
  143. nat/data_models/span.py +228 -0
  144. nat/data_models/step_adaptor.py +64 -0
  145. nat/data_models/streaming.py +33 -0
  146. nat/data_models/swe_bench_model.py +54 -0
  147. nat/data_models/telemetry_exporter.py +26 -0
  148. nat/data_models/temperature_mixin.py +44 -0
  149. nat/data_models/thinking_mixin.py +86 -0
  150. nat/data_models/top_p_mixin.py +44 -0
  151. nat/data_models/ttc_strategy.py +30 -0
  152. nat/embedder/__init__.py +0 -0
  153. nat/embedder/azure_openai_embedder.py +46 -0
  154. nat/embedder/nim_embedder.py +59 -0
  155. nat/embedder/openai_embedder.py +42 -0
  156. nat/embedder/register.py +22 -0
  157. nat/eval/__init__.py +14 -0
  158. nat/eval/config.py +62 -0
  159. nat/eval/dataset_handler/__init__.py +0 -0
  160. nat/eval/dataset_handler/dataset_downloader.py +106 -0
  161. nat/eval/dataset_handler/dataset_filter.py +52 -0
  162. nat/eval/dataset_handler/dataset_handler.py +431 -0
  163. nat/eval/evaluate.py +565 -0
  164. nat/eval/evaluator/__init__.py +14 -0
  165. nat/eval/evaluator/base_evaluator.py +77 -0
  166. nat/eval/evaluator/evaluator_model.py +58 -0
  167. nat/eval/intermediate_step_adapter.py +99 -0
  168. nat/eval/rag_evaluator/__init__.py +0 -0
  169. nat/eval/rag_evaluator/evaluate.py +178 -0
  170. nat/eval/rag_evaluator/register.py +143 -0
  171. nat/eval/register.py +26 -0
  172. nat/eval/remote_workflow.py +133 -0
  173. nat/eval/runners/__init__.py +14 -0
  174. nat/eval/runners/config.py +39 -0
  175. nat/eval/runners/multi_eval_runner.py +54 -0
  176. nat/eval/runtime_evaluator/__init__.py +14 -0
  177. nat/eval/runtime_evaluator/evaluate.py +123 -0
  178. nat/eval/runtime_evaluator/register.py +100 -0
  179. nat/eval/runtime_event_subscriber.py +52 -0
  180. nat/eval/swe_bench_evaluator/__init__.py +0 -0
  181. nat/eval/swe_bench_evaluator/evaluate.py +215 -0
  182. nat/eval/swe_bench_evaluator/register.py +36 -0
  183. nat/eval/trajectory_evaluator/__init__.py +0 -0
  184. nat/eval/trajectory_evaluator/evaluate.py +75 -0
  185. nat/eval/trajectory_evaluator/register.py +40 -0
  186. nat/eval/tunable_rag_evaluator/__init__.py +0 -0
  187. nat/eval/tunable_rag_evaluator/evaluate.py +242 -0
  188. nat/eval/tunable_rag_evaluator/register.py +52 -0
  189. nat/eval/usage_stats.py +41 -0
  190. nat/eval/utils/__init__.py +0 -0
  191. nat/eval/utils/eval_trace_ctx.py +89 -0
  192. nat/eval/utils/output_uploader.py +140 -0
  193. nat/eval/utils/tqdm_position_registry.py +40 -0
  194. nat/eval/utils/weave_eval.py +193 -0
  195. nat/experimental/__init__.py +0 -0
  196. nat/experimental/decorators/__init__.py +0 -0
  197. nat/experimental/decorators/experimental_warning_decorator.py +154 -0
  198. nat/experimental/test_time_compute/__init__.py +0 -0
  199. nat/experimental/test_time_compute/editing/__init__.py +0 -0
  200. nat/experimental/test_time_compute/editing/iterative_plan_refinement_editor.py +147 -0
  201. nat/experimental/test_time_compute/editing/llm_as_a_judge_editor.py +204 -0
  202. nat/experimental/test_time_compute/editing/motivation_aware_summarization.py +107 -0
  203. nat/experimental/test_time_compute/functions/__init__.py +0 -0
  204. nat/experimental/test_time_compute/functions/execute_score_select_function.py +105 -0
  205. nat/experimental/test_time_compute/functions/plan_select_execute_function.py +228 -0
  206. nat/experimental/test_time_compute/functions/ttc_tool_orchestration_function.py +205 -0
  207. nat/experimental/test_time_compute/functions/ttc_tool_wrapper_function.py +146 -0
  208. nat/experimental/test_time_compute/models/__init__.py +0 -0
  209. nat/experimental/test_time_compute/models/editor_config.py +132 -0
  210. nat/experimental/test_time_compute/models/scoring_config.py +112 -0
  211. nat/experimental/test_time_compute/models/search_config.py +120 -0
  212. nat/experimental/test_time_compute/models/selection_config.py +154 -0
  213. nat/experimental/test_time_compute/models/stage_enums.py +43 -0
  214. nat/experimental/test_time_compute/models/strategy_base.py +67 -0
  215. nat/experimental/test_time_compute/models/tool_use_config.py +41 -0
  216. nat/experimental/test_time_compute/models/ttc_item.py +48 -0
  217. nat/experimental/test_time_compute/register.py +35 -0
  218. nat/experimental/test_time_compute/scoring/__init__.py +0 -0
  219. nat/experimental/test_time_compute/scoring/llm_based_agent_scorer.py +168 -0
  220. nat/experimental/test_time_compute/scoring/llm_based_plan_scorer.py +168 -0
  221. nat/experimental/test_time_compute/scoring/motivation_aware_scorer.py +111 -0
  222. nat/experimental/test_time_compute/search/__init__.py +0 -0
  223. nat/experimental/test_time_compute/search/multi_llm_planner.py +128 -0
  224. nat/experimental/test_time_compute/search/multi_query_retrieval_search.py +122 -0
  225. nat/experimental/test_time_compute/search/single_shot_multi_plan_planner.py +128 -0
  226. nat/experimental/test_time_compute/selection/__init__.py +0 -0
  227. nat/experimental/test_time_compute/selection/best_of_n_selector.py +63 -0
  228. nat/experimental/test_time_compute/selection/llm_based_agent_output_selector.py +131 -0
  229. nat/experimental/test_time_compute/selection/llm_based_output_merging_selector.py +157 -0
  230. nat/experimental/test_time_compute/selection/llm_based_plan_selector.py +128 -0
  231. nat/experimental/test_time_compute/selection/threshold_selector.py +58 -0
  232. nat/front_ends/__init__.py +14 -0
  233. nat/front_ends/console/__init__.py +14 -0
  234. nat/front_ends/console/authentication_flow_handler.py +285 -0
  235. nat/front_ends/console/console_front_end_config.py +32 -0
  236. nat/front_ends/console/console_front_end_plugin.py +108 -0
  237. nat/front_ends/console/register.py +25 -0
  238. nat/front_ends/cron/__init__.py +14 -0
  239. nat/front_ends/fastapi/__init__.py +14 -0
  240. nat/front_ends/fastapi/auth_flow_handlers/__init__.py +0 -0
  241. nat/front_ends/fastapi/auth_flow_handlers/http_flow_handler.py +27 -0
  242. nat/front_ends/fastapi/auth_flow_handlers/websocket_flow_handler.py +142 -0
  243. nat/front_ends/fastapi/dask_client_mixin.py +65 -0
  244. nat/front_ends/fastapi/fastapi_front_end_config.py +272 -0
  245. nat/front_ends/fastapi/fastapi_front_end_controller.py +68 -0
  246. nat/front_ends/fastapi/fastapi_front_end_plugin.py +247 -0
  247. nat/front_ends/fastapi/fastapi_front_end_plugin_worker.py +1257 -0
  248. nat/front_ends/fastapi/html_snippets/__init__.py +14 -0
  249. nat/front_ends/fastapi/html_snippets/auth_code_grant_success.py +35 -0
  250. nat/front_ends/fastapi/intermediate_steps_subscriber.py +80 -0
  251. nat/front_ends/fastapi/job_store.py +602 -0
  252. nat/front_ends/fastapi/main.py +64 -0
  253. nat/front_ends/fastapi/message_handler.py +344 -0
  254. nat/front_ends/fastapi/message_validator.py +351 -0
  255. nat/front_ends/fastapi/register.py +25 -0
  256. nat/front_ends/fastapi/response_helpers.py +195 -0
  257. nat/front_ends/fastapi/step_adaptor.py +319 -0
  258. nat/front_ends/fastapi/utils.py +57 -0
  259. nat/front_ends/mcp/__init__.py +14 -0
  260. nat/front_ends/mcp/introspection_token_verifier.py +73 -0
  261. nat/front_ends/mcp/mcp_front_end_config.py +90 -0
  262. nat/front_ends/mcp/mcp_front_end_plugin.py +113 -0
  263. nat/front_ends/mcp/mcp_front_end_plugin_worker.py +268 -0
  264. nat/front_ends/mcp/memory_profiler.py +320 -0
  265. nat/front_ends/mcp/register.py +27 -0
  266. nat/front_ends/mcp/tool_converter.py +290 -0
  267. nat/front_ends/register.py +21 -0
  268. nat/front_ends/simple_base/__init__.py +14 -0
  269. nat/front_ends/simple_base/simple_front_end_plugin_base.py +56 -0
  270. nat/llm/__init__.py +0 -0
  271. nat/llm/aws_bedrock_llm.py +69 -0
  272. nat/llm/azure_openai_llm.py +57 -0
  273. nat/llm/litellm_llm.py +69 -0
  274. nat/llm/nim_llm.py +58 -0
  275. nat/llm/openai_llm.py +54 -0
  276. nat/llm/register.py +27 -0
  277. nat/llm/utils/__init__.py +14 -0
  278. nat/llm/utils/env_config_value.py +93 -0
  279. nat/llm/utils/error.py +17 -0
  280. nat/llm/utils/thinking.py +215 -0
  281. nat/memory/__init__.py +20 -0
  282. nat/memory/interfaces.py +183 -0
  283. nat/memory/models.py +112 -0
  284. nat/meta/pypi.md +58 -0
  285. nat/object_store/__init__.py +20 -0
  286. nat/object_store/in_memory_object_store.py +76 -0
  287. nat/object_store/interfaces.py +84 -0
  288. nat/object_store/models.py +38 -0
  289. nat/object_store/register.py +19 -0
  290. nat/observability/__init__.py +14 -0
  291. nat/observability/exporter/__init__.py +14 -0
  292. nat/observability/exporter/base_exporter.py +449 -0
  293. nat/observability/exporter/exporter.py +78 -0
  294. nat/observability/exporter/file_exporter.py +33 -0
  295. nat/observability/exporter/processing_exporter.py +550 -0
  296. nat/observability/exporter/raw_exporter.py +52 -0
  297. nat/observability/exporter/span_exporter.py +308 -0
  298. nat/observability/exporter_manager.py +335 -0
  299. nat/observability/mixin/__init__.py +14 -0
  300. nat/observability/mixin/batch_config_mixin.py +26 -0
  301. nat/observability/mixin/collector_config_mixin.py +23 -0
  302. nat/observability/mixin/file_mixin.py +288 -0
  303. nat/observability/mixin/file_mode.py +23 -0
  304. nat/observability/mixin/redaction_config_mixin.py +42 -0
  305. nat/observability/mixin/resource_conflict_mixin.py +134 -0
  306. nat/observability/mixin/serialize_mixin.py +61 -0
  307. nat/observability/mixin/tagging_config_mixin.py +62 -0
  308. nat/observability/mixin/type_introspection_mixin.py +496 -0
  309. nat/observability/processor/__init__.py +14 -0
  310. nat/observability/processor/batching_processor.py +308 -0
  311. nat/observability/processor/callback_processor.py +42 -0
  312. nat/observability/processor/falsy_batch_filter_processor.py +55 -0
  313. nat/observability/processor/intermediate_step_serializer.py +28 -0
  314. nat/observability/processor/processor.py +74 -0
  315. nat/observability/processor/processor_factory.py +70 -0
  316. nat/observability/processor/redaction/__init__.py +24 -0
  317. nat/observability/processor/redaction/contextual_redaction_processor.py +125 -0
  318. nat/observability/processor/redaction/contextual_span_redaction_processor.py +66 -0
  319. nat/observability/processor/redaction/redaction_processor.py +177 -0
  320. nat/observability/processor/redaction/span_header_redaction_processor.py +92 -0
  321. nat/observability/processor/span_tagging_processor.py +68 -0
  322. nat/observability/register.py +114 -0
  323. nat/observability/utils/__init__.py +14 -0
  324. nat/observability/utils/dict_utils.py +236 -0
  325. nat/observability/utils/time_utils.py +31 -0
  326. nat/plugins/.namespace +1 -0
  327. nat/profiler/__init__.py +0 -0
  328. nat/profiler/calc/__init__.py +14 -0
  329. nat/profiler/calc/calc_runner.py +626 -0
  330. nat/profiler/calc/calculations.py +288 -0
  331. nat/profiler/calc/data_models.py +188 -0
  332. nat/profiler/calc/plot.py +345 -0
  333. nat/profiler/callbacks/__init__.py +0 -0
  334. nat/profiler/callbacks/agno_callback_handler.py +295 -0
  335. nat/profiler/callbacks/base_callback_class.py +20 -0
  336. nat/profiler/callbacks/langchain_callback_handler.py +297 -0
  337. nat/profiler/callbacks/llama_index_callback_handler.py +205 -0
  338. nat/profiler/callbacks/semantic_kernel_callback_handler.py +238 -0
  339. nat/profiler/callbacks/token_usage_base_model.py +27 -0
  340. nat/profiler/data_frame_row.py +51 -0
  341. nat/profiler/data_models.py +24 -0
  342. nat/profiler/decorators/__init__.py +0 -0
  343. nat/profiler/decorators/framework_wrapper.py +180 -0
  344. nat/profiler/decorators/function_tracking.py +411 -0
  345. nat/profiler/forecasting/__init__.py +0 -0
  346. nat/profiler/forecasting/config.py +18 -0
  347. nat/profiler/forecasting/model_trainer.py +75 -0
  348. nat/profiler/forecasting/models/__init__.py +22 -0
  349. nat/profiler/forecasting/models/forecasting_base_model.py +42 -0
  350. nat/profiler/forecasting/models/linear_model.py +197 -0
  351. nat/profiler/forecasting/models/random_forest_regressor.py +269 -0
  352. nat/profiler/inference_metrics_model.py +28 -0
  353. nat/profiler/inference_optimization/__init__.py +0 -0
  354. nat/profiler/inference_optimization/bottleneck_analysis/__init__.py +0 -0
  355. nat/profiler/inference_optimization/bottleneck_analysis/nested_stack_analysis.py +460 -0
  356. nat/profiler/inference_optimization/bottleneck_analysis/simple_stack_analysis.py +258 -0
  357. nat/profiler/inference_optimization/data_models.py +386 -0
  358. nat/profiler/inference_optimization/experimental/__init__.py +0 -0
  359. nat/profiler/inference_optimization/experimental/concurrency_spike_analysis.py +468 -0
  360. nat/profiler/inference_optimization/experimental/prefix_span_analysis.py +404 -0
  361. nat/profiler/inference_optimization/llm_metrics.py +212 -0
  362. nat/profiler/inference_optimization/prompt_caching.py +163 -0
  363. nat/profiler/inference_optimization/token_uniqueness.py +107 -0
  364. nat/profiler/inference_optimization/workflow_runtimes.py +72 -0
  365. nat/profiler/intermediate_property_adapter.py +102 -0
  366. nat/profiler/parameter_optimization/__init__.py +0 -0
  367. nat/profiler/parameter_optimization/optimizable_utils.py +93 -0
  368. nat/profiler/parameter_optimization/optimizer_runtime.py +67 -0
  369. nat/profiler/parameter_optimization/parameter_optimizer.py +153 -0
  370. nat/profiler/parameter_optimization/parameter_selection.py +107 -0
  371. nat/profiler/parameter_optimization/pareto_visualizer.py +380 -0
  372. nat/profiler/parameter_optimization/prompt_optimizer.py +384 -0
  373. nat/profiler/parameter_optimization/update_helpers.py +66 -0
  374. nat/profiler/profile_runner.py +478 -0
  375. nat/profiler/utils.py +186 -0
  376. nat/registry_handlers/__init__.py +0 -0
  377. nat/registry_handlers/local/__init__.py +0 -0
  378. nat/registry_handlers/local/local_handler.py +176 -0
  379. nat/registry_handlers/local/register_local.py +37 -0
  380. nat/registry_handlers/metadata_factory.py +60 -0
  381. nat/registry_handlers/package_utils.py +570 -0
  382. nat/registry_handlers/pypi/__init__.py +0 -0
  383. nat/registry_handlers/pypi/pypi_handler.py +248 -0
  384. nat/registry_handlers/pypi/register_pypi.py +40 -0
  385. nat/registry_handlers/register.py +20 -0
  386. nat/registry_handlers/registry_handler_base.py +157 -0
  387. nat/registry_handlers/rest/__init__.py +0 -0
  388. nat/registry_handlers/rest/register_rest.py +56 -0
  389. nat/registry_handlers/rest/rest_handler.py +236 -0
  390. nat/registry_handlers/schemas/__init__.py +0 -0
  391. nat/registry_handlers/schemas/headers.py +42 -0
  392. nat/registry_handlers/schemas/package.py +68 -0
  393. nat/registry_handlers/schemas/publish.py +68 -0
  394. nat/registry_handlers/schemas/pull.py +82 -0
  395. nat/registry_handlers/schemas/remove.py +36 -0
  396. nat/registry_handlers/schemas/search.py +91 -0
  397. nat/registry_handlers/schemas/status.py +47 -0
  398. nat/retriever/__init__.py +0 -0
  399. nat/retriever/interface.py +41 -0
  400. nat/retriever/milvus/__init__.py +14 -0
  401. nat/retriever/milvus/register.py +81 -0
  402. nat/retriever/milvus/retriever.py +228 -0
  403. nat/retriever/models.py +77 -0
  404. nat/retriever/nemo_retriever/__init__.py +14 -0
  405. nat/retriever/nemo_retriever/register.py +60 -0
  406. nat/retriever/nemo_retriever/retriever.py +190 -0
  407. nat/retriever/register.py +21 -0
  408. nat/runtime/__init__.py +14 -0
  409. nat/runtime/loader.py +220 -0
  410. nat/runtime/runner.py +292 -0
  411. nat/runtime/session.py +223 -0
  412. nat/runtime/user_metadata.py +130 -0
  413. nat/settings/__init__.py +0 -0
  414. nat/settings/global_settings.py +329 -0
  415. nat/test/.namespace +1 -0
  416. nat/tool/__init__.py +0 -0
  417. nat/tool/chat_completion.py +77 -0
  418. nat/tool/code_execution/README.md +151 -0
  419. nat/tool/code_execution/__init__.py +0 -0
  420. nat/tool/code_execution/code_sandbox.py +267 -0
  421. nat/tool/code_execution/local_sandbox/.gitignore +1 -0
  422. nat/tool/code_execution/local_sandbox/Dockerfile.sandbox +60 -0
  423. nat/tool/code_execution/local_sandbox/__init__.py +13 -0
  424. nat/tool/code_execution/local_sandbox/local_sandbox_server.py +198 -0
  425. nat/tool/code_execution/local_sandbox/sandbox.requirements.txt +6 -0
  426. nat/tool/code_execution/local_sandbox/start_local_sandbox.sh +50 -0
  427. nat/tool/code_execution/register.py +74 -0
  428. nat/tool/code_execution/test_code_execution_sandbox.py +414 -0
  429. nat/tool/code_execution/utils.py +100 -0
  430. nat/tool/datetime_tools.py +82 -0
  431. nat/tool/document_search.py +141 -0
  432. nat/tool/github_tools.py +450 -0
  433. nat/tool/memory_tools/__init__.py +0 -0
  434. nat/tool/memory_tools/add_memory_tool.py +79 -0
  435. nat/tool/memory_tools/delete_memory_tool.py +66 -0
  436. nat/tool/memory_tools/get_memory_tool.py +72 -0
  437. nat/tool/nvidia_rag.py +95 -0
  438. nat/tool/register.py +31 -0
  439. nat/tool/retriever.py +95 -0
  440. nat/tool/server_tools.py +66 -0
  441. nat/utils/__init__.py +0 -0
  442. nat/utils/callable_utils.py +70 -0
  443. nat/utils/data_models/__init__.py +0 -0
  444. nat/utils/data_models/schema_validator.py +58 -0
  445. nat/utils/debugging_utils.py +43 -0
  446. nat/utils/decorators.py +210 -0
  447. nat/utils/dump_distro_mapping.py +32 -0
  448. nat/utils/exception_handlers/__init__.py +0 -0
  449. nat/utils/exception_handlers/automatic_retries.py +342 -0
  450. nat/utils/exception_handlers/schemas.py +114 -0
  451. nat/utils/io/__init__.py +0 -0
  452. nat/utils/io/model_processing.py +28 -0
  453. nat/utils/io/yaml_tools.py +119 -0
  454. nat/utils/log_levels.py +25 -0
  455. nat/utils/log_utils.py +37 -0
  456. nat/utils/metadata_utils.py +74 -0
  457. nat/utils/optional_imports.py +142 -0
  458. nat/utils/producer_consumer_queue.py +178 -0
  459. nat/utils/reactive/__init__.py +0 -0
  460. nat/utils/reactive/base/__init__.py +0 -0
  461. nat/utils/reactive/base/observable_base.py +65 -0
  462. nat/utils/reactive/base/observer_base.py +55 -0
  463. nat/utils/reactive/base/subject_base.py +79 -0
  464. nat/utils/reactive/observable.py +59 -0
  465. nat/utils/reactive/observer.py +76 -0
  466. nat/utils/reactive/subject.py +131 -0
  467. nat/utils/reactive/subscription.py +49 -0
  468. nat/utils/settings/__init__.py +0 -0
  469. nat/utils/settings/global_settings.py +195 -0
  470. nat/utils/string_utils.py +38 -0
  471. nat/utils/type_converter.py +299 -0
  472. nat/utils/type_utils.py +488 -0
  473. nat/utils/url_utils.py +27 -0
  474. nvidia_nat-1.1.0a20251020.dist-info/METADATA +195 -0
  475. nvidia_nat-1.1.0a20251020.dist-info/RECORD +480 -0
  476. nvidia_nat-1.1.0a20251020.dist-info/WHEEL +5 -0
  477. nvidia_nat-1.1.0a20251020.dist-info/entry_points.txt +22 -0
  478. nvidia_nat-1.1.0a20251020.dist-info/licenses/LICENSE-3rd-party.txt +5478 -0
  479. nvidia_nat-1.1.0a20251020.dist-info/licenses/LICENSE.md +201 -0
  480. nvidia_nat-1.1.0a20251020.dist-info/top_level.txt +2 -0
@@ -0,0 +1,290 @@
1
+ # SPDX-FileCopyrightText: Copyright (c) 2025, NVIDIA CORPORATION & AFFILIATES. All rights reserved.
2
+ # SPDX-License-Identifier: Apache-2.0
3
+ #
4
+ # Licensed under the Apache License, Version 2.0 (the "License");
5
+ # you may not use this file except in compliance with the License.
6
+ # You may obtain a copy of the License at
7
+ #
8
+ # http://www.apache.org/licenses/LICENSE-2.0
9
+ #
10
+ # Unless required by applicable law or agreed to in writing, software
11
+ # distributed under the License is distributed on an "AS IS" BASIS,
12
+ # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13
+ # See the License for the specific language governing permissions and
14
+ # limitations under the License.
15
+
16
+ import json
17
+ import logging
18
+ from inspect import Parameter
19
+ from inspect import Signature
20
+ from typing import TYPE_CHECKING
21
+
22
+ from mcp.server.fastmcp import FastMCP
23
+ from pydantic import BaseModel
24
+
25
+ from nat.builder.context import ContextState
26
+ from nat.builder.function import Function
27
+ from nat.builder.function_base import FunctionBase
28
+
29
+ if TYPE_CHECKING:
30
+ from nat.builder.workflow import Workflow
31
+ from nat.front_ends.mcp.memory_profiler import MemoryProfiler
32
+
33
+ logger = logging.getLogger(__name__)
34
+
35
+
36
+ def create_function_wrapper(
37
+ function_name: str,
38
+ function: FunctionBase,
39
+ schema: type[BaseModel],
40
+ is_workflow: bool = False,
41
+ workflow: 'Workflow | None' = None,
42
+ memory_profiler: 'MemoryProfiler | None' = None,
43
+ ):
44
+ """Create a wrapper function that exposes the actual parameters of a NAT Function as an MCP tool.
45
+
46
+ Args:
47
+ function_name (str): The name of the function/tool
48
+ function (FunctionBase): The NAT Function object
49
+ schema (type[BaseModel]): The input schema of the function
50
+ is_workflow (bool): Whether the function is a Workflow
51
+ workflow (Workflow | None): The parent workflow for observability context
52
+ memory_profiler: Optional memory profiler to track requests
53
+
54
+ Returns:
55
+ A wrapper function suitable for registration with MCP
56
+ """
57
+ # Check if we're dealing with ChatRequest - special case
58
+ is_chat_request = False
59
+
60
+ # Check if the schema name is ChatRequest
61
+ if schema.__name__ == "ChatRequest" or (hasattr(schema, "__qualname__") and "ChatRequest" in schema.__qualname__):
62
+ is_chat_request = True
63
+ logger.info("Function %s uses ChatRequest - creating simplified interface", function_name)
64
+
65
+ # For ChatRequest, we'll create a simple wrapper with just a query parameter
66
+ parameters = [Parameter(
67
+ name="query",
68
+ kind=Parameter.KEYWORD_ONLY,
69
+ default=Parameter.empty,
70
+ annotation=str,
71
+ )]
72
+ else:
73
+ # Regular case - extract parameter information from the input schema
74
+ # Extract parameter information from the input schema
75
+ param_fields = schema.model_fields
76
+
77
+ parameters = []
78
+ for name, field in param_fields.items():
79
+ # Get the field type and convert to appropriate Python type
80
+ field_type = field.annotation
81
+
82
+ # Add the parameter to our list
83
+ parameters.append(
84
+ Parameter(
85
+ name=name,
86
+ kind=Parameter.KEYWORD_ONLY,
87
+ default=Parameter.empty if field.is_required else None,
88
+ annotation=field_type,
89
+ ))
90
+
91
+ # Create the function signature WITHOUT the ctx parameter
92
+ # We'll handle this in the wrapper function internally
93
+ sig = Signature(parameters=parameters, return_annotation=str)
94
+
95
+ # Define the actual wrapper function that accepts ctx but doesn't expose it
96
+ def create_wrapper():
97
+
98
+ async def wrapper_with_ctx(**kwargs):
99
+ """Internal wrapper that will be called by MCP."""
100
+ # MCP will add a ctx parameter, extract it
101
+ ctx = kwargs.get("ctx")
102
+
103
+ # Remove ctx if present
104
+ if "ctx" in kwargs:
105
+ del kwargs["ctx"]
106
+
107
+ # Process the function call
108
+ if ctx:
109
+ ctx.info("Calling function %s with args: %s", function_name, json.dumps(kwargs, default=str))
110
+ await ctx.report_progress(0, 100)
111
+
112
+ try:
113
+ # Helper function to wrap function calls with observability
114
+ async def call_with_observability(func_call):
115
+ # Use workflow's observability context (workflow should always be available)
116
+ if not workflow:
117
+ logger.error("Missing workflow context for function %s - observability will not be available",
118
+ function_name)
119
+ raise RuntimeError("Workflow context is required for observability")
120
+
121
+ logger.debug("Starting observability context for function %s", function_name)
122
+ context_state = ContextState.get()
123
+ async with workflow.exporter_manager.start(context_state=context_state):
124
+ return await func_call()
125
+
126
+ # Special handling for ChatRequest
127
+ if is_chat_request:
128
+ from nat.data_models.api_server import ChatRequest
129
+
130
+ # Create a chat request from the query string
131
+ query = kwargs.get("query", "")
132
+ chat_request = ChatRequest.from_string(query)
133
+
134
+ # Special handling for Workflow objects
135
+ if is_workflow:
136
+ # Workflows have a run method that is an async context manager
137
+ # that returns a Runner
138
+ async with function.run(chat_request) as runner:
139
+ # Get the result from the runner
140
+ result = await runner.result(to_type=str)
141
+ else:
142
+ # Regular functions use ainvoke
143
+ result = await call_with_observability(lambda: function.ainvoke(chat_request, to_type=str))
144
+ else:
145
+ # Regular handling
146
+ # Handle complex input schema - if we extracted fields from a nested schema,
147
+ # we need to reconstruct the input
148
+ if len(schema.model_fields) == 1 and len(parameters) > 1:
149
+ # Get the field name from the original schema
150
+ field_name = next(iter(schema.model_fields.keys()))
151
+ field_type = schema.model_fields[field_name].annotation
152
+
153
+ # If it's a pydantic model, we need to create an instance
154
+ if field_type and hasattr(field_type, "model_validate"):
155
+ # Create the nested object
156
+ nested_obj = field_type.model_validate(kwargs)
157
+ # Call with the nested object
158
+ kwargs = {field_name: nested_obj}
159
+
160
+ # Call the NAT function with the parameters - special handling for Workflow
161
+ if is_workflow:
162
+ # For workflow with regular input, we'll assume the first parameter is the input
163
+ input_value = list(kwargs.values())[0] if kwargs else ""
164
+
165
+ # Workflows have a run method that is an async context manager
166
+ # that returns a Runner
167
+ async with function.run(input_value) as runner:
168
+ # Get the result from the runner
169
+ result = await runner.result(to_type=str)
170
+ else:
171
+ # Regular function call
172
+ result = await call_with_observability(lambda: function.acall_invoke(**kwargs))
173
+
174
+ # Report completion
175
+ if ctx:
176
+ await ctx.report_progress(100, 100)
177
+
178
+ # Track request completion for memory profiling
179
+ if memory_profiler:
180
+ memory_profiler.on_request_complete()
181
+
182
+ # Handle different result types for proper formatting
183
+ if isinstance(result, str):
184
+ return result
185
+ if isinstance(result, dict | list):
186
+ return json.dumps(result, default=str)
187
+ return str(result)
188
+ except Exception as e:
189
+ if ctx:
190
+ ctx.error("Error calling function %s: %s", function_name, str(e))
191
+
192
+ # Track request completion even on error
193
+ if memory_profiler:
194
+ memory_profiler.on_request_complete()
195
+
196
+ raise
197
+
198
+ return wrapper_with_ctx
199
+
200
+ # Create the wrapper function
201
+ wrapper = create_wrapper()
202
+
203
+ # Set the signature on the wrapper function (WITHOUT ctx)
204
+ wrapper.__signature__ = sig # type: ignore
205
+ wrapper.__name__ = function_name
206
+
207
+ # Return the wrapper with proper signature
208
+ return wrapper
209
+
210
+
211
+ def get_function_description(function: FunctionBase) -> str:
212
+ """
213
+ Retrieve a human-readable description for a NAT function or workflow.
214
+
215
+ The description is determined using the following precedence:
216
+ 1. If the function is a Workflow and has a 'description' attribute, use it.
217
+ 2. If the Workflow's config has a 'description', use it.
218
+ 3. If the Workflow's config has a 'topic', use it.
219
+ 4. If the function is a regular Function, use its 'description' attribute.
220
+
221
+ Args:
222
+ function: The NAT FunctionBase instance (Function or Workflow).
223
+
224
+ Returns:
225
+ The best available description string for the function.
226
+ """
227
+ function_description = ""
228
+
229
+ # Import here to avoid circular imports
230
+ from nat.builder.workflow import Workflow
231
+
232
+ if isinstance(function, Workflow):
233
+ config = function.config
234
+
235
+ # Workflow doesn't have a description, but probably should
236
+ if hasattr(function, "description") and function.description:
237
+ function_description = function.description
238
+ # Try to get description from config
239
+ elif hasattr(config, "description") and config.description:
240
+ function_description = config.description
241
+ # Try to get anything that might be a description
242
+ elif hasattr(config, "topic") and config.topic:
243
+ function_description = config.topic
244
+ # Try to get description from the workflow config
245
+ elif hasattr(config, "workflow") and hasattr(config.workflow, "description") and config.workflow.description:
246
+ function_description = config.workflow.description
247
+
248
+ elif isinstance(function, Function):
249
+ function_description = function.description
250
+
251
+ return function_description
252
+
253
+
254
+ def register_function_with_mcp(mcp: FastMCP,
255
+ function_name: str,
256
+ function: FunctionBase,
257
+ workflow: 'Workflow | None' = None,
258
+ memory_profiler: 'MemoryProfiler | None' = None) -> None:
259
+ """Register a NAT Function as an MCP tool.
260
+
261
+ Args:
262
+ mcp: The FastMCP instance
263
+ function_name: The name to register the function under
264
+ function: The NAT Function to register
265
+ workflow: The parent workflow for observability context (if available)
266
+ memory_profiler: Optional memory profiler to track requests
267
+ """
268
+ logger.info("Registering function %s with MCP", function_name)
269
+
270
+ # Get the input schema from the function
271
+ input_schema = function.input_schema
272
+ logger.info("Function %s has input schema: %s", function_name, input_schema)
273
+
274
+ # Check if we're dealing with a Workflow
275
+ from nat.builder.workflow import Workflow
276
+ is_workflow = isinstance(function, Workflow)
277
+ if is_workflow:
278
+ logger.info("Function %s is a Workflow", function_name)
279
+
280
+ # Get function description
281
+ function_description = get_function_description(function)
282
+
283
+ # Create and register the wrapper function with MCP
284
+ wrapper_func = create_function_wrapper(function_name,
285
+ function,
286
+ input_schema,
287
+ is_workflow,
288
+ workflow,
289
+ memory_profiler)
290
+ mcp.tool(name=function_name, description=function_description)(wrapper_func)
@@ -0,0 +1,21 @@
1
+ # SPDX-FileCopyrightText: Copyright (c) 2025, NVIDIA CORPORATION & AFFILIATES. All rights reserved.
2
+ # SPDX-License-Identifier: Apache-2.0
3
+ #
4
+ # Licensed under the Apache License, Version 2.0 (the "License");
5
+ # you may not use this file except in compliance with the License.
6
+ # You may obtain a copy of the License at
7
+ #
8
+ # http://www.apache.org/licenses/LICENSE-2.0
9
+ #
10
+ # Unless required by applicable law or agreed to in writing, software
11
+ # distributed under the License is distributed on an "AS IS" BASIS,
12
+ # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13
+ # See the License for the specific language governing permissions and
14
+ # limitations under the License.
15
+
16
+ # flake8: noqa
17
+ # isort:skip_file
18
+
19
+ from .console import register as console_register
20
+ from .fastapi import register as fastapi_register
21
+ from .mcp import register as mcp_register
@@ -0,0 +1,14 @@
1
+ # SPDX-FileCopyrightText: Copyright (c) 2024-2025, NVIDIA CORPORATION & AFFILIATES. All rights reserved.
2
+ # SPDX-License-Identifier: Apache-2.0
3
+ #
4
+ # Licensed under the Apache License, Version 2.0 (the "License");
5
+ # you may not use this file except in compliance with the License.
6
+ # You may obtain a copy of the License at
7
+ #
8
+ # http://www.apache.org/licenses/LICENSE-2.0
9
+ #
10
+ # Unless required by applicable law or agreed to in writing, software
11
+ # distributed under the License is distributed on an "AS IS" BASIS,
12
+ # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13
+ # See the License for the specific language governing permissions and
14
+ # limitations under the License.
@@ -0,0 +1,56 @@
1
+ # SPDX-FileCopyrightText: Copyright (c) 2025, NVIDIA CORPORATION & AFFILIATES. All rights reserved.
2
+ # SPDX-License-Identifier: Apache-2.0
3
+ #
4
+ # Licensed under the Apache License, Version 2.0 (the "License");
5
+ # you may not use this file except in compliance with the License.
6
+ # You may obtain a copy of the License at
7
+ #
8
+ # http://www.apache.org/licenses/LICENSE-2.0
9
+ #
10
+ # Unless required by applicable law or agreed to in writing, software
11
+ # distributed under the License is distributed on an "AS IS" BASIS,
12
+ # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13
+ # See the License for the specific language governing permissions and
14
+ # limitations under the License.
15
+
16
+ import logging
17
+ from abc import ABC
18
+ from abc import abstractmethod
19
+ from io import StringIO
20
+
21
+ import click
22
+
23
+ from nat.builder.front_end import FrontEndBase
24
+ from nat.builder.workflow_builder import WorkflowBuilder
25
+ from nat.data_models.front_end import FrontEndConfigT
26
+ from nat.runtime.session import SessionManager
27
+
28
+ logger = logging.getLogger(__name__)
29
+
30
+
31
+ class SimpleFrontEndPluginBase(FrontEndBase[FrontEndConfigT], ABC):
32
+
33
+ async def pre_run(self):
34
+ pass
35
+
36
+ async def run(self):
37
+
38
+ await self.pre_run()
39
+
40
+ # Must yield the workflow function otherwise it cleans up
41
+ async with WorkflowBuilder.from_config(config=self.full_config) as builder:
42
+
43
+ if logger.isEnabledFor(logging.INFO):
44
+ stream = StringIO()
45
+
46
+ self.full_config.print_summary(stream=stream)
47
+
48
+ click.echo(stream.getvalue())
49
+
50
+ workflow = await builder.build()
51
+ session_manager = SessionManager(workflow)
52
+ await self.run_workflow(session_manager)
53
+
54
+ @abstractmethod
55
+ async def run_workflow(self, session_manager: SessionManager):
56
+ pass
nat/llm/__init__.py ADDED
File without changes
@@ -0,0 +1,69 @@
1
+ # SPDX-FileCopyrightText: Copyright (c) 2024-2025, NVIDIA CORPORATION & AFFILIATES. All rights reserved.
2
+ # SPDX-License-Identifier: Apache-2.0
3
+ #
4
+ # Licensed under the Apache License, Version 2.0 (the "License");
5
+ # you may not use this file except in compliance with the License.
6
+ # You may obtain a copy of the License at
7
+ #
8
+ # http://www.apache.org/licenses/LICENSE-2.0
9
+ #
10
+ # Unless required by applicable law or agreed to in writing, software
11
+ # distributed under the License is distributed on an "AS IS" BASIS,
12
+ # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13
+ # See the License for the specific language governing permissions and
14
+ # limitations under the License.
15
+
16
+ from pydantic import AliasChoices
17
+ from pydantic import ConfigDict
18
+ from pydantic import Field
19
+
20
+ from nat.builder.builder import Builder
21
+ from nat.builder.llm import LLMProviderInfo
22
+ from nat.cli.register_workflow import register_llm_provider
23
+ from nat.data_models.llm import LLMBaseConfig
24
+ from nat.data_models.optimizable import OptimizableField
25
+ from nat.data_models.optimizable import OptimizableMixin
26
+ from nat.data_models.optimizable import SearchSpace
27
+ from nat.data_models.retry_mixin import RetryMixin
28
+ from nat.data_models.temperature_mixin import TemperatureMixin
29
+ from nat.data_models.thinking_mixin import ThinkingMixin
30
+ from nat.data_models.top_p_mixin import TopPMixin
31
+
32
+
33
+ class AWSBedrockModelConfig(LLMBaseConfig,
34
+ RetryMixin,
35
+ OptimizableMixin,
36
+ TemperatureMixin,
37
+ TopPMixin,
38
+ ThinkingMixin,
39
+ name="aws_bedrock"):
40
+ """An AWS Bedrock llm provider to be used with an LLM client."""
41
+
42
+ model_config = ConfigDict(protected_namespaces=(), extra="allow")
43
+
44
+ # Completion parameters
45
+ model_name: str = Field(validation_alias=AliasChoices("model_name", "model"),
46
+ serialization_alias="model",
47
+ description="The model name for the hosted AWS Bedrock.")
48
+ max_tokens: int = OptimizableField(default=300,
49
+ description="Maximum number of tokens to generate.",
50
+ space=SearchSpace(high=2176, low=128, step=512))
51
+ context_size: int | None = Field(
52
+ default=1024,
53
+ gt=0,
54
+ description="The maximum number of tokens available for input. This is only required for LlamaIndex. "
55
+ "This field is ignored for LangChain/LangGraph.",
56
+ )
57
+
58
+ # Client parameters
59
+ region_name: str | None = Field(default="None", description="AWS region to use.")
60
+ base_url: str | None = Field(
61
+ default=None, description="Bedrock endpoint to use. Needed if you don't want to default to us-east-1 endpoint.")
62
+ credentials_profile_name: str | None = Field(
63
+ default=None, description="The name of the profile in the ~/.aws/credentials or ~/.aws/config files.")
64
+
65
+
66
+ @register_llm_provider(config_type=AWSBedrockModelConfig)
67
+ async def aws_bedrock_model(llm_config: AWSBedrockModelConfig, _builder: Builder):
68
+
69
+ yield LLMProviderInfo(config=llm_config, description="A AWS Bedrock model for use with an LLM client.")
@@ -0,0 +1,57 @@
1
+ # SPDX-FileCopyrightText: Copyright (c) 2025, NVIDIA CORPORATION & AFFILIATES. All rights reserved.
2
+ # SPDX-License-Identifier: Apache-2.0
3
+ #
4
+ # Licensed under the Apache License, Version 2.0 (the "License");
5
+ # you may not use this file except in compliance with the License.
6
+ # You may obtain a copy of the License at
7
+ #
8
+ # http://www.apache.org/licenses/LICENSE-2.0
9
+ #
10
+ # Unless required by applicable law or agreed to in writing, software
11
+ # distributed under the License is distributed on an "AS IS" BASIS,
12
+ # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13
+ # See the License for the specific language governing permissions and
14
+ # limitations under the License.
15
+
16
+ from pydantic import AliasChoices
17
+ from pydantic import ConfigDict
18
+ from pydantic import Field
19
+
20
+ from nat.builder.builder import Builder
21
+ from nat.builder.llm import LLMProviderInfo
22
+ from nat.cli.register_workflow import register_llm_provider
23
+ from nat.data_models.llm import LLMBaseConfig
24
+ from nat.data_models.retry_mixin import RetryMixin
25
+ from nat.data_models.temperature_mixin import TemperatureMixin
26
+ from nat.data_models.thinking_mixin import ThinkingMixin
27
+ from nat.data_models.top_p_mixin import TopPMixin
28
+
29
+
30
+ class AzureOpenAIModelConfig(
31
+ LLMBaseConfig,
32
+ RetryMixin,
33
+ TemperatureMixin,
34
+ TopPMixin,
35
+ ThinkingMixin,
36
+ name="azure_openai",
37
+ ):
38
+ """An Azure OpenAI LLM provider to be used with an LLM client."""
39
+
40
+ model_config = ConfigDict(protected_namespaces=(), extra="allow")
41
+
42
+ api_key: str | None = Field(default=None, description="Azure OpenAI API key to interact with hosted model.")
43
+ api_version: str = Field(default="2025-04-01-preview", description="Azure OpenAI API version.")
44
+ azure_endpoint: str | None = Field(validation_alias=AliasChoices("azure_endpoint", "base_url"),
45
+ serialization_alias="azure_endpoint",
46
+ default=None,
47
+ description="Base URL for the hosted model.")
48
+ azure_deployment: str = Field(validation_alias=AliasChoices("azure_deployment", "model_name", "model"),
49
+ serialization_alias="azure_deployment",
50
+ description="The Azure OpenAI hosted model/deployment name.")
51
+ seed: int | None = Field(default=None, description="Random seed to set for generation.")
52
+
53
+
54
+ @register_llm_provider(config_type=AzureOpenAIModelConfig)
55
+ async def azure_openai_llm(config: AzureOpenAIModelConfig, _builder: Builder):
56
+
57
+ yield LLMProviderInfo(config=config, description="An Azure OpenAI model for use with an LLM client.")
nat/llm/litellm_llm.py ADDED
@@ -0,0 +1,69 @@
1
+ # SPDX-FileCopyrightText: Copyright (c) 2025, NVIDIA CORPORATION & AFFILIATES. All rights reserved.
2
+ # SPDX-License-Identifier: Apache-2.0
3
+ #
4
+ # Licensed under the Apache License, Version 2.0 (the "License");
5
+ # you may not use this file except in compliance with the License.
6
+ # You may obtain a copy of the License at
7
+ #
8
+ # http://www.apache.org/licenses/LICENSE-2.0
9
+ #
10
+ # Unless required by applicable law or agreed to in writing, software
11
+ # distributed under the License is distributed on an "AS IS" BASIS,
12
+ # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13
+ # See the License for the specific language governing permissions and
14
+ # limitations under the License.
15
+
16
+ from collections.abc import AsyncIterator
17
+
18
+ from pydantic import AliasChoices
19
+ from pydantic import ConfigDict
20
+ from pydantic import Field
21
+
22
+ from nat.builder.builder import Builder
23
+ from nat.builder.llm import LLMProviderInfo
24
+ from nat.cli.register_workflow import register_llm_provider
25
+ from nat.data_models.llm import LLMBaseConfig
26
+ from nat.data_models.retry_mixin import RetryMixin
27
+ from nat.data_models.temperature_mixin import TemperatureMixin
28
+ from nat.data_models.thinking_mixin import ThinkingMixin
29
+ from nat.data_models.top_p_mixin import TopPMixin
30
+
31
+
32
+ class LiteLlmModelConfig(
33
+ LLMBaseConfig,
34
+ RetryMixin,
35
+ TemperatureMixin,
36
+ TopPMixin,
37
+ ThinkingMixin,
38
+ name="litellm",
39
+ ):
40
+ """A LiteLlm provider to be used with an LLM client."""
41
+
42
+ model_config = ConfigDict(protected_namespaces=(), extra="allow")
43
+
44
+ api_key: str | None = Field(default=None, description="API key to interact with hosted model.")
45
+ base_url: str | None = Field(default=None,
46
+ description="Base url to the hosted model.",
47
+ validation_alias=AliasChoices("base_url", "api_base"),
48
+ serialization_alias="api_base")
49
+ model_name: str = Field(validation_alias=AliasChoices("model_name", "model"),
50
+ serialization_alias="model",
51
+ description="The LiteLlm hosted model name.")
52
+ seed: int | None = Field(default=None, description="Random seed to set for generation.")
53
+
54
+
55
+ @register_llm_provider(config_type=LiteLlmModelConfig)
56
+ async def litellm_model(
57
+ config: LiteLlmModelConfig,
58
+ _builder: Builder,
59
+ ) -> AsyncIterator[LLMProviderInfo]:
60
+ """Litellm model provider.
61
+
62
+ Args:
63
+ config (LiteLlmModelConfig): The LiteLlm model configuration.
64
+ _builder (Builder): The NAT builder instance.
65
+
66
+ Returns:
67
+ AsyncIterator[LLMProviderInfo]: An async iterator that yields an LLMProviderInfo object.
68
+ """
69
+ yield LLMProviderInfo(config=config, description="A LiteLlm model for use with an LLM client.")
nat/llm/nim_llm.py ADDED
@@ -0,0 +1,58 @@
1
+ # SPDX-FileCopyrightText: Copyright (c) 2024-2025, NVIDIA CORPORATION & AFFILIATES. All rights reserved.
2
+ # SPDX-License-Identifier: Apache-2.0
3
+ #
4
+ # Licensed under the Apache License, Version 2.0 (the "License");
5
+ # you may not use this file except in compliance with the License.
6
+ # You may obtain a copy of the License at
7
+ #
8
+ # http://www.apache.org/licenses/LICENSE-2.0
9
+ #
10
+ # Unless required by applicable law or agreed to in writing, software
11
+ # distributed under the License is distributed on an "AS IS" BASIS,
12
+ # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13
+ # See the License for the specific language governing permissions and
14
+ # limitations under the License.
15
+
16
+ from pydantic import AliasChoices
17
+ from pydantic import ConfigDict
18
+ from pydantic import Field
19
+ from pydantic import PositiveInt
20
+
21
+ from nat.builder.builder import Builder
22
+ from nat.builder.llm import LLMProviderInfo
23
+ from nat.cli.register_workflow import register_llm_provider
24
+ from nat.data_models.llm import LLMBaseConfig
25
+ from nat.data_models.optimizable import OptimizableField
26
+ from nat.data_models.optimizable import OptimizableMixin
27
+ from nat.data_models.optimizable import SearchSpace
28
+ from nat.data_models.retry_mixin import RetryMixin
29
+ from nat.data_models.temperature_mixin import TemperatureMixin
30
+ from nat.data_models.thinking_mixin import ThinkingMixin
31
+ from nat.data_models.top_p_mixin import TopPMixin
32
+
33
+
34
+ class NIMModelConfig(LLMBaseConfig,
35
+ RetryMixin,
36
+ OptimizableMixin,
37
+ TemperatureMixin,
38
+ TopPMixin,
39
+ ThinkingMixin,
40
+ name="nim"):
41
+ """An NVIDIA Inference Microservice (NIM) llm provider to be used with an LLM client."""
42
+
43
+ model_config = ConfigDict(protected_namespaces=(), extra="allow")
44
+
45
+ api_key: str | None = Field(default=None, description="NVIDIA API key to interact with hosted NIM.")
46
+ base_url: str | None = Field(default=None, description="Base url to the hosted NIM.")
47
+ model_name: str = Field(validation_alias=AliasChoices("model_name", "model"),
48
+ serialization_alias="model",
49
+ description="The model name for the hosted NIM.")
50
+ max_tokens: PositiveInt = OptimizableField(default=300,
51
+ description="Maximum number of tokens to generate.",
52
+ space=SearchSpace(high=2176, low=128, step=512))
53
+
54
+
55
+ @register_llm_provider(config_type=NIMModelConfig)
56
+ async def nim_model(llm_config: NIMModelConfig, _builder: Builder):
57
+
58
+ yield LLMProviderInfo(config=llm_config, description="A NIM model for use with an LLM client.")