letta-client 0.1.324__py3-none-any.whl → 1.0.0a2__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.

Potentially problematic release.


This version of letta-client might be problematic. Click here for more details.

Files changed (251) hide show
  1. letta_client/__init__.py +229 -59
  2. letta_client/agents/__init__.py +15 -17
  3. letta_client/agents/blocks/__init__.py +3 -0
  4. letta_client/agents/blocks/client.py +77 -4
  5. letta_client/agents/blocks/raw_client.py +63 -2
  6. letta_client/agents/blocks/types/__init__.py +7 -0
  7. letta_client/agents/blocks/types/blocks_list_request_order.py +5 -0
  8. letta_client/agents/client.py +46 -13
  9. letta_client/agents/files/__init__.py +3 -0
  10. letta_client/agents/files/client.py +71 -10
  11. letta_client/agents/files/raw_client.py +51 -10
  12. letta_client/agents/files/types/__init__.py +7 -0
  13. letta_client/{types/tool_return_status.py → agents/files/types/files_list_request_order.py} +1 -1
  14. letta_client/agents/folders/__init__.py +3 -0
  15. letta_client/agents/folders/client.py +77 -4
  16. letta_client/agents/folders/raw_client.py +63 -2
  17. letta_client/agents/folders/types/__init__.py +7 -0
  18. letta_client/agents/folders/types/folders_list_request_order.py +5 -0
  19. letta_client/agents/groups/__init__.py +3 -0
  20. letta_client/agents/groups/client.py +71 -2
  21. letta_client/agents/groups/raw_client.py +51 -0
  22. letta_client/agents/groups/types/__init__.py +7 -0
  23. letta_client/agents/groups/types/groups_list_request_order.py +5 -0
  24. letta_client/agents/messages/__init__.py +2 -0
  25. letta_client/agents/messages/client.py +57 -18
  26. letta_client/agents/messages/raw_client.py +37 -18
  27. letta_client/agents/messages/types/__init__.py +2 -0
  28. letta_client/agents/messages/types/messages_list_request_order.py +5 -0
  29. letta_client/agents/passages/client.py +29 -0
  30. letta_client/agents/raw_client.py +4 -4
  31. letta_client/agents/sources/__init__.py +3 -0
  32. letta_client/agents/sources/client.py +77 -4
  33. letta_client/agents/sources/raw_client.py +63 -2
  34. letta_client/agents/sources/types/__init__.py +7 -0
  35. letta_client/agents/sources/types/sources_list_request_order.py +5 -0
  36. letta_client/agents/tools/__init__.py +3 -0
  37. letta_client/agents/tools/client.py +77 -4
  38. letta_client/agents/tools/raw_client.py +63 -2
  39. letta_client/agents/tools/types/__init__.py +7 -0
  40. letta_client/agents/tools/types/tools_list_request_order.py +5 -0
  41. letta_client/archives/client.py +16 -2
  42. letta_client/base_client.py +3 -0
  43. letta_client/batches/client.py +12 -2
  44. letta_client/batches/messages/client.py +10 -0
  45. letta_client/blocks/agents/client.py +8 -0
  46. letta_client/blocks/client.py +32 -2
  47. letta_client/chat/__init__.py +7 -0
  48. letta_client/chat/client.py +255 -0
  49. letta_client/chat/raw_client.py +269 -0
  50. letta_client/chat/types/__init__.py +8 -0
  51. letta_client/chat/types/chat_completion_request_messages_item.py +19 -0
  52. letta_client/chat/types/chat_completion_request_stop.py +5 -0
  53. letta_client/client_side_access_tokens/client.py +10 -2
  54. letta_client/core/client_wrapper.py +2 -2
  55. letta_client/errors/__init__.py +2 -0
  56. letta_client/errors/gone_error.py +10 -0
  57. letta_client/folders/agents/client.py +8 -0
  58. letta_client/folders/client.py +20 -4
  59. letta_client/folders/files/client.py +14 -0
  60. letta_client/folders/passages/client.py +8 -0
  61. letta_client/groups/client.py +16 -2
  62. letta_client/groups/messages/client.py +14 -0
  63. letta_client/identities/agents/client.py +8 -0
  64. letta_client/identities/blocks/client.py +8 -0
  65. letta_client/identities/client.py +20 -2
  66. letta_client/jobs/__init__.py +3 -0
  67. letta_client/jobs/client.py +61 -12
  68. letta_client/jobs/raw_client.py +29 -8
  69. letta_client/jobs/types/__init__.py +7 -0
  70. letta_client/jobs/types/jobs_list_request_order.py +5 -0
  71. letta_client/models/client.py +8 -2
  72. letta_client/projects/client.py +10 -2
  73. letta_client/providers/client.py +90 -2
  74. letta_client/providers/raw_client.py +102 -0
  75. letta_client/runs/__init__.py +11 -2
  76. letta_client/runs/client.py +152 -20
  77. letta_client/runs/messages/client.py +30 -2
  78. letta_client/runs/messages/raw_client.py +10 -0
  79. letta_client/runs/raw_client.py +146 -16
  80. letta_client/runs/steps/__init__.py +3 -0
  81. letta_client/runs/steps/client.py +39 -30
  82. letta_client/runs/steps/raw_client.py +19 -28
  83. letta_client/runs/steps/types/__init__.py +7 -0
  84. letta_client/runs/steps/types/steps_list_request_order.py +5 -0
  85. letta_client/runs/types/__init__.py +2 -1
  86. letta_client/runs/types/runs_list_request_order.py +5 -0
  87. letta_client/sources/client.py +8 -2
  88. letta_client/sources/files/client.py +12 -0
  89. letta_client/sources/passages/client.py +6 -0
  90. letta_client/steps/client.py +26 -2
  91. letta_client/steps/messages/client.py +8 -0
  92. letta_client/tags/client.py +16 -2
  93. letta_client/templates/__init__.py +88 -36
  94. letta_client/templates/client.py +165 -4
  95. letta_client/templates/raw_client.py +205 -2
  96. letta_client/templates/types/__init__.py +176 -72
  97. letta_client/templates/types/templates_create_agents_from_template_response_agents_item_llm_config.py +4 -0
  98. letta_client/templates/types/templates_create_agents_from_template_response_agents_item_llm_config_display_name.py +14 -0
  99. letta_client/templates/types/templates_create_agents_from_template_response_agents_item_llm_config_display_name_item.py +5 -0
  100. letta_client/templates/types/templates_create_agents_from_template_response_agents_item_secrets_item.py +4 -0
  101. letta_client/templates/types/templates_create_agents_from_template_response_agents_item_secrets_item_value_enc.py +14 -0
  102. letta_client/templates/types/templates_create_agents_from_template_response_agents_item_secrets_item_value_enc_item.py +5 -0
  103. letta_client/templates/types/templates_create_agents_from_template_response_agents_item_tool_exec_environment_variables_item.py +6 -0
  104. letta_client/templates/types/templates_create_agents_from_template_response_agents_item_tool_exec_environment_variables_item_value_enc.py +16 -0
  105. letta_client/templates/types/templates_create_agents_from_template_response_agents_item_tool_exec_environment_variables_item_value_enc_item.py +7 -0
  106. letta_client/templates/types/{templates_create_agents_from_template_response_agents_item_tool_rules_item_item_one.py → templates_create_agents_from_template_response_agents_item_tool_rules_item_args.py} +11 -7
  107. letta_client/templates/types/{templates_create_agents_from_template_response_agents_item_tool_rules_item_one_prompt_template.py → templates_create_agents_from_template_response_agents_item_tool_rules_item_args_args.py} +4 -5
  108. letta_client/templates/types/templates_create_agents_from_template_response_agents_item_tool_rules_item_args_args_item.py +7 -0
  109. letta_client/templates/types/{templates_create_agents_from_template_response_agents_item_tool_rules_item_zero_prompt_template.py → templates_create_agents_from_template_response_agents_item_tool_rules_item_args_prompt_template.py} +4 -4
  110. letta_client/templates/types/{templates_create_agents_from_template_response_agents_item_tool_rules_item_one_prompt_template_item.py → templates_create_agents_from_template_response_agents_item_tool_rules_item_args_prompt_template_item.py} +1 -1
  111. letta_client/templates/types/{templates_create_agents_from_template_response_agents_item_tool_rules_item_zero_type.py → templates_create_agents_from_template_response_agents_item_tool_rules_item_args_type.py} +1 -1
  112. letta_client/templates/types/{templates_create_agents_from_template_response_agents_item_tool_rules_item_zero.py → templates_create_agents_from_template_response_agents_item_tool_rules_item_child_arg_nodes.py} +13 -7
  113. letta_client/templates/types/templates_create_agents_from_template_response_agents_item_tool_rules_item_child_arg_nodes_child_arg_nodes.py +16 -0
  114. letta_client/templates/types/templates_create_agents_from_template_response_agents_item_tool_rules_item_child_arg_nodes_child_arg_nodes_item.py +12 -0
  115. letta_client/templates/types/templates_create_agents_from_template_response_agents_item_tool_rules_item_child_arg_nodes_child_arg_nodes_item_args.py +17 -0
  116. letta_client/templates/types/templates_create_agents_from_template_response_agents_item_tool_rules_item_child_arg_nodes_child_arg_nodes_item_args_item.py +7 -0
  117. letta_client/templates/types/{templates_create_agents_from_template_response_agents_item_tool_rules_item_one.py → templates_create_agents_from_template_response_agents_item_tool_rules_item_child_arg_nodes_child_arg_nodes_item_item.py} +8 -10
  118. letta_client/templates/types/templates_create_agents_from_template_response_agents_item_tool_rules_item_child_arg_nodes_child_arg_nodes_item_item_args.py +17 -0
  119. letta_client/templates/types/templates_create_agents_from_template_response_agents_item_tool_rules_item_child_arg_nodes_child_arg_nodes_item_item_args_item.py +7 -0
  120. letta_client/templates/types/{templates_create_agents_from_template_response_agents_item_tool_rules_item_item_zero_prompt_template.py → templates_create_agents_from_template_response_agents_item_tool_rules_item_child_arg_nodes_prompt_template.py} +4 -4
  121. letta_client/templates/types/{templates_create_agents_from_template_response_agents_item_tool_rules_item_item_one_prompt_template_item.py → templates_create_agents_from_template_response_agents_item_tool_rules_item_child_arg_nodes_prompt_template_item.py} +1 -1
  122. letta_client/templates/types/{templates_create_agents_from_template_response_agents_item_tool_rules_item_item_zero_type.py → templates_create_agents_from_template_response_agents_item_tool_rules_item_child_arg_nodes_type.py} +1 -1
  123. letta_client/templates/types/templates_create_agents_from_template_response_agents_item_tool_rules_item_item.py +8 -8
  124. letta_client/templates/types/{templates_create_agents_from_template_response_agents_item_tool_rules_item_item_zero.py → templates_create_agents_from_template_response_agents_item_tool_rules_item_item_args.py} +11 -8
  125. letta_client/templates/types/templates_create_agents_from_template_response_agents_item_tool_rules_item_item_args_args.py +13 -0
  126. letta_client/templates/types/templates_create_agents_from_template_response_agents_item_tool_rules_item_item_args_args_item.py +7 -0
  127. letta_client/templates/types/{templates_create_agents_from_template_response_agents_item_tool_rules_item_item_one_prompt_template.py → templates_create_agents_from_template_response_agents_item_tool_rules_item_item_args_prompt_template.py} +4 -4
  128. letta_client/templates/types/{templates_create_agents_from_template_response_agents_item_tool_rules_item_item_zero_prompt_template_item.py → templates_create_agents_from_template_response_agents_item_tool_rules_item_item_args_prompt_template_item.py} +1 -1
  129. letta_client/templates/types/{templates_create_agents_from_template_response_agents_item_tool_rules_item_item_one_type.py → templates_create_agents_from_template_response_agents_item_tool_rules_item_item_args_type.py} +1 -1
  130. letta_client/templates/types/templates_create_agents_from_template_response_agents_item_tool_rules_item_item_child_arg_nodes.py +37 -0
  131. letta_client/templates/types/templates_create_agents_from_template_response_agents_item_tool_rules_item_item_child_arg_nodes_child_arg_nodes.py +18 -0
  132. letta_client/templates/types/templates_create_agents_from_template_response_agents_item_tool_rules_item_item_child_arg_nodes_child_arg_nodes_item.py +12 -0
  133. letta_client/templates/types/templates_create_agents_from_template_response_agents_item_tool_rules_item_item_child_arg_nodes_child_arg_nodes_item_args.py +17 -0
  134. letta_client/templates/types/templates_create_agents_from_template_response_agents_item_tool_rules_item_item_child_arg_nodes_child_arg_nodes_item_args_item.py +7 -0
  135. letta_client/templates/types/templates_create_agents_from_template_response_agents_item_tool_rules_item_item_child_arg_nodes_child_arg_nodes_item_item.py +28 -0
  136. letta_client/templates/types/templates_create_agents_from_template_response_agents_item_tool_rules_item_item_child_arg_nodes_child_arg_nodes_item_item_args.py +17 -0
  137. letta_client/templates/types/templates_create_agents_from_template_response_agents_item_tool_rules_item_item_child_arg_nodes_child_arg_nodes_item_item_args_item.py +7 -0
  138. letta_client/templates/types/templates_create_agents_from_template_response_agents_item_tool_rules_item_item_child_arg_nodes_prompt_template.py +18 -0
  139. letta_client/templates/types/{templates_create_agents_from_template_response_agents_item_tool_rules_item_zero_prompt_template_item.py → templates_create_agents_from_template_response_agents_item_tool_rules_item_item_child_arg_nodes_prompt_template_item.py} +1 -1
  140. letta_client/templates/types/templates_create_agents_from_template_response_agents_item_tool_rules_item_item_child_arg_nodes_type.py +7 -0
  141. letta_client/templates/types/templates_create_agents_from_template_response_agents_item_tools_item_tool_type.py +1 -1
  142. letta_client/templates/types/templates_create_template_request_agent_file.py +5 -0
  143. letta_client/templates/types/templates_get_template_snapshot_response_agents_item_tool_rules_item.py +8 -8
  144. letta_client/templates/types/{templates_get_template_snapshot_response_agents_item_tool_rules_item_one.py → templates_get_template_snapshot_response_agents_item_tool_rules_item_args.py} +2 -1
  145. letta_client/templates/types/templates_get_template_snapshot_response_agents_item_tool_rules_item_child_arg_nodes.py +29 -0
  146. letta_client/templates/types/{templates_get_template_snapshot_response_agents_item_tool_rules_item_zero.py → templates_get_template_snapshot_response_agents_item_tool_rules_item_child_arg_nodes_child_arg_nodes_item.py} +3 -5
  147. letta_client/templates/types/templates_update_current_template_from_agent_file_response.py +21 -0
  148. letta_client/tools/client.py +30 -220
  149. letta_client/tools/raw_client.py +0 -292
  150. letta_client/types/__init__.py +134 -22
  151. letta_client/types/agent_environment_variable.py +5 -0
  152. letta_client/types/{action_parameters_model.py → annotation.py} +4 -10
  153. letta_client/types/{action_response_model.py → annotation_url_citation.py} +4 -9
  154. letta_client/types/approval_create.py +8 -2
  155. letta_client/types/approval_create_approvals_item.py +8 -0
  156. letta_client/types/approval_response_message.py +8 -2
  157. letta_client/types/approval_response_message_approvals_item.py +8 -0
  158. letta_client/types/approval_return.py +34 -0
  159. letta_client/{agents/templates/types/templates_migrate_response.py → types/audio.py} +4 -4
  160. letta_client/types/chat_completion.py +30 -0
  161. letta_client/types/chat_completion_assistant_message_param.py +30 -0
  162. letta_client/types/chat_completion_assistant_message_param_content.py +9 -0
  163. letta_client/types/chat_completion_assistant_message_param_content_item.py +10 -0
  164. letta_client/types/chat_completion_assistant_message_param_tool_calls_item.py +10 -0
  165. letta_client/types/chat_completion_audio.py +23 -0
  166. letta_client/types/chat_completion_content_part_image_param.py +22 -0
  167. letta_client/types/chat_completion_content_part_input_audio_param.py +22 -0
  168. letta_client/types/chat_completion_content_part_refusal_param.py +21 -0
  169. letta_client/types/chat_completion_content_part_text_param.py +21 -0
  170. letta_client/types/chat_completion_developer_message_param.py +23 -0
  171. letta_client/types/chat_completion_developer_message_param_content.py +7 -0
  172. letta_client/types/chat_completion_function_message_param.py +22 -0
  173. letta_client/types/chat_completion_message.py +30 -0
  174. letta_client/types/chat_completion_message_custom_tool_call.py +23 -0
  175. letta_client/types/chat_completion_message_custom_tool_call_param.py +23 -0
  176. letta_client/types/chat_completion_message_function_tool_call_input.py +25 -0
  177. letta_client/types/{chat_completion_message_function_tool_call.py → chat_completion_message_function_tool_call_output.py} +3 -3
  178. letta_client/types/chat_completion_message_function_tool_call_param.py +25 -0
  179. letta_client/types/chat_completion_message_tool_calls_item.py +10 -0
  180. letta_client/types/chat_completion_service_tier.py +5 -0
  181. letta_client/types/chat_completion_system_message_param.py +23 -0
  182. letta_client/types/chat_completion_system_message_param_content.py +7 -0
  183. letta_client/types/chat_completion_token_logprob.py +24 -0
  184. letta_client/types/chat_completion_tool_message_param.py +23 -0
  185. letta_client/types/chat_completion_tool_message_param_content.py +7 -0
  186. letta_client/types/chat_completion_user_message_param.py +23 -0
  187. letta_client/types/chat_completion_user_message_param_content.py +7 -0
  188. letta_client/types/chat_completion_user_message_param_content_item.py +15 -0
  189. letta_client/types/child_tool_rule.py +6 -0
  190. letta_client/types/choice.py +26 -0
  191. letta_client/types/choice_finish_reason.py +7 -0
  192. letta_client/types/choice_logprobs.py +22 -0
  193. letta_client/types/completion_tokens_details.py +23 -0
  194. letta_client/types/{auth_scheme_field.py → completion_usage.py} +8 -13
  195. letta_client/types/custom_input.py +21 -0
  196. letta_client/types/custom_output.py +21 -0
  197. letta_client/types/file.py +22 -0
  198. letta_client/types/file_file.py +22 -0
  199. letta_client/types/function_call_input.py +21 -0
  200. letta_client/types/function_call_output.py +21 -0
  201. letta_client/types/{function.py → function_output.py} +1 -1
  202. letta_client/types/image_url.py +22 -0
  203. letta_client/types/image_url_detail.py +5 -0
  204. letta_client/types/init_tool_rule.py +5 -0
  205. letta_client/types/input_audio.py +22 -0
  206. letta_client/types/input_audio_format.py +5 -0
  207. letta_client/types/internal_template_agent_create.py +2 -2
  208. letta_client/types/letta_schemas_agent_file_agent_schema.py +2 -2
  209. letta_client/types/letta_schemas_agent_file_message_schema.py +27 -4
  210. letta_client/types/letta_schemas_agent_file_message_schema_approvals_item.py +8 -0
  211. letta_client/types/letta_schemas_letta_message_tool_return.py +26 -0
  212. letta_client/types/letta_schemas_letta_message_tool_return_status.py +5 -0
  213. letta_client/types/{tool_return.py → letta_schemas_message_tool_return.py} +9 -3
  214. letta_client/types/letta_schemas_message_tool_return_status.py +5 -0
  215. letta_client/types/llm_config.py +5 -0
  216. letta_client/types/message.py +15 -4
  217. letta_client/types/message_approvals_item.py +8 -0
  218. letta_client/types/omitted_reasoning_content.py +4 -0
  219. letta_client/types/openai_types_chat_chat_completion_message_function_tool_call_function.py +21 -0
  220. letta_client/types/openai_types_chat_chat_completion_message_function_tool_call_param_function.py +21 -0
  221. letta_client/types/prompt_tokens_details.py +21 -0
  222. letta_client/types/provider.py +10 -0
  223. letta_client/types/run.py +28 -41
  224. letta_client/types/run_metrics.py +58 -0
  225. letta_client/types/run_status.py +5 -0
  226. letta_client/types/sandbox_environment_variable.py +5 -0
  227. letta_client/types/step.py +2 -2
  228. letta_client/types/step_metrics.py +2 -2
  229. letta_client/types/text_content.py +5 -0
  230. letta_client/types/tool_call_content.py +5 -0
  231. letta_client/types/tool_call_message.py +2 -0
  232. letta_client/types/tool_call_message_tool_calls.py +8 -0
  233. letta_client/types/tool_call_node.py +35 -0
  234. letta_client/types/tool_return_message.py +8 -5
  235. letta_client/types/tool_type.py +1 -1
  236. letta_client/types/top_logprob.py +22 -0
  237. letta_client/voice/client.py +14 -0
  238. letta_client/voice/raw_client.py +37 -0
  239. letta_client-1.0.0a2.dist-info/METADATA +422 -0
  240. {letta_client-0.1.324.dist-info → letta_client-1.0.0a2.dist-info}/RECORD +241 -141
  241. letta_client/agents/templates/__init__.py +0 -7
  242. letta_client/agents/templates/client.py +0 -307
  243. letta_client/agents/templates/raw_client.py +0 -275
  244. letta_client/agents/templates/types/__init__.py +0 -7
  245. letta_client/templates/types/templates_create_agents_from_template_response_agents_item_tool_rules_item_one_type.py +0 -5
  246. letta_client/types/action_model.py +0 -39
  247. letta_client/types/app_auth_scheme.py +0 -35
  248. letta_client/types/app_auth_scheme_auth_mode.py +0 -19
  249. letta_client/types/app_model.py +0 -45
  250. letta_client-0.1.324.dist-info/METADATA +0 -211
  251. {letta_client-0.1.324.dist-info → letta_client-1.0.0a2.dist-info}/WHEEL +0 -0
