nvidia-nat 1.2.0__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 (435) hide show
  1. aiq/__init__.py +66 -0
  2. nat/agent/__init__.py +0 -0
  3. nat/agent/base.py +256 -0
  4. nat/agent/dual_node.py +67 -0
  5. nat/agent/react_agent/__init__.py +0 -0
  6. nat/agent/react_agent/agent.py +363 -0
  7. nat/agent/react_agent/output_parser.py +104 -0
  8. nat/agent/react_agent/prompt.py +44 -0
  9. nat/agent/react_agent/register.py +149 -0
  10. nat/agent/reasoning_agent/__init__.py +0 -0
  11. nat/agent/reasoning_agent/reasoning_agent.py +225 -0
  12. nat/agent/register.py +23 -0
  13. nat/agent/rewoo_agent/__init__.py +0 -0
  14. nat/agent/rewoo_agent/agent.py +415 -0
  15. nat/agent/rewoo_agent/prompt.py +110 -0
  16. nat/agent/rewoo_agent/register.py +157 -0
  17. nat/agent/tool_calling_agent/__init__.py +0 -0
  18. nat/agent/tool_calling_agent/agent.py +119 -0
  19. nat/agent/tool_calling_agent/register.py +106 -0
  20. nat/authentication/__init__.py +14 -0
  21. nat/authentication/api_key/__init__.py +14 -0
  22. nat/authentication/api_key/api_key_auth_provider.py +96 -0
  23. nat/authentication/api_key/api_key_auth_provider_config.py +124 -0
  24. nat/authentication/api_key/register.py +26 -0
  25. nat/authentication/exceptions/__init__.py +14 -0
  26. nat/authentication/exceptions/api_key_exceptions.py +38 -0
  27. nat/authentication/http_basic_auth/__init__.py +0 -0
  28. nat/authentication/http_basic_auth/http_basic_auth_provider.py +81 -0
  29. nat/authentication/http_basic_auth/register.py +30 -0
  30. nat/authentication/interfaces.py +93 -0
  31. nat/authentication/oauth2/__init__.py +14 -0
  32. nat/authentication/oauth2/oauth2_auth_code_flow_provider.py +107 -0
  33. nat/authentication/oauth2/oauth2_auth_code_flow_provider_config.py +39 -0
  34. nat/authentication/oauth2/register.py +25 -0
  35. nat/authentication/register.py +21 -0
  36. nat/builder/__init__.py +0 -0
  37. nat/builder/builder.py +285 -0
  38. nat/builder/component_utils.py +316 -0
  39. nat/builder/context.py +270 -0
  40. nat/builder/embedder.py +24 -0
  41. nat/builder/eval_builder.py +161 -0
  42. nat/builder/evaluator.py +29 -0
  43. nat/builder/framework_enum.py +24 -0
  44. nat/builder/front_end.py +73 -0
  45. nat/builder/function.py +344 -0
  46. nat/builder/function_base.py +380 -0
  47. nat/builder/function_info.py +627 -0
  48. nat/builder/intermediate_step_manager.py +174 -0
  49. nat/builder/llm.py +25 -0
  50. nat/builder/retriever.py +25 -0
  51. nat/builder/user_interaction_manager.py +78 -0
  52. nat/builder/workflow.py +148 -0
  53. nat/builder/workflow_builder.py +1117 -0
  54. nat/cli/__init__.py +14 -0
  55. nat/cli/cli_utils/__init__.py +0 -0
  56. nat/cli/cli_utils/config_override.py +231 -0
  57. nat/cli/cli_utils/validation.py +37 -0
  58. nat/cli/commands/__init__.py +0 -0
  59. nat/cli/commands/configure/__init__.py +0 -0
  60. nat/cli/commands/configure/channel/__init__.py +0 -0
  61. nat/cli/commands/configure/channel/add.py +28 -0
  62. nat/cli/commands/configure/channel/channel.py +34 -0
  63. nat/cli/commands/configure/channel/remove.py +30 -0
  64. nat/cli/commands/configure/channel/update.py +30 -0
  65. nat/cli/commands/configure/configure.py +33 -0
  66. nat/cli/commands/evaluate.py +139 -0
  67. nat/cli/commands/info/__init__.py +14 -0
  68. nat/cli/commands/info/info.py +37 -0
  69. nat/cli/commands/info/list_channels.py +32 -0
  70. nat/cli/commands/info/list_components.py +129 -0
  71. nat/cli/commands/info/list_mcp.py +304 -0
  72. nat/cli/commands/registry/__init__.py +14 -0
  73. nat/cli/commands/registry/publish.py +88 -0
  74. nat/cli/commands/registry/pull.py +118 -0
  75. nat/cli/commands/registry/registry.py +36 -0
  76. nat/cli/commands/registry/remove.py +108 -0
  77. nat/cli/commands/registry/search.py +155 -0
  78. nat/cli/commands/sizing/__init__.py +14 -0
  79. nat/cli/commands/sizing/calc.py +297 -0
  80. nat/cli/commands/sizing/sizing.py +27 -0
  81. nat/cli/commands/start.py +246 -0
  82. nat/cli/commands/uninstall.py +81 -0
  83. nat/cli/commands/validate.py +47 -0
  84. nat/cli/commands/workflow/__init__.py +14 -0
  85. nat/cli/commands/workflow/templates/__init__.py.j2 +0 -0
  86. nat/cli/commands/workflow/templates/config.yml.j2 +16 -0
  87. nat/cli/commands/workflow/templates/pyproject.toml.j2 +22 -0
  88. nat/cli/commands/workflow/templates/register.py.j2 +5 -0
  89. nat/cli/commands/workflow/templates/workflow.py.j2 +36 -0
  90. nat/cli/commands/workflow/workflow.py +37 -0
  91. nat/cli/commands/workflow/workflow_commands.py +317 -0
  92. nat/cli/entrypoint.py +135 -0
  93. nat/cli/main.py +57 -0
  94. nat/cli/register_workflow.py +488 -0
  95. nat/cli/type_registry.py +1000 -0
  96. nat/data_models/__init__.py +14 -0
  97. nat/data_models/api_server.py +716 -0
  98. nat/data_models/authentication.py +231 -0
  99. nat/data_models/common.py +171 -0
  100. nat/data_models/component.py +58 -0
  101. nat/data_models/component_ref.py +168 -0
  102. nat/data_models/config.py +410 -0
  103. nat/data_models/dataset_handler.py +169 -0
  104. nat/data_models/discovery_metadata.py +305 -0
  105. nat/data_models/embedder.py +27 -0
  106. nat/data_models/evaluate.py +127 -0
  107. nat/data_models/evaluator.py +26 -0
  108. nat/data_models/front_end.py +26 -0
  109. nat/data_models/function.py +30 -0
  110. nat/data_models/function_dependencies.py +72 -0
  111. nat/data_models/interactive.py +246 -0
  112. nat/data_models/intermediate_step.py +302 -0
  113. nat/data_models/invocation_node.py +38 -0
  114. nat/data_models/llm.py +27 -0
  115. nat/data_models/logging.py +26 -0
  116. nat/data_models/memory.py +27 -0
  117. nat/data_models/object_store.py +44 -0
  118. nat/data_models/profiler.py +54 -0
  119. nat/data_models/registry_handler.py +26 -0
  120. nat/data_models/retriever.py +30 -0
  121. nat/data_models/retry_mixin.py +35 -0
  122. nat/data_models/span.py +190 -0
  123. nat/data_models/step_adaptor.py +64 -0
  124. nat/data_models/streaming.py +33 -0
  125. nat/data_models/swe_bench_model.py +54 -0
  126. nat/data_models/telemetry_exporter.py +26 -0
  127. nat/data_models/ttc_strategy.py +30 -0
  128. nat/embedder/__init__.py +0 -0
  129. nat/embedder/nim_embedder.py +59 -0
  130. nat/embedder/openai_embedder.py +43 -0
  131. nat/embedder/register.py +22 -0
  132. nat/eval/__init__.py +14 -0
  133. nat/eval/config.py +60 -0
  134. nat/eval/dataset_handler/__init__.py +0 -0
  135. nat/eval/dataset_handler/dataset_downloader.py +106 -0
  136. nat/eval/dataset_handler/dataset_filter.py +52 -0
  137. nat/eval/dataset_handler/dataset_handler.py +367 -0
  138. nat/eval/evaluate.py +510 -0
  139. nat/eval/evaluator/__init__.py +14 -0
  140. nat/eval/evaluator/base_evaluator.py +77 -0
  141. nat/eval/evaluator/evaluator_model.py +45 -0
  142. nat/eval/intermediate_step_adapter.py +99 -0
  143. nat/eval/rag_evaluator/__init__.py +0 -0
  144. nat/eval/rag_evaluator/evaluate.py +178 -0
  145. nat/eval/rag_evaluator/register.py +143 -0
  146. nat/eval/register.py +23 -0
  147. nat/eval/remote_workflow.py +133 -0
  148. nat/eval/runners/__init__.py +14 -0
  149. nat/eval/runners/config.py +39 -0
  150. nat/eval/runners/multi_eval_runner.py +54 -0
  151. nat/eval/runtime_event_subscriber.py +52 -0
  152. nat/eval/swe_bench_evaluator/__init__.py +0 -0
  153. nat/eval/swe_bench_evaluator/evaluate.py +215 -0
  154. nat/eval/swe_bench_evaluator/register.py +36 -0
  155. nat/eval/trajectory_evaluator/__init__.py +0 -0
  156. nat/eval/trajectory_evaluator/evaluate.py +75 -0
  157. nat/eval/trajectory_evaluator/register.py +40 -0
  158. nat/eval/tunable_rag_evaluator/__init__.py +0 -0
  159. nat/eval/tunable_rag_evaluator/evaluate.py +245 -0
  160. nat/eval/tunable_rag_evaluator/register.py +52 -0
  161. nat/eval/usage_stats.py +41 -0
  162. nat/eval/utils/__init__.py +0 -0
  163. nat/eval/utils/output_uploader.py +140 -0
  164. nat/eval/utils/tqdm_position_registry.py +40 -0
  165. nat/eval/utils/weave_eval.py +184 -0
  166. nat/experimental/__init__.py +0 -0
  167. nat/experimental/decorators/__init__.py +0 -0
  168. nat/experimental/decorators/experimental_warning_decorator.py +134 -0
  169. nat/experimental/test_time_compute/__init__.py +0 -0
  170. nat/experimental/test_time_compute/editing/__init__.py +0 -0
  171. nat/experimental/test_time_compute/editing/iterative_plan_refinement_editor.py +147 -0
  172. nat/experimental/test_time_compute/editing/llm_as_a_judge_editor.py +204 -0
  173. nat/experimental/test_time_compute/editing/motivation_aware_summarization.py +107 -0
  174. nat/experimental/test_time_compute/functions/__init__.py +0 -0
  175. nat/experimental/test_time_compute/functions/execute_score_select_function.py +105 -0
  176. nat/experimental/test_time_compute/functions/plan_select_execute_function.py +224 -0
  177. nat/experimental/test_time_compute/functions/ttc_tool_orchestration_function.py +205 -0
  178. nat/experimental/test_time_compute/functions/ttc_tool_wrapper_function.py +146 -0
  179. nat/experimental/test_time_compute/models/__init__.py +0 -0
  180. nat/experimental/test_time_compute/models/editor_config.py +132 -0
  181. nat/experimental/test_time_compute/models/scoring_config.py +112 -0
  182. nat/experimental/test_time_compute/models/search_config.py +120 -0
  183. nat/experimental/test_time_compute/models/selection_config.py +154 -0
  184. nat/experimental/test_time_compute/models/stage_enums.py +43 -0
  185. nat/experimental/test_time_compute/models/strategy_base.py +66 -0
  186. nat/experimental/test_time_compute/models/tool_use_config.py +41 -0
  187. nat/experimental/test_time_compute/models/ttc_item.py +48 -0
  188. nat/experimental/test_time_compute/register.py +36 -0
  189. nat/experimental/test_time_compute/scoring/__init__.py +0 -0
  190. nat/experimental/test_time_compute/scoring/llm_based_agent_scorer.py +168 -0
  191. nat/experimental/test_time_compute/scoring/llm_based_plan_scorer.py +168 -0
  192. nat/experimental/test_time_compute/scoring/motivation_aware_scorer.py +111 -0
  193. nat/experimental/test_time_compute/search/__init__.py +0 -0
  194. nat/experimental/test_time_compute/search/multi_llm_planner.py +128 -0
  195. nat/experimental/test_time_compute/search/multi_query_retrieval_search.py +122 -0
  196. nat/experimental/test_time_compute/search/single_shot_multi_plan_planner.py +128 -0
  197. nat/experimental/test_time_compute/selection/__init__.py +0 -0
  198. nat/experimental/test_time_compute/selection/best_of_n_selector.py +63 -0
  199. nat/experimental/test_time_compute/selection/llm_based_agent_output_selector.py +131 -0
  200. nat/experimental/test_time_compute/selection/llm_based_output_merging_selector.py +159 -0
  201. nat/experimental/test_time_compute/selection/llm_based_plan_selector.py +128 -0
  202. nat/experimental/test_time_compute/selection/threshold_selector.py +58 -0
  203. nat/front_ends/__init__.py +14 -0
  204. nat/front_ends/console/__init__.py +14 -0
  205. nat/front_ends/console/authentication_flow_handler.py +233 -0
  206. nat/front_ends/console/console_front_end_config.py +32 -0
  207. nat/front_ends/console/console_front_end_plugin.py +96 -0
  208. nat/front_ends/console/register.py +25 -0
  209. nat/front_ends/cron/__init__.py +14 -0
  210. nat/front_ends/fastapi/__init__.py +14 -0
  211. nat/front_ends/fastapi/auth_flow_handlers/__init__.py +0 -0
  212. nat/front_ends/fastapi/auth_flow_handlers/http_flow_handler.py +27 -0
  213. nat/front_ends/fastapi/auth_flow_handlers/websocket_flow_handler.py +107 -0
  214. nat/front_ends/fastapi/fastapi_front_end_config.py +241 -0
  215. nat/front_ends/fastapi/fastapi_front_end_controller.py +68 -0
  216. nat/front_ends/fastapi/fastapi_front_end_plugin.py +116 -0
  217. nat/front_ends/fastapi/fastapi_front_end_plugin_worker.py +1087 -0
  218. nat/front_ends/fastapi/html_snippets/__init__.py +14 -0
  219. nat/front_ends/fastapi/html_snippets/auth_code_grant_success.py +35 -0
  220. nat/front_ends/fastapi/intermediate_steps_subscriber.py +80 -0
  221. nat/front_ends/fastapi/job_store.py +183 -0
  222. nat/front_ends/fastapi/main.py +72 -0
  223. nat/front_ends/fastapi/message_handler.py +320 -0
  224. nat/front_ends/fastapi/message_validator.py +352 -0
  225. nat/front_ends/fastapi/register.py +25 -0
  226. nat/front_ends/fastapi/response_helpers.py +195 -0
  227. nat/front_ends/fastapi/step_adaptor.py +319 -0
  228. nat/front_ends/mcp/__init__.py +14 -0
  229. nat/front_ends/mcp/mcp_front_end_config.py +36 -0
  230. nat/front_ends/mcp/mcp_front_end_plugin.py +81 -0
  231. nat/front_ends/mcp/mcp_front_end_plugin_worker.py +143 -0
  232. nat/front_ends/mcp/register.py +27 -0
  233. nat/front_ends/mcp/tool_converter.py +241 -0
  234. nat/front_ends/register.py +22 -0
  235. nat/front_ends/simple_base/__init__.py +14 -0
  236. nat/front_ends/simple_base/simple_front_end_plugin_base.py +54 -0
  237. nat/llm/__init__.py +0 -0
  238. nat/llm/aws_bedrock_llm.py +57 -0
  239. nat/llm/nim_llm.py +46 -0
  240. nat/llm/openai_llm.py +46 -0
  241. nat/llm/register.py +23 -0
  242. nat/llm/utils/__init__.py +14 -0
  243. nat/llm/utils/env_config_value.py +94 -0
  244. nat/llm/utils/error.py +17 -0
  245. nat/memory/__init__.py +20 -0
  246. nat/memory/interfaces.py +183 -0
  247. nat/memory/models.py +112 -0
  248. nat/meta/pypi.md +58 -0
  249. nat/object_store/__init__.py +20 -0
  250. nat/object_store/in_memory_object_store.py +76 -0
  251. nat/object_store/interfaces.py +84 -0
  252. nat/object_store/models.py +38 -0
  253. nat/object_store/register.py +20 -0
  254. nat/observability/__init__.py +14 -0
  255. nat/observability/exporter/__init__.py +14 -0
  256. nat/observability/exporter/base_exporter.py +449 -0
  257. nat/observability/exporter/exporter.py +78 -0
  258. nat/observability/exporter/file_exporter.py +33 -0
  259. nat/observability/exporter/processing_exporter.py +322 -0
  260. nat/observability/exporter/raw_exporter.py +52 -0
  261. nat/observability/exporter/span_exporter.py +288 -0
  262. nat/observability/exporter_manager.py +335 -0
  263. nat/observability/mixin/__init__.py +14 -0
  264. nat/observability/mixin/batch_config_mixin.py +26 -0
  265. nat/observability/mixin/collector_config_mixin.py +23 -0
  266. nat/observability/mixin/file_mixin.py +288 -0
  267. nat/observability/mixin/file_mode.py +23 -0
  268. nat/observability/mixin/resource_conflict_mixin.py +134 -0
  269. nat/observability/mixin/serialize_mixin.py +61 -0
  270. nat/observability/mixin/type_introspection_mixin.py +183 -0
  271. nat/observability/processor/__init__.py +14 -0
  272. nat/observability/processor/batching_processor.py +310 -0
  273. nat/observability/processor/callback_processor.py +42 -0
  274. nat/observability/processor/intermediate_step_serializer.py +28 -0
  275. nat/observability/processor/processor.py +71 -0
  276. nat/observability/register.py +96 -0
  277. nat/observability/utils/__init__.py +14 -0
  278. nat/observability/utils/dict_utils.py +236 -0
  279. nat/observability/utils/time_utils.py +31 -0
  280. nat/plugins/.namespace +1 -0
  281. nat/profiler/__init__.py +0 -0
  282. nat/profiler/calc/__init__.py +14 -0
  283. nat/profiler/calc/calc_runner.py +627 -0
  284. nat/profiler/calc/calculations.py +288 -0
  285. nat/profiler/calc/data_models.py +188 -0
  286. nat/profiler/calc/plot.py +345 -0
  287. nat/profiler/callbacks/__init__.py +0 -0
  288. nat/profiler/callbacks/agno_callback_handler.py +295 -0
  289. nat/profiler/callbacks/base_callback_class.py +20 -0
  290. nat/profiler/callbacks/langchain_callback_handler.py +290 -0
  291. nat/profiler/callbacks/llama_index_callback_handler.py +205 -0
  292. nat/profiler/callbacks/semantic_kernel_callback_handler.py +238 -0
  293. nat/profiler/callbacks/token_usage_base_model.py +27 -0
  294. nat/profiler/data_frame_row.py +51 -0
  295. nat/profiler/data_models.py +24 -0
  296. nat/profiler/decorators/__init__.py +0 -0
  297. nat/profiler/decorators/framework_wrapper.py +131 -0
  298. nat/profiler/decorators/function_tracking.py +254 -0
  299. nat/profiler/forecasting/__init__.py +0 -0
  300. nat/profiler/forecasting/config.py +18 -0
  301. nat/profiler/forecasting/model_trainer.py +75 -0
  302. nat/profiler/forecasting/models/__init__.py +22 -0
  303. nat/profiler/forecasting/models/forecasting_base_model.py +40 -0
  304. nat/profiler/forecasting/models/linear_model.py +197 -0
  305. nat/profiler/forecasting/models/random_forest_regressor.py +269 -0
  306. nat/profiler/inference_metrics_model.py +28 -0
  307. nat/profiler/inference_optimization/__init__.py +0 -0
  308. nat/profiler/inference_optimization/bottleneck_analysis/__init__.py +0 -0
  309. nat/profiler/inference_optimization/bottleneck_analysis/nested_stack_analysis.py +460 -0
  310. nat/profiler/inference_optimization/bottleneck_analysis/simple_stack_analysis.py +258 -0
  311. nat/profiler/inference_optimization/data_models.py +386 -0
  312. nat/profiler/inference_optimization/experimental/__init__.py +0 -0
  313. nat/profiler/inference_optimization/experimental/concurrency_spike_analysis.py +468 -0
  314. nat/profiler/inference_optimization/experimental/prefix_span_analysis.py +405 -0
  315. nat/profiler/inference_optimization/llm_metrics.py +212 -0
  316. nat/profiler/inference_optimization/prompt_caching.py +163 -0
  317. nat/profiler/inference_optimization/token_uniqueness.py +107 -0
  318. nat/profiler/inference_optimization/workflow_runtimes.py +72 -0
  319. nat/profiler/intermediate_property_adapter.py +102 -0
  320. nat/profiler/profile_runner.py +473 -0
  321. nat/profiler/utils.py +184 -0
  322. nat/registry_handlers/__init__.py +0 -0
  323. nat/registry_handlers/local/__init__.py +0 -0
  324. nat/registry_handlers/local/local_handler.py +176 -0
  325. nat/registry_handlers/local/register_local.py +37 -0
  326. nat/registry_handlers/metadata_factory.py +60 -0
  327. nat/registry_handlers/package_utils.py +571 -0
  328. nat/registry_handlers/pypi/__init__.py +0 -0
  329. nat/registry_handlers/pypi/pypi_handler.py +251 -0
  330. nat/registry_handlers/pypi/register_pypi.py +40 -0
  331. nat/registry_handlers/register.py +21 -0
  332. nat/registry_handlers/registry_handler_base.py +157 -0
  333. nat/registry_handlers/rest/__init__.py +0 -0
  334. nat/registry_handlers/rest/register_rest.py +56 -0
  335. nat/registry_handlers/rest/rest_handler.py +237 -0
  336. nat/registry_handlers/schemas/__init__.py +0 -0
  337. nat/registry_handlers/schemas/headers.py +42 -0
  338. nat/registry_handlers/schemas/package.py +68 -0
  339. nat/registry_handlers/schemas/publish.py +68 -0
  340. nat/registry_handlers/schemas/pull.py +82 -0
  341. nat/registry_handlers/schemas/remove.py +36 -0
  342. nat/registry_handlers/schemas/search.py +91 -0
  343. nat/registry_handlers/schemas/status.py +47 -0
  344. nat/retriever/__init__.py +0 -0
  345. nat/retriever/interface.py +41 -0
  346. nat/retriever/milvus/__init__.py +14 -0
  347. nat/retriever/milvus/register.py +81 -0
  348. nat/retriever/milvus/retriever.py +228 -0
  349. nat/retriever/models.py +77 -0
  350. nat/retriever/nemo_retriever/__init__.py +14 -0
  351. nat/retriever/nemo_retriever/register.py +60 -0
  352. nat/retriever/nemo_retriever/retriever.py +190 -0
  353. nat/retriever/register.py +22 -0
  354. nat/runtime/__init__.py +14 -0
  355. nat/runtime/loader.py +220 -0
  356. nat/runtime/runner.py +195 -0
  357. nat/runtime/session.py +162 -0
  358. nat/runtime/user_metadata.py +130 -0
  359. nat/settings/__init__.py +0 -0
  360. nat/settings/global_settings.py +318 -0
  361. nat/test/.namespace +1 -0
  362. nat/tool/__init__.py +0 -0
  363. nat/tool/chat_completion.py +74 -0
  364. nat/tool/code_execution/README.md +151 -0
  365. nat/tool/code_execution/__init__.py +0 -0
  366. nat/tool/code_execution/code_sandbox.py +267 -0
  367. nat/tool/code_execution/local_sandbox/.gitignore +1 -0
  368. nat/tool/code_execution/local_sandbox/Dockerfile.sandbox +60 -0
  369. nat/tool/code_execution/local_sandbox/__init__.py +13 -0
  370. nat/tool/code_execution/local_sandbox/local_sandbox_server.py +198 -0
  371. nat/tool/code_execution/local_sandbox/sandbox.requirements.txt +6 -0
  372. nat/tool/code_execution/local_sandbox/start_local_sandbox.sh +50 -0
  373. nat/tool/code_execution/register.py +74 -0
  374. nat/tool/code_execution/test_code_execution_sandbox.py +414 -0
  375. nat/tool/code_execution/utils.py +100 -0
  376. nat/tool/datetime_tools.py +42 -0
  377. nat/tool/document_search.py +141 -0
  378. nat/tool/github_tools/__init__.py +0 -0
  379. nat/tool/github_tools/create_github_commit.py +133 -0
  380. nat/tool/github_tools/create_github_issue.py +87 -0
  381. nat/tool/github_tools/create_github_pr.py +106 -0
  382. nat/tool/github_tools/get_github_file.py +106 -0
  383. nat/tool/github_tools/get_github_issue.py +166 -0
  384. nat/tool/github_tools/get_github_pr.py +256 -0
  385. nat/tool/github_tools/update_github_issue.py +100 -0
  386. nat/tool/mcp/__init__.py +14 -0
  387. nat/tool/mcp/exceptions.py +142 -0
  388. nat/tool/mcp/mcp_client.py +255 -0
  389. nat/tool/mcp/mcp_tool.py +96 -0
  390. nat/tool/memory_tools/__init__.py +0 -0
  391. nat/tool/memory_tools/add_memory_tool.py +79 -0
  392. nat/tool/memory_tools/delete_memory_tool.py +67 -0
  393. nat/tool/memory_tools/get_memory_tool.py +72 -0
  394. nat/tool/nvidia_rag.py +95 -0
  395. nat/tool/register.py +38 -0
  396. nat/tool/retriever.py +94 -0
  397. nat/tool/server_tools.py +66 -0
  398. nat/utils/__init__.py +0 -0
  399. nat/utils/data_models/__init__.py +0 -0
  400. nat/utils/data_models/schema_validator.py +58 -0
  401. nat/utils/debugging_utils.py +43 -0
  402. nat/utils/dump_distro_mapping.py +32 -0
  403. nat/utils/exception_handlers/__init__.py +0 -0
  404. nat/utils/exception_handlers/automatic_retries.py +289 -0
  405. nat/utils/exception_handlers/mcp.py +211 -0
  406. nat/utils/exception_handlers/schemas.py +114 -0
  407. nat/utils/io/__init__.py +0 -0
  408. nat/utils/io/model_processing.py +28 -0
  409. nat/utils/io/yaml_tools.py +119 -0
  410. nat/utils/log_utils.py +37 -0
  411. nat/utils/metadata_utils.py +74 -0
  412. nat/utils/optional_imports.py +142 -0
  413. nat/utils/producer_consumer_queue.py +178 -0
  414. nat/utils/reactive/__init__.py +0 -0
  415. nat/utils/reactive/base/__init__.py +0 -0
  416. nat/utils/reactive/base/observable_base.py +65 -0
  417. nat/utils/reactive/base/observer_base.py +55 -0
  418. nat/utils/reactive/base/subject_base.py +79 -0
  419. nat/utils/reactive/observable.py +59 -0
  420. nat/utils/reactive/observer.py +76 -0
  421. nat/utils/reactive/subject.py +131 -0
  422. nat/utils/reactive/subscription.py +49 -0
  423. nat/utils/settings/__init__.py +0 -0
  424. nat/utils/settings/global_settings.py +197 -0
  425. nat/utils/string_utils.py +38 -0
  426. nat/utils/type_converter.py +290 -0
  427. nat/utils/type_utils.py +484 -0
  428. nat/utils/url_utils.py +27 -0
  429. nvidia_nat-1.2.0.dist-info/METADATA +365 -0
  430. nvidia_nat-1.2.0.dist-info/RECORD +435 -0
  431. nvidia_nat-1.2.0.dist-info/WHEEL +5 -0
  432. nvidia_nat-1.2.0.dist-info/entry_points.txt +21 -0
  433. nvidia_nat-1.2.0.dist-info/licenses/LICENSE-3rd-party.txt +5478 -0
  434. nvidia_nat-1.2.0.dist-info/licenses/LICENSE.md +201 -0
  435. nvidia_nat-1.2.0.dist-info/top_level.txt +2 -0
