hammad-python 0.0.14__py3-none-any.whl → 0.0.16__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 (122) hide show
  1. hammad/__init__.py +177 -0
  2. hammad/{performance/imports.py → _internal.py} +7 -1
  3. hammad/cache/__init__.py +1 -1
  4. hammad/cli/__init__.py +3 -1
  5. hammad/cli/_runner.py +265 -0
  6. hammad/cli/animations.py +1 -1
  7. hammad/cli/plugins.py +133 -78
  8. hammad/cli/styles/__init__.py +1 -1
  9. hammad/cli/styles/utils.py +149 -3
  10. hammad/data/__init__.py +56 -29
  11. hammad/data/collections/__init__.py +27 -17
  12. hammad/data/collections/collection.py +205 -383
  13. hammad/data/collections/indexes/__init__.py +37 -0
  14. hammad/data/collections/indexes/qdrant/__init__.py +1 -0
  15. hammad/data/collections/indexes/qdrant/index.py +735 -0
  16. hammad/data/collections/indexes/qdrant/settings.py +94 -0
  17. hammad/data/collections/indexes/qdrant/utils.py +220 -0
  18. hammad/data/collections/indexes/tantivy/__init__.py +1 -0
  19. hammad/data/collections/indexes/tantivy/index.py +428 -0
  20. hammad/data/collections/indexes/tantivy/settings.py +51 -0
  21. hammad/data/collections/indexes/tantivy/utils.py +200 -0
  22. hammad/data/configurations/__init__.py +2 -2
  23. hammad/data/configurations/configuration.py +2 -2
  24. hammad/data/models/__init__.py +20 -9
  25. hammad/data/models/extensions/__init__.py +4 -0
  26. hammad/data/models/{pydantic → extensions/pydantic}/__init__.py +6 -19
  27. hammad/data/models/{pydantic → extensions/pydantic}/converters.py +143 -16
  28. hammad/data/models/{base/fields.py → fields.py} +1 -1
  29. hammad/data/models/{base/model.py → model.py} +1 -1
  30. hammad/data/models/{base/utils.py → utils.py} +1 -1
  31. hammad/data/sql/__init__.py +23 -0
  32. hammad/data/sql/database.py +578 -0
  33. hammad/data/sql/types.py +141 -0
  34. hammad/data/types/__init__.py +1 -3
  35. hammad/data/types/file.py +3 -3
  36. hammad/data/types/multimodal/__init__.py +2 -2
  37. hammad/data/types/multimodal/audio.py +2 -2
  38. hammad/data/types/multimodal/image.py +2 -2
  39. hammad/formatting/__init__.py +9 -27
  40. hammad/formatting/json/__init__.py +8 -2
  41. hammad/formatting/json/converters.py +7 -1
  42. hammad/formatting/text/__init__.py +1 -1
  43. hammad/formatting/yaml/__init__.py +1 -1
  44. hammad/genai/__init__.py +78 -0
  45. hammad/genai/agents/__init__.py +1 -0
  46. hammad/genai/agents/types/__init__.py +35 -0
  47. hammad/genai/agents/types/history.py +277 -0
  48. hammad/genai/agents/types/tool.py +490 -0
  49. hammad/genai/embedding_models/__init__.py +41 -0
  50. hammad/{ai/embeddings/client/litellm_embeddings_client.py → genai/embedding_models/embedding_model.py} +47 -142
  51. hammad/genai/embedding_models/embedding_model_name.py +77 -0
  52. hammad/genai/embedding_models/embedding_model_request.py +65 -0
  53. hammad/{ai/embeddings/types.py → genai/embedding_models/embedding_model_response.py} +3 -3
  54. hammad/genai/embedding_models/run.py +161 -0
  55. hammad/genai/language_models/__init__.py +35 -0
  56. hammad/genai/language_models/_streaming.py +622 -0
  57. hammad/genai/language_models/_types.py +276 -0
  58. hammad/genai/language_models/_utils/__init__.py +31 -0
  59. hammad/genai/language_models/_utils/_completions.py +131 -0
  60. hammad/genai/language_models/_utils/_messages.py +89 -0
  61. hammad/genai/language_models/_utils/_requests.py +202 -0
  62. hammad/genai/language_models/_utils/_structured_outputs.py +124 -0
  63. hammad/genai/language_models/language_model.py +734 -0
  64. hammad/genai/language_models/language_model_request.py +135 -0
  65. hammad/genai/language_models/language_model_response.py +219 -0
  66. hammad/genai/language_models/language_model_response_chunk.py +53 -0
  67. hammad/genai/language_models/run.py +530 -0
  68. hammad/genai/multimodal_models.py +48 -0
  69. hammad/genai/rerank_models.py +26 -0
  70. hammad/logging/__init__.py +1 -1
  71. hammad/logging/decorators.py +1 -1
  72. hammad/logging/logger.py +2 -2
  73. hammad/mcp/__init__.py +1 -1
  74. hammad/mcp/client/__init__.py +35 -0
  75. hammad/mcp/client/client.py +105 -4
  76. hammad/mcp/client/client_service.py +10 -3
  77. hammad/mcp/servers/__init__.py +24 -0
  78. hammad/{performance/runtime → runtime}/__init__.py +2 -2
  79. hammad/{performance/runtime → runtime}/decorators.py +1 -1
  80. hammad/{performance/runtime → runtime}/run.py +1 -1
  81. hammad/service/__init__.py +1 -1
  82. hammad/service/create.py +3 -8
  83. hammad/service/decorators.py +8 -8
  84. hammad/typing/__init__.py +28 -0
  85. hammad/web/__init__.py +3 -3
  86. hammad/web/http/client.py +1 -1
  87. hammad/web/models.py +53 -21
  88. hammad/web/search/client.py +99 -52
  89. hammad/web/utils.py +13 -13
  90. hammad_python-0.0.16.dist-info/METADATA +191 -0
  91. hammad_python-0.0.16.dist-info/RECORD +110 -0
  92. hammad/ai/__init__.py +0 -1
  93. hammad/ai/_utils.py +0 -142
  94. hammad/ai/completions/__init__.py +0 -45
  95. hammad/ai/completions/client.py +0 -684
  96. hammad/ai/completions/create.py +0 -710
  97. hammad/ai/completions/settings.py +0 -100
  98. hammad/ai/completions/types.py +0 -792
  99. hammad/ai/completions/utils.py +0 -486
  100. hammad/ai/embeddings/__init__.py +0 -35
  101. hammad/ai/embeddings/client/__init__.py +0 -1
  102. hammad/ai/embeddings/client/base_embeddings_client.py +0 -26
  103. hammad/ai/embeddings/client/fastembed_text_embeddings_client.py +0 -200
  104. hammad/ai/embeddings/create.py +0 -159
  105. hammad/data/collections/base_collection.py +0 -58
  106. hammad/data/collections/searchable_collection.py +0 -556
  107. hammad/data/collections/vector_collection.py +0 -596
  108. hammad/data/databases/__init__.py +0 -21
  109. hammad/data/databases/database.py +0 -902
  110. hammad/data/models/base/__init__.py +0 -35
  111. hammad/data/models/pydantic/models/__init__.py +0 -28
  112. hammad/data/models/pydantic/models/arbitrary_model.py +0 -46
  113. hammad/data/models/pydantic/models/cacheable_model.py +0 -79
  114. hammad/data/models/pydantic/models/fast_model.py +0 -318
  115. hammad/data/models/pydantic/models/function_model.py +0 -176
  116. hammad/data/models/pydantic/models/subscriptable_model.py +0 -63
  117. hammad/performance/__init__.py +0 -36
  118. hammad/py.typed +0 -0
  119. hammad_python-0.0.14.dist-info/METADATA +0 -70
  120. hammad_python-0.0.14.dist-info/RECORD +0 -99
  121. {hammad_python-0.0.14.dist-info → hammad_python-0.0.16.dist-info}/WHEEL +0 -0
  122. {hammad_python-0.0.14.dist-info → hammad_python-0.0.16.dist-info}/licenses/LICENSE +0 -0