@@ -1,45 +0,0 @@
1
- # This file was auto-generated by Fern from our API Definition.
2
-
3
- import typing
4
-
5
- import pydantic
6
- import typing_extensions
7
- from ..core.pydantic_utilities import IS_PYDANTIC_V2
8
- from ..core.serialization import FieldMetadata
9
- from ..core.unchecked_base_model import UncheckedBaseModel
10
- from .app_auth_scheme import AppAuthScheme
11
-
12
-
13
- class AppModel(UncheckedBaseModel):
14
- """
15
- App data model.
16
- """
17
-
18
- name: str
19
- key: str
20
- app_id: typing_extensions.Annotated[str, FieldMetadata(alias="appId")]
21
- description: str
22
- categories: typing.List[str]
23
- meta: typing.Dict[str, typing.Optional[typing.Any]]
24
- logo: typing.Optional[str] = None
25
- docs: typing.Optional[str] = None
26
- group: typing.Optional[str] = None
27
- status: typing.Optional[str] = None
28
- enabled: typing.Optional[bool] = None
29
- no_auth: typing.Optional[bool] = None
30
- auth_schemes: typing.Optional[typing.List[AppAuthScheme]] = None
31
- test_connectors: typing_extensions.Annotated[
32
- typing.Optional[typing.List[typing.Dict[str, typing.Optional[typing.Any]]]],
33
- FieldMetadata(alias="testConnectors"),
34
- ] = None
35
- documentation_doc_text: typing.Optional[str] = None
36
- configuration_docs_text: typing.Optional[str] = None
37
-
38
- if IS_PYDANTIC_V2:
39
- model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True) # type: ignore # Pydantic v2
40
- else:
41
-
42
- class Config:
43
- frozen = True
44
- smart_union = True
45
- extra = pydantic.Extra.allow
@@ -1,211 +0,0 @@
1
- Metadata-Version: 2.1
2
- Name: letta-client
3
- Version: 0.1.324
4
- Summary:
5
- Requires-Python: >=3.8,<4.0
6
- Classifier: Intended Audience :: Developers
7
- Classifier: Operating System :: MacOS
8
- Classifier: Operating System :: Microsoft :: Windows
9
- Classifier: Operating System :: OS Independent
10
- Classifier: Operating System :: POSIX
11
- Classifier: Operating System :: POSIX :: Linux
12
- Classifier: Programming Language :: Python
13
- Classifier: Programming Language :: Python :: 3
14
- Classifier: Programming Language :: Python :: 3.8
15
- Classifier: Programming Language :: Python :: 3.9
16
- Classifier: Programming Language :: Python :: 3.10
17
- Classifier: Programming Language :: Python :: 3.11
18
- Classifier: Programming Language :: Python :: 3.12
19
- Classifier: Topic :: Software Development :: Libraries :: Python Modules
20
- Classifier: Typing :: Typed
21
- Requires-Dist: httpx (>=0.21.2)
22
- Requires-Dist: httpx-sse (==0.4.0)
23
- Requires-Dist: pydantic (>=1.9.2)
24
- Requires-Dist: pydantic-core (>=2.18.2)
25
- Requires-Dist: typing_extensions (>=4.0.0)
26
- Description-Content-Type: text/markdown
27
-
28
- # Letta Python Library
29
-
30
- [![fern shield](https://img.shields.io/badge/%F0%9F%8C%BF-Built%20with%20Fern-brightgreen)](https://buildwithfern.com?utm_source=github&utm_medium=github&utm_campaign=readme&utm_source=https%3A%2F%2Fgithub.com%2Fletta-ai%2Fletta-python)
31
- [![pypi](https://img.shields.io/pypi/v/letta-client)](https://pypi.python.org/pypi/letta-client)
32
-
33
- The Letta Python library provides convenient access to the Letta APIs from Python.
34
-
35
- ## Installation
36
-
37
- ```sh
38
- pip install letta-client
39
- ```
40
-
41
- ## Reference
42
-
43
- A full reference for this library is available [here](https://github.com/letta-ai/letta-python/blob/HEAD/./reference.md).
44
-
45
- ## Usage
46
-
47
- Instantiate and use the client with the following:
48
-
49
- ```python
50
- from letta_client import Letta
51
-
52
- client = Letta(
53
- project="YOUR_PROJECT",
54
- token="YOUR_TOKEN",
55
- )
56
- client.archives.create_archive(
57
- name="name",
58
- )
59
- ```
60
-
61
- ## Async Client
62
-
63
- The SDK also exports an `async` client so that you can make non-blocking calls to our API.
64
-
65
- ```python
66
- import asyncio
67
-
68
- from letta_client import AsyncLetta
69
-
70
- client = AsyncLetta(
71
- project="YOUR_PROJECT",
72
- token="YOUR_TOKEN",
73
- )
74
-
75
-
76
- async def main() -> None:
77
- await client.archives.create_archive(
78
- name="name",
79
- )
80
-
81
-
82
- asyncio.run(main())
83
- ```
84
-
85
- ## Exception Handling
86
-
87
- When the API returns a non-success status code (4xx or 5xx response), a subclass of the following error
88
- will be thrown.
89
-
90
- ```python
91
- from letta_client.core.api_error import ApiError
92
-
93
- try:
94
- client.archives.create_archive(...)
95
- except ApiError as e:
96
- print(e.status_code)
97
- print(e.body)
98
- ```
99
-
100
- ## Streaming
101
-
102
- The SDK supports streaming responses, as well, the response will be a generator that you can loop over.
103
-
104
- ```python
105
- from letta_client import Letta, StdioServerConfig
106
-
107
- client = Letta(
108
- project="YOUR_PROJECT",
109
- token="YOUR_TOKEN",
110
- )
111
- response = client.tools.connect_mcp_server(
112
- request=StdioServerConfig(
113
- server_name="server_name",
114
- command="command",
115
- args=["args"],
116
- ),
117
- )
118
- for chunk in response.data:
119
- yield chunk
120
- ```
121
-
122
- ## Advanced
123
-
124
- ### Access Raw Response Data
125
-
126
- The SDK provides access to raw response data, including headers, through the `.with_raw_response` property.
127
- The `.with_raw_response` property returns a "raw" client that can be used to access the `.headers` and `.data` attributes.
128
-
129
- ```python
130
- from letta_client import Letta
131
-
132
- client = Letta(
133
- ...,
134
- )
135
- response = client.archives.with_raw_response.create_archive(...)
136
- print(response.headers) # access the response headers
137
- print(response.data) # access the underlying object
138
- with client.tools.with_raw_response.connect_mcp_server(...) as response:
139
- print(response.headers) # access the response headers
140
- for chunk in response.data:
141
- print(chunk) # access the underlying object(s)
142
- ```
143
-
144
- ### Retries
145
-
146
- The SDK is instrumented with automatic retries with exponential backoff. A request will be retried as long
147
- as the request is deemed retryable and the number of retry attempts has not grown larger than the configured
148
- retry limit (default: 2).
149
-
150
- A request is deemed retryable when any of the following HTTP status codes is returned:
151
-
152
- - [408](https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/408) (Timeout)
153
- - [429](https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/429) (Too Many Requests)
154
- - [5XX](https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/500) (Internal Server Errors)
155
-
156
- Use the `max_retries` request option to configure this behavior.
157
-
158
- ```python
159
- client.archives.create_archive(..., request_options={
160
- "max_retries": 1
161
- })
162
- ```
163
-
164
- ### Timeouts
165
-
166
- The SDK defaults to a 60 second timeout. You can configure this with a timeout option at the client or request level.
167
-
168
- ```python
169
-
170
- from letta_client import Letta
171
-
172
- client = Letta(
173
- ...,
174
- timeout=20.0,
175
- )
176
-
177
-
178
- # Override timeout for a specific method
179
- client.archives.create_archive(..., request_options={
180
- "timeout_in_seconds": 1
181
- })
182
- ```
183
-
184
- ### Custom Client
185
-
186
- You can override the `httpx` client to customize it for your use-case. Some common use-cases include support for proxies
187
- and transports.
188
-
189
- ```python
190
- import httpx
191
- from letta_client import Letta
192
-
193
- client = Letta(
194
- ...,
195
- httpx_client=httpx.Client(
196
- proxies="http://my.test.proxy.example.com",
197
- transport=httpx.HTTPTransport(local_address="0.0.0.0"),
198
- ),
199
- )
200
- ```
201
-
202
- ## Contributing
203
-
204
- While we value open-source contributions to this SDK, this library is generated programmatically.
205
- Additions made directly to this library would have to be moved over to our generation code,
206
- otherwise they would be overwritten upon the next generated release. Feel free to open a PR as
207
- a proof of concept, but know that we will not be able to merge it as-is. We suggest opening
208
- an issue first to discuss with us!
209
-
210
- On the other hand, contributions to the README are always very welcome!
211
-