@@ -0,0 +1,143 @@
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
+
20
+ from mcp.server.fastmcp import FastMCP
21
+ from starlette.requests import Request
22
+
23
+ from nat.builder.function import Function
24
+ from nat.builder.workflow import Workflow
25
+ from nat.builder.workflow_builder import WorkflowBuilder
26
+ from nat.data_models.config import Config
27
+ from nat.front_ends.mcp.mcp_front_end_config import MCPFrontEndConfig
28
+
29
+ logger = logging.getLogger(__name__)
30
+
31
+
32
+ class MCPFrontEndPluginWorkerBase(ABC):
33
+ """Base class for MCP front end plugin workers."""
34
+
35
+ def __init__(self, config: Config):
36
+ """Initialize the MCP worker with configuration.
37
+
38
+ Args:
39
+ config: The full NAT configuration
40
+ """
41
+ self.full_config = config
42
+ self.front_end_config: MCPFrontEndConfig = config.general.front_end
43
+
44
+ def _setup_health_endpoint(self, mcp: FastMCP):
45
+ """Set up the HTTP health endpoint that exercises MCP ping handler."""
46
+
47
+ @mcp.custom_route("/health", methods=["GET"])
48
+ async def health_check(_request: Request):
49
+ """HTTP health check using server's internal ping handler"""
50
+ from starlette.responses import JSONResponse
51
+
52
+ try:
53
+ from mcp.types import PingRequest
54
+
55
+ # Create a ping request
56
+ ping_request = PingRequest(method="ping")
57
+
58
+ # Call the ping handler directly (same one that responds to MCP pings)
59
+ await mcp._mcp_server.request_handlers[PingRequest](ping_request)
60
+
61
+ return JSONResponse({
62
+ "status": "healthy",
63
+ "error": None,
64
+ "server_name": mcp.name,
65
+ })
66
+
67
+ except Exception as e:
68
+ return JSONResponse({
69
+ "status": "unhealthy",
70
+ "error": str(e),
71
+ "server_name": mcp.name,
72
+ },
73
+ status_code=503)
74
+
75
+ @abstractmethod
76
+ async def add_routes(self, mcp: FastMCP, builder: WorkflowBuilder):
77
+ """Add routes to the MCP server.
78
+
79
+ Args:
80
+ mcp: The FastMCP server instance
81
+ builder (WorkflowBuilder): The workflow builder instance
82
+ """
83
+ pass
84
+
85
+ def _get_all_functions(self, workflow: Workflow) -> dict[str, Function]:
86
+ """Get all functions from the workflow.
87
+
88
+ Args:
89
+ workflow: The NAT workflow.
90
+
91
+ Returns:
92
+ Dict mapping function names to Function objects.
93
+ """
94
+ functions: dict[str, Function] = {}
95
+
96
+ # Extract all functions from the workflow
97
+ for function_name, function in workflow.functions.items():
98
+ functions[function_name] = function
99
+
100
+ functions[workflow.config.workflow.type] = workflow
101
+
102
+ return functions
103
+
104
+
105
+ class MCPFrontEndPluginWorker(MCPFrontEndPluginWorkerBase):
106
+ """Default MCP front end plugin worker implementation."""
107
+
108
+ async def add_routes(self, mcp: FastMCP, builder: WorkflowBuilder):
109
+ """Add default routes to the MCP server.
110
+
111
+ Args:
112
+ mcp: The FastMCP server instance
113
+ builder (WorkflowBuilder): The workflow builder instance
114
+ """
115
+ from nat.front_ends.mcp.tool_converter import register_function_with_mcp
116
+
117
+ # Set up the health endpoint
118
+ self._setup_health_endpoint(mcp)
119
+
120
+ # Build the workflow and register all functions with MCP
121
+ workflow = builder.build()
122
+
123
+ # Get all functions from the workflow
124
+ functions = self._get_all_functions(workflow)
125
+
126
+ # Filter functions based on tool_names if provided
127
+ if self.front_end_config.tool_names:
128
+ logger.info("Filtering functions based on tool_names: %s", self.front_end_config.tool_names)
129
+ filtered_functions: dict[str, Function] = {}
130
+ for function_name, function in functions.items():
131
+ if function_name in self.front_end_config.tool_names:
132
+ filtered_functions[function_name] = function
133
+ else:
134
+ logger.debug("Skipping function %s as it's not in tool_names", function_name)
135
+ functions = filtered_functions
136
+
137
+ # Register each function with MCP
138
+ for function_name, function in functions.items():
139
+ register_function_with_mcp(mcp, function_name, function)
140
+
141
+ # Add a simple fallback function if no functions were found
142
+ if not functions:
143
+ raise RuntimeError("No functions found in workflow. Please check your configuration.")
@@ -0,0 +1,27 @@
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 nat.cli.register_workflow import register_front_end
19
+ from nat.data_models.config import Config
20
+ from nat.front_ends.mcp.mcp_front_end_config import MCPFrontEndConfig
21
+
22
+
23
+ @register_front_end(config_type=MCPFrontEndConfig)
24
+ async def register_mcp_front_end(config: MCPFrontEndConfig, full_config: Config) -> AsyncIterator:
25
+ from nat.front_ends.mcp.mcp_front_end_plugin import MCPFrontEndPlugin
26
+
27
+ yield MCPFrontEndPlugin(full_config=full_config)
@@ -0,0 +1,241 @@
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
+
21
+ from mcp.server.fastmcp import FastMCP
22
+ from pydantic import BaseModel
23
+
24
+ from nat.builder.function import Function
25
+ from nat.builder.function_base import FunctionBase
26
+ from nat.builder.workflow import Workflow
27
+
28
+ logger = logging.getLogger(__name__)
29
+
30
+
31
+ def create_function_wrapper(
32
+ function_name: str,
33
+ function: FunctionBase,
34
+ schema: type[BaseModel],
35
+ is_workflow: bool = False,
36
+ ):
37
+ """Create a wrapper function that exposes the actual parameters of a NAT Function as an MCP tool.
38
+
39
+ Args:
40
+ function_name: The name of the function/tool
41
+ function: The NAT Function object
42
+ schema: The input schema of the function
43
+ is_workflow: Whether the function is a Workflow
44
+
45
+ Returns:
46
+ A wrapper function suitable for registration with MCP
47
+ """
48
+ # Check if we're dealing with ChatRequest - special case
49
+ is_chat_request = False
50
+
51
+ # Check if the schema name is ChatRequest
52
+ if schema.__name__ == "ChatRequest" or (hasattr(schema, "__qualname__") and "ChatRequest" in schema.__qualname__):
53
+ is_chat_request = True
54
+ logger.info("Function %s uses ChatRequest - creating simplified interface", function_name)
55
+
56
+ # For ChatRequest, we'll create a simple wrapper with just a query parameter
57
+ parameters = [Parameter(
58
+ name="query",
59
+ kind=Parameter.KEYWORD_ONLY,
60
+ default=Parameter.empty,
61
+ annotation=str,
62
+ )]
63
+ else:
64
+ # Regular case - extract parameter information from the input schema
65
+ # Extract parameter information from the input schema
66
+ param_fields = schema.model_fields
67
+
68
+ parameters = []
69
+ for name, field in param_fields.items():
70
+ # Get the field type and convert to appropriate Python type
71
+ field_type = field.annotation
72
+
73
+ # Add the parameter to our list
74
+ parameters.append(
75
+ Parameter(
76
+ name=name,
77
+ kind=Parameter.KEYWORD_ONLY,
78
+ default=Parameter.empty if field.is_required else None,
79
+ annotation=field_type,
80
+ ))
81
+
82
+ # Create the function signature WITHOUT the ctx parameter
83
+ # We'll handle this in the wrapper function internally
84
+ sig = Signature(parameters=parameters, return_annotation=str)
85
+
86
+ # Define the actual wrapper function that accepts ctx but doesn't expose it
87
+ def create_wrapper():
88
+
89
+ async def wrapper_with_ctx(**kwargs):
90
+ """Internal wrapper that will be called by MCP."""
91
+ # MCP will add a ctx parameter, extract it
92
+ ctx = kwargs.get("ctx")
93
+
94
+ # Remove ctx if present
95
+ if "ctx" in kwargs:
96
+ del kwargs["ctx"]
97
+
98
+ # Process the function call
99
+ if ctx:
100
+ ctx.info("Calling function %s with args: %s", function_name, json.dumps(kwargs, default=str))
101
+ await ctx.report_progress(0, 100)
102
+
103
+ try:
104
+ # Special handling for ChatRequest
105
+ if is_chat_request:
106
+ from nat.data_models.api_server import ChatRequest
107
+
108
+ # Create a chat request from the query string
109
+ query = kwargs.get("query", "")
110
+ chat_request = ChatRequest.from_string(query)
111
+
112
+ # Special handling for Workflow objects
113
+ if is_workflow:
114
+ # Workflows have a run method that is an async context manager
115
+ # that returns a Runner
116
+ async with function.run(chat_request) as runner:
117
+ # Get the result from the runner
118
+ result = await runner.result(to_type=str)
119
+ else:
120
+ # Regular functions use ainvoke
121
+ result = await function.ainvoke(chat_request, to_type=str)
122
+ else:
123
+ # Regular handling
124
+ # Handle complex input schema - if we extracted fields from a nested schema,
125
+ # we need to reconstruct the input
126
+ if len(schema.model_fields) == 1 and len(parameters) > 1:
127
+ # Get the field name from the original schema
128
+ field_name = next(iter(schema.model_fields.keys()))
129
+ field_type = schema.model_fields[field_name].annotation
130
+
131
+ # If it's a pydantic model, we need to create an instance
132
+ if hasattr(field_type, "model_validate"):
133
+ # Create the nested object
134
+ nested_obj = field_type.model_validate(kwargs)
135
+ # Call with the nested object
136
+ kwargs = {field_name: nested_obj}
137
+
138
+ # Call the NAT function with the parameters - special handling for Workflow
139
+ if is_workflow:
140
+ # For workflow with regular input, we'll assume the first parameter is the input
141
+ input_value = list(kwargs.values())[0] if kwargs else ""
142
+
143
+ # Workflows have a run method that is an async context manager
144
+ # that returns a Runner
145
+ async with function.run(input_value) as runner:
146
+ # Get the result from the runner
147
+ result = await runner.result(to_type=str)
148
+ else:
149
+ # Regular function call
150
+ result = await function.acall_invoke(**kwargs)
151
+
152
+ # Report completion
153
+ if ctx:
154
+ await ctx.report_progress(100, 100)
155
+
156
+ # Handle different result types for proper formatting
157
+ if isinstance(result, str):
158
+ return result
159
+ if isinstance(result, (dict, list)):
160
+ return json.dumps(result, default=str)
161
+ return str(result)
162
+ except Exception as e:
163
+ if ctx:
164
+ ctx.error("Error calling function %s: %s", function_name, str(e))
165
+ raise
166
+
167
+ return wrapper_with_ctx
168
+
169
+ # Create the wrapper function
170
+ wrapper = create_wrapper()
171
+
172
+ # Set the signature on the wrapper function (WITHOUT ctx)
173
+ wrapper.__signature__ = sig
174
+ wrapper.__name__ = function_name
175
+
176
+ # Return the wrapper with proper signature
177
+ return wrapper
178
+
179
+
180
+ def get_function_description(function: FunctionBase) -> str:
181
+ """
182
+ Retrieve a human-readable description for a NAT function or workflow.
183
+
184
+ The description is determined using the following precedence:
185
+ 1. If the function is a Workflow and has a 'description' attribute, use it.
186
+ 2. If the Workflow's config has a 'topic', use it.
187
+ 3. If the Workflow's config has a 'description', use it.
188
+ 4. If the function is a regular Function, use its 'description' attribute.
189
+
190
+ Args:
191
+ function: The NAT FunctionBase instance (Function or Workflow).
192
+
193
+ Returns:
194
+ The best available description string for the function.
195
+ """
196
+ function_description = ""
197
+
198
+ if isinstance(function, Workflow):
199
+ config = function.config
200
+
201
+ # Workflow doesn't have a description, but probably should
202
+ if hasattr(function, "description") and function.description:
203
+ function_description = function.description
204
+ # Try to get description from config
205
+ elif hasattr(config, "description") and config.description:
206
+ function_description = config.description
207
+ # Try to get anything that might be a description
208
+ elif hasattr(config, "topic") and config.topic:
209
+ function_description = config.topic
210
+
211
+ elif isinstance(function, Function):
212
+ function_description = function.description
213
+
214
+ return function_description
215
+
216
+
217
+ def register_function_with_mcp(mcp: FastMCP, function_name: str, function: FunctionBase) -> None:
218
+ """Register a NAT Function as an MCP tool.
219
+
220
+ Args:
221
+ mcp: The FastMCP instance
222
+ function_name: The name to register the function under
223
+ function: The NAT Function to register
224
+ """
225
+ logger.info("Registering function %s with MCP", function_name)
226
+
227
+ # Get the input schema from the function
228
+ input_schema = function.input_schema
229
+ logger.info("Function %s has input schema: %s", function_name, input_schema)
230
+
231
+ # Check if we're dealing with a Workflow
232
+ is_workflow = isinstance(function, Workflow)
233
+ if is_workflow:
234
+ logger.info("Function %s is a Workflow", function_name)
235
+
236
+ # Get function description
237
+ function_description = get_function_description(function)
238
+
239
+ # Create and register the wrapper function with MCP
240
+ wrapper_func = create_function_wrapper(function_name, function, input_schema, is_workflow)
241
+ mcp.tool(name=function_name, description=function_description)(wrapper_func)
@@ -0,0 +1,22 @@
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
+ # pylint: disable=unused-import
17
+ # flake8: noqa
18
+ # isort:skip_file
19
+
20
+ from .console import register as console_register
21
+ from .fastapi import register as fastapi_register
22
+ 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,54 @@
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
+ # Must yield the workflow function otherwise it cleans up
39
+ async with WorkflowBuilder.from_config(config=self.full_config) as builder:
40
+
41
+ if logger.isEnabledFor(logging.INFO):
42
+ stream = StringIO()
43
+
44
+ self.full_config.print_summary(stream=stream)
45
+
46
+ click.echo(stream.getvalue())
47
+
48
+ workflow = builder.build()
49
+ session_manager = SessionManager(workflow)
50
+ await self.run_workflow(session_manager)
51
+
52
+ @abstractmethod
53
+ async def run_workflow(self, session_manager: SessionManager):
54
+ pass
nat/llm/__init__.py ADDED
File without changes
@@ -0,0 +1,57 @@
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.retry_mixin import RetryMixin
25
+
26
+
27
+ class AWSBedrockModelConfig(LLMBaseConfig, RetryMixin, name="aws_bedrock"):
28
+ """An AWS Bedrock llm provider to be used with an LLM client."""
29
+
30
+ model_config = ConfigDict(protected_namespaces=())
31
+
32
+ # Completion parameters
33
+ model_name: str = Field(validation_alias=AliasChoices("model_name", "model"),
34
+ serialization_alias="model",
35
+ description="The model name for the hosted AWS Bedrock.")
36
+ temperature: float = Field(default=0.0, ge=0.0, le=1.0, description="Sampling temperature in [0, 1].")
37
+ max_tokens: int | None = Field(default=1024,
38
+ gt=0,
39
+ description="Maximum number of tokens to generate."
40
+ "This field is ONLY required when using AWS Bedrock with Langchain.")
41
+ context_size: int | None = Field(default=1024,
42
+ gt=0,
43
+ description="Maximum number of tokens to generate."
44
+ "This field is ONLY required when using AWS Bedrock with LlamaIndex.")
45
+
46
+ # Client parameters
47
+ region_name: str | None = Field(default="None", description="AWS region to use.")
48
+ base_url: str | None = Field(
49
+ default=None, description="Bedrock endpoint to use. Needed if you don't want to default to us-east-1 endpoint.")
50
+ credentials_profile_name: str | None = Field(
51
+ default=None, description="The name of the profile in the ~/.aws/credentials or ~/.aws/config files.")
52
+
53
+
54
+ @register_llm_provider(config_type=AWSBedrockModelConfig)
55
+ async def aws_bedrock_model(llm_config: AWSBedrockModelConfig, builder: Builder):
56
+
57
+ yield LLMProviderInfo(config=llm_config, description="A AWS Bedrock model for use with an LLM client.")
nat/llm/nim_llm.py ADDED
@@ -0,0 +1,46 @@
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.retry_mixin import RetryMixin
26
+
27
+
28
+ class NIMModelConfig(LLMBaseConfig, RetryMixin, name="nim"):
29
+ """An NVIDIA Inference Microservice (NIM) llm provider to be used with an LLM client."""
30
+
31
+ model_config = ConfigDict(protected_namespaces=())
32
+
33
+ api_key: str | None = Field(default=None, description="NVIDIA API key to interact with hosted NIM.")
34
+ base_url: str | None = Field(default=None, description="Base url to the hosted NIM.")
35
+ model_name: str = Field(validation_alias=AliasChoices("model_name", "model"),
36
+ serialization_alias="model",
37
+ description="The model name for the hosted NIM.")
38
+ temperature: float = Field(default=0.0, description="Sampling temperature in [0, 1].")
39
+ top_p: float = Field(default=1.0, description="Top-p for distribution sampling.")
40
+ max_tokens: PositiveInt = Field(default=300, description="Maximum number of tokens to generate.")
41
+
42
+
43
+ @register_llm_provider(config_type=NIMModelConfig)
44
+ async def nim_model(llm_config: NIMModelConfig, builder: Builder):
45
+
46
+ yield LLMProviderInfo(config=llm_config, description="A NIM model for use with an LLM client.")
nat/llm/openai_llm.py ADDED
@@ -0,0 +1,46 @@
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.retry_mixin import RetryMixin
25
+
26
+
27
+ class OpenAIModelConfig(LLMBaseConfig, RetryMixin, name="openai"):
28
+ """An OpenAI LLM provider to be used with an LLM client."""
29
+
30
+ model_config = ConfigDict(protected_namespaces=(), extra="allow")
31
+
32
+ api_key: str | None = Field(default=None, description="OpenAI API key to interact with hosted model.")
33
+ base_url: str | None = Field(default=None, description="Base url to the hosted model.")
34
+ model_name: str = Field(validation_alias=AliasChoices("model_name", "model"),
35
+ serialization_alias="model",
36
+ description="The OpenAI hosted model name.")
37
+ temperature: float = Field(default=0.0, description="Sampling temperature in [0, 1].")
38
+ top_p: float = Field(default=1.0, description="Top-p for distribution sampling.")
39
+ seed: int | None = Field(default=None, description="Random seed to set for generation.")
40
+ max_retries: int = Field(default=10, description="The max number of retries for the request.")
41
+
42
+
43
+ @register_llm_provider(config_type=OpenAIModelConfig)
44
+ async def openai_llm(config: OpenAIModelConfig, builder: Builder):
45
+
46
+ yield LLMProviderInfo(config=config, description="An OpenAI model for use with an LLM client.")
nat/llm/register.py ADDED
@@ -0,0 +1,23 @@
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
+ # pylint: disable=unused-import
17
+ # flake8: noqa
18
+ # isort:skip_file
19
+
20
+ # Import any providers which need to be automatically registered here
21
+ from . import aws_bedrock_llm
22
+ from . import nim_llm
23
+ from . import openai_llm