@@ -1,100 +0,0 @@
1
- """hammad.ai.completions.settings"""
2
-
3
- from typing import Any, Dict, List, Literal, Optional, Union
4
- import sys
5
- from httpx import Timeout
6
-
7
- if sys.version_info >= (3, 12):
8
- from typing import TypedDict
9
- else:
10
- from typing_extensions import TypedDict
11
-
12
- try:
13
- from openai.types.chat import (
14
- ChatCompletionModality,
15
- ChatCompletionPredictionContentParam,
16
- ChatCompletionAudioParam,
17
- )
18
- except ImportError:
19
- raise ImportError(
20
- "Using the `hammad.ai.completions` extension requires the `openai` package to be installed.\n"
21
- "Please either install the `openai` package, or install the `hammad.ai` extension with:\n"
22
- "`pip install 'hammad-python[ai]'"
23
- )
24
-
25
-
26
- __all__ = (
27
- "CompletionsModelSettings",
28
- "CompletionsSettings",
29
- )
30
-
31
-
32
- class OpenAIWebSearchUserLocationApproximate(TypedDict):
33
- city: str
34
- country: str
35
- region: str
36
- timezone: str
37
-
38
-
39
- class OpenAIWebSearchUserLocation(TypedDict):
40
- approximate: OpenAIWebSearchUserLocationApproximate
41
- type: Literal["approximate"]
42
-
43
-
44
- class OpenAIWebSearchOptions(TypedDict, total=False):
45
- search_context_size: Optional[Literal["low", "medium", "high"]]
46
- user_location: Optional[OpenAIWebSearchUserLocation]
47
-
48
-
49
- class AnthropicThinkingParam(TypedDict, total=False):
50
- type: Literal["enabled"]
51
- budget_tokens: int
52
-
53
-
54
- class CompletionsModelSettings(TypedDict, total=False):
55
- """Accepted **MODEL** specific settings for the `litellm` completion function."""
56
-
57
- timeout: Optional[Union[float, str, Timeout]]
58
- temperature: Optional[float]
59
- top_p: Optional[float]
60
- n: Optional[int]
61
- stream: Optional[bool]
62
- stream_options: Optional[Dict[str, Any]]
63
- stop: Optional[str]
64
- max_completion_tokens: Optional[int]
65
- max_tokens: Optional[int]
66
- modalities: Optional[List[ChatCompletionModality]]
67
- prediction: Optional[ChatCompletionPredictionContentParam]
68
- audio: Optional[ChatCompletionAudioParam]
69
- presence_penalty: Optional[float]
70
- frequency_penalty: Optional[float]
71
- logit_bias: Optional[Dict[str, float]]
72
- user: Optional[str]
73
- reasoning_effort: Optional[Literal["low", "medium", "high"]]
74
- # NOTE: response_format is not used within the `completions` resource
75
- # in place of `instructor` and the `type` parameter
76
- seed: Optional[int]
77
- tools: Optional[List]
78
- tool_choice: Optional[Union[str, Dict[str, Any]]]
79
- logprobs: Optional[bool]
80
- top_logprobs: Optional[int]
81
- parallel_tool_calls: Optional[bool]
82
- web_search_options: Optional[OpenAIWebSearchOptions]
83
- deployment_id: Optional[str]
84
- extra_headers: Optional[Dict[str, str]]
85
- base_url: Optional[str]
86
- functions: Optional[List]
87
- function_call: Optional[str]
88
- # set api_base, api_version, api_key
89
- api_version: Optional[str]
90
- api_key: Optional[str]
91
- model_list: Optional[list]
92
- # Optional liteLLM function params
93
- thinking: Optional[AnthropicThinkingParam]
94
-
95
-
96
- class CompletionsSettings(CompletionsModelSettings, total=False):
97
- """Accepted settings for the `litellm` completion function."""
98
-
99
- model: str
100
- messages: List