holmesgpt 0.11.5__tar.gz

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 holmesgpt might be problematic. Click here for more details.

Files changed (182) hide show
  1. holmesgpt-0.11.5/LICENSE.txt +21 -0
  2. holmesgpt-0.11.5/PKG-INFO +400 -0
  3. holmesgpt-0.11.5/README.md +339 -0
  4. holmesgpt-0.11.5/holmes/.git_archival.json +7 -0
  5. holmesgpt-0.11.5/holmes/__init__.py +76 -0
  6. holmesgpt-0.11.5/holmes/__init__.py.bak +76 -0
  7. holmesgpt-0.11.5/holmes/clients/robusta_client.py +24 -0
  8. holmesgpt-0.11.5/holmes/common/env_vars.py +47 -0
  9. holmesgpt-0.11.5/holmes/config.py +526 -0
  10. holmesgpt-0.11.5/holmes/core/__init__.py +0 -0
  11. holmesgpt-0.11.5/holmes/core/conversations.py +578 -0
  12. holmesgpt-0.11.5/holmes/core/investigation.py +152 -0
  13. holmesgpt-0.11.5/holmes/core/investigation_structured_output.py +264 -0
  14. holmesgpt-0.11.5/holmes/core/issue.py +54 -0
  15. holmesgpt-0.11.5/holmes/core/llm.py +250 -0
  16. holmesgpt-0.11.5/holmes/core/models.py +157 -0
  17. holmesgpt-0.11.5/holmes/core/openai_formatting.py +51 -0
  18. holmesgpt-0.11.5/holmes/core/performance_timing.py +72 -0
  19. holmesgpt-0.11.5/holmes/core/prompt.py +42 -0
  20. holmesgpt-0.11.5/holmes/core/resource_instruction.py +17 -0
  21. holmesgpt-0.11.5/holmes/core/runbooks.py +26 -0
  22. holmesgpt-0.11.5/holmes/core/safeguards.py +120 -0
  23. holmesgpt-0.11.5/holmes/core/supabase_dal.py +540 -0
  24. holmesgpt-0.11.5/holmes/core/tool_calling_llm.py +798 -0
  25. holmesgpt-0.11.5/holmes/core/tools.py +566 -0
  26. holmesgpt-0.11.5/holmes/core/tools_utils/__init__.py +0 -0
  27. holmesgpt-0.11.5/holmes/core/tools_utils/tool_executor.py +65 -0
  28. holmesgpt-0.11.5/holmes/core/tools_utils/toolset_utils.py +52 -0
  29. holmesgpt-0.11.5/holmes/core/toolset_manager.py +418 -0
  30. holmesgpt-0.11.5/holmes/interactive.py +229 -0
  31. holmesgpt-0.11.5/holmes/main.py +1041 -0
  32. holmesgpt-0.11.5/holmes/plugins/__init__.py +0 -0
  33. holmesgpt-0.11.5/holmes/plugins/destinations/__init__.py +6 -0
  34. holmesgpt-0.11.5/holmes/plugins/destinations/slack/__init__.py +2 -0
  35. holmesgpt-0.11.5/holmes/plugins/destinations/slack/plugin.py +163 -0
  36. holmesgpt-0.11.5/holmes/plugins/interfaces.py +32 -0
  37. holmesgpt-0.11.5/holmes/plugins/prompts/__init__.py +48 -0
  38. holmesgpt-0.11.5/holmes/plugins/prompts/_current_date_time.jinja2 +1 -0
  39. holmesgpt-0.11.5/holmes/plugins/prompts/_default_log_prompt.jinja2 +11 -0
  40. holmesgpt-0.11.5/holmes/plugins/prompts/_fetch_logs.jinja2 +36 -0
  41. holmesgpt-0.11.5/holmes/plugins/prompts/_general_instructions.jinja2 +86 -0
  42. holmesgpt-0.11.5/holmes/plugins/prompts/_global_instructions.jinja2 +12 -0
  43. holmesgpt-0.11.5/holmes/plugins/prompts/_runbook_instructions.jinja2 +13 -0
  44. holmesgpt-0.11.5/holmes/plugins/prompts/_toolsets_instructions.jinja2 +56 -0
  45. holmesgpt-0.11.5/holmes/plugins/prompts/generic_ask.jinja2 +36 -0
  46. holmesgpt-0.11.5/holmes/plugins/prompts/generic_ask_conversation.jinja2 +32 -0
  47. holmesgpt-0.11.5/holmes/plugins/prompts/generic_ask_for_issue_conversation.jinja2 +50 -0
  48. holmesgpt-0.11.5/holmes/plugins/prompts/generic_investigation.jinja2 +42 -0
  49. holmesgpt-0.11.5/holmes/plugins/prompts/generic_post_processing.jinja2 +13 -0
  50. holmesgpt-0.11.5/holmes/plugins/prompts/generic_ticket.jinja2 +12 -0
  51. holmesgpt-0.11.5/holmes/plugins/prompts/investigation_output_format.jinja2 +32 -0
  52. holmesgpt-0.11.5/holmes/plugins/prompts/kubernetes_workload_ask.jinja2 +84 -0
  53. holmesgpt-0.11.5/holmes/plugins/prompts/kubernetes_workload_chat.jinja2 +39 -0
  54. holmesgpt-0.11.5/holmes/plugins/runbooks/README.md +22 -0
  55. holmesgpt-0.11.5/holmes/plugins/runbooks/__init__.py +100 -0
  56. holmesgpt-0.11.5/holmes/plugins/runbooks/catalog.json +14 -0
  57. holmesgpt-0.11.5/holmes/plugins/runbooks/jira.yaml +12 -0
  58. holmesgpt-0.11.5/holmes/plugins/runbooks/kube-prometheus-stack.yaml +10 -0
  59. holmesgpt-0.11.5/holmes/plugins/runbooks/networking/dns_troubleshooting_instructions.md +66 -0
  60. holmesgpt-0.11.5/holmes/plugins/runbooks/upgrade/upgrade_troubleshooting_instructions.md +44 -0
  61. holmesgpt-0.11.5/holmes/plugins/sources/github/__init__.py +77 -0
  62. holmesgpt-0.11.5/holmes/plugins/sources/jira/__init__.py +123 -0
  63. holmesgpt-0.11.5/holmes/plugins/sources/opsgenie/__init__.py +93 -0
  64. holmesgpt-0.11.5/holmes/plugins/sources/pagerduty/__init__.py +147 -0
  65. holmesgpt-0.11.5/holmes/plugins/sources/prometheus/__init__.py +0 -0
  66. holmesgpt-0.11.5/holmes/plugins/sources/prometheus/models.py +104 -0
  67. holmesgpt-0.11.5/holmes/plugins/sources/prometheus/plugin.py +154 -0
  68. holmesgpt-0.11.5/holmes/plugins/toolsets/__init__.py +171 -0
  69. holmesgpt-0.11.5/holmes/plugins/toolsets/aks-node-health.yaml +65 -0
  70. holmesgpt-0.11.5/holmes/plugins/toolsets/aks.yaml +86 -0
  71. holmesgpt-0.11.5/holmes/plugins/toolsets/argocd.yaml +70 -0
  72. holmesgpt-0.11.5/holmes/plugins/toolsets/atlas_mongodb/instructions.jinja2 +8 -0
  73. holmesgpt-0.11.5/holmes/plugins/toolsets/atlas_mongodb/mongodb_atlas.py +307 -0
  74. holmesgpt-0.11.5/holmes/plugins/toolsets/aws.yaml +76 -0
  75. holmesgpt-0.11.5/holmes/plugins/toolsets/azure_sql/__init__.py +0 -0
  76. holmesgpt-0.11.5/holmes/plugins/toolsets/azure_sql/apis/alert_monitoring_api.py +600 -0
  77. holmesgpt-0.11.5/holmes/plugins/toolsets/azure_sql/apis/azure_sql_api.py +309 -0
  78. holmesgpt-0.11.5/holmes/plugins/toolsets/azure_sql/apis/connection_failure_api.py +445 -0
  79. holmesgpt-0.11.5/holmes/plugins/toolsets/azure_sql/apis/connection_monitoring_api.py +251 -0
  80. holmesgpt-0.11.5/holmes/plugins/toolsets/azure_sql/apis/storage_analysis_api.py +317 -0
  81. holmesgpt-0.11.5/holmes/plugins/toolsets/azure_sql/azure_base_toolset.py +55 -0
  82. holmesgpt-0.11.5/holmes/plugins/toolsets/azure_sql/azure_sql_instructions.jinja2 +137 -0
  83. holmesgpt-0.11.5/holmes/plugins/toolsets/azure_sql/azure_sql_toolset.py +183 -0
  84. holmesgpt-0.11.5/holmes/plugins/toolsets/azure_sql/install.md +66 -0
  85. holmesgpt-0.11.5/holmes/plugins/toolsets/azure_sql/tools/__init__.py +1 -0
  86. holmesgpt-0.11.5/holmes/plugins/toolsets/azure_sql/tools/analyze_connection_failures.py +324 -0
  87. holmesgpt-0.11.5/holmes/plugins/toolsets/azure_sql/tools/analyze_database_connections.py +243 -0
  88. holmesgpt-0.11.5/holmes/plugins/toolsets/azure_sql/tools/analyze_database_health_status.py +205 -0
  89. holmesgpt-0.11.5/holmes/plugins/toolsets/azure_sql/tools/analyze_database_performance.py +249 -0
  90. holmesgpt-0.11.5/holmes/plugins/toolsets/azure_sql/tools/analyze_database_storage.py +373 -0
  91. holmesgpt-0.11.5/holmes/plugins/toolsets/azure_sql/tools/get_active_alerts.py +237 -0
  92. holmesgpt-0.11.5/holmes/plugins/toolsets/azure_sql/tools/get_slow_queries.py +172 -0
  93. holmesgpt-0.11.5/holmes/plugins/toolsets/azure_sql/tools/get_top_cpu_queries.py +170 -0
  94. holmesgpt-0.11.5/holmes/plugins/toolsets/azure_sql/tools/get_top_data_io_queries.py +188 -0
  95. holmesgpt-0.11.5/holmes/plugins/toolsets/azure_sql/tools/get_top_log_io_queries.py +180 -0
  96. holmesgpt-0.11.5/holmes/plugins/toolsets/azure_sql/utils.py +83 -0
  97. holmesgpt-0.11.5/holmes/plugins/toolsets/bash/__init__.py +0 -0
  98. holmesgpt-0.11.5/holmes/plugins/toolsets/bash/bash_instructions.jinja2 +14 -0
  99. holmesgpt-0.11.5/holmes/plugins/toolsets/bash/bash_toolset.py +208 -0
  100. holmesgpt-0.11.5/holmes/plugins/toolsets/bash/common/bash.py +52 -0
  101. holmesgpt-0.11.5/holmes/plugins/toolsets/bash/common/config.py +14 -0
  102. holmesgpt-0.11.5/holmes/plugins/toolsets/bash/common/stringify.py +25 -0
  103. holmesgpt-0.11.5/holmes/plugins/toolsets/bash/common/validators.py +24 -0
  104. holmesgpt-0.11.5/holmes/plugins/toolsets/bash/grep/__init__.py +52 -0
  105. holmesgpt-0.11.5/holmes/plugins/toolsets/bash/kubectl/__init__.py +100 -0
  106. holmesgpt-0.11.5/holmes/plugins/toolsets/bash/kubectl/constants.py +96 -0
  107. holmesgpt-0.11.5/holmes/plugins/toolsets/bash/kubectl/kubectl_describe.py +66 -0
  108. holmesgpt-0.11.5/holmes/plugins/toolsets/bash/kubectl/kubectl_events.py +88 -0
  109. holmesgpt-0.11.5/holmes/plugins/toolsets/bash/kubectl/kubectl_get.py +108 -0
  110. holmesgpt-0.11.5/holmes/plugins/toolsets/bash/kubectl/kubectl_logs.py +20 -0
  111. holmesgpt-0.11.5/holmes/plugins/toolsets/bash/kubectl/kubectl_run.py +46 -0
  112. holmesgpt-0.11.5/holmes/plugins/toolsets/bash/kubectl/kubectl_top.py +81 -0
  113. holmesgpt-0.11.5/holmes/plugins/toolsets/bash/parse_command.py +103 -0
  114. holmesgpt-0.11.5/holmes/plugins/toolsets/confluence.yaml +19 -0
  115. holmesgpt-0.11.5/holmes/plugins/toolsets/consts.py +5 -0
  116. holmesgpt-0.11.5/holmes/plugins/toolsets/coralogix/api.py +158 -0
  117. holmesgpt-0.11.5/holmes/plugins/toolsets/coralogix/toolset_coralogix_logs.py +103 -0
  118. holmesgpt-0.11.5/holmes/plugins/toolsets/coralogix/utils.py +181 -0
  119. holmesgpt-0.11.5/holmes/plugins/toolsets/datadog.py +153 -0
  120. holmesgpt-0.11.5/holmes/plugins/toolsets/docker.yaml +46 -0
  121. holmesgpt-0.11.5/holmes/plugins/toolsets/git.py +756 -0
  122. holmesgpt-0.11.5/holmes/plugins/toolsets/grafana/__init__.py +0 -0
  123. holmesgpt-0.11.5/holmes/plugins/toolsets/grafana/base_grafana_toolset.py +54 -0
  124. holmesgpt-0.11.5/holmes/plugins/toolsets/grafana/common.py +68 -0
  125. holmesgpt-0.11.5/holmes/plugins/toolsets/grafana/grafana_api.py +31 -0
  126. holmesgpt-0.11.5/holmes/plugins/toolsets/grafana/loki_api.py +89 -0
  127. holmesgpt-0.11.5/holmes/plugins/toolsets/grafana/tempo_api.py +124 -0
  128. holmesgpt-0.11.5/holmes/plugins/toolsets/grafana/toolset_grafana.py +102 -0
  129. holmesgpt-0.11.5/holmes/plugins/toolsets/grafana/toolset_grafana_loki.py +102 -0
  130. holmesgpt-0.11.5/holmes/plugins/toolsets/grafana/toolset_grafana_tempo.jinja2 +10 -0
  131. holmesgpt-0.11.5/holmes/plugins/toolsets/grafana/toolset_grafana_tempo.py +299 -0
  132. holmesgpt-0.11.5/holmes/plugins/toolsets/grafana/trace_parser.py +195 -0
  133. holmesgpt-0.11.5/holmes/plugins/toolsets/helm.yaml +42 -0
  134. holmesgpt-0.11.5/holmes/plugins/toolsets/internet/internet.py +275 -0
  135. holmesgpt-0.11.5/holmes/plugins/toolsets/internet/notion.py +137 -0
  136. holmesgpt-0.11.5/holmes/plugins/toolsets/kafka.py +638 -0
  137. holmesgpt-0.11.5/holmes/plugins/toolsets/kubernetes.yaml +255 -0
  138. holmesgpt-0.11.5/holmes/plugins/toolsets/kubernetes_logs.py +426 -0
  139. holmesgpt-0.11.5/holmes/plugins/toolsets/kubernetes_logs.yaml +42 -0
  140. holmesgpt-0.11.5/holmes/plugins/toolsets/logging_utils/__init__.py +0 -0
  141. holmesgpt-0.11.5/holmes/plugins/toolsets/logging_utils/logging_api.py +217 -0
  142. holmesgpt-0.11.5/holmes/plugins/toolsets/logging_utils/types.py +0 -0
  143. holmesgpt-0.11.5/holmes/plugins/toolsets/mcp/toolset_mcp.py +135 -0
  144. holmesgpt-0.11.5/holmes/plugins/toolsets/newrelic.py +222 -0
  145. holmesgpt-0.11.5/holmes/plugins/toolsets/opensearch/__init__.py +0 -0
  146. holmesgpt-0.11.5/holmes/plugins/toolsets/opensearch/opensearch.py +245 -0
  147. holmesgpt-0.11.5/holmes/plugins/toolsets/opensearch/opensearch_logs.py +151 -0
  148. holmesgpt-0.11.5/holmes/plugins/toolsets/opensearch/opensearch_traces.py +211 -0
  149. holmesgpt-0.11.5/holmes/plugins/toolsets/opensearch/opensearch_traces_instructions.jinja2 +12 -0
  150. holmesgpt-0.11.5/holmes/plugins/toolsets/opensearch/opensearch_utils.py +166 -0
  151. holmesgpt-0.11.5/holmes/plugins/toolsets/prometheus/prometheus.py +818 -0
  152. holmesgpt-0.11.5/holmes/plugins/toolsets/prometheus/prometheus_instructions.jinja2 +38 -0
  153. holmesgpt-0.11.5/holmes/plugins/toolsets/rabbitmq/api.py +398 -0
  154. holmesgpt-0.11.5/holmes/plugins/toolsets/rabbitmq/rabbitmq_instructions.jinja2 +37 -0
  155. holmesgpt-0.11.5/holmes/plugins/toolsets/rabbitmq/toolset_rabbitmq.py +222 -0
  156. holmesgpt-0.11.5/holmes/plugins/toolsets/robusta/__init__.py +0 -0
  157. holmesgpt-0.11.5/holmes/plugins/toolsets/robusta/robusta.py +235 -0
  158. holmesgpt-0.11.5/holmes/plugins/toolsets/robusta/robusta_instructions.jinja2 +24 -0
  159. holmesgpt-0.11.5/holmes/plugins/toolsets/runbook/__init__.py +0 -0
  160. holmesgpt-0.11.5/holmes/plugins/toolsets/runbook/runbook_fetcher.py +78 -0
  161. holmesgpt-0.11.5/holmes/plugins/toolsets/service_discovery.py +92 -0
  162. holmesgpt-0.11.5/holmes/plugins/toolsets/servicenow/install.md +37 -0
  163. holmesgpt-0.11.5/holmes/plugins/toolsets/servicenow/instructions.jinja2 +3 -0
  164. holmesgpt-0.11.5/holmes/plugins/toolsets/servicenow/servicenow.py +198 -0
  165. holmesgpt-0.11.5/holmes/plugins/toolsets/slab.yaml +20 -0
  166. holmesgpt-0.11.5/holmes/plugins/toolsets/utils.py +137 -0
  167. holmesgpt-0.11.5/holmes/plugins/utils.py +14 -0
  168. holmesgpt-0.11.5/holmes/utils/__init__.py +0 -0
  169. holmesgpt-0.11.5/holmes/utils/cache.py +84 -0
  170. holmesgpt-0.11.5/holmes/utils/cert_utils.py +40 -0
  171. holmesgpt-0.11.5/holmes/utils/default_toolset_installation_guide.jinja2 +44 -0
  172. holmesgpt-0.11.5/holmes/utils/definitions.py +13 -0
  173. holmesgpt-0.11.5/holmes/utils/env.py +53 -0
  174. holmesgpt-0.11.5/holmes/utils/file_utils.py +56 -0
  175. holmesgpt-0.11.5/holmes/utils/global_instructions.py +20 -0
  176. holmesgpt-0.11.5/holmes/utils/holmes_status.py +22 -0
  177. holmesgpt-0.11.5/holmes/utils/holmes_sync_toolsets.py +80 -0
  178. holmesgpt-0.11.5/holmes/utils/markdown_utils.py +55 -0
  179. holmesgpt-0.11.5/holmes/utils/pydantic_utils.py +54 -0
  180. holmesgpt-0.11.5/holmes/utils/robusta.py +10 -0
  181. holmesgpt-0.11.5/holmes/utils/tags.py +97 -0
  182. holmesgpt-0.11.5/pyproject.toml +114 -0
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2024 Robusta Dev Ltd
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
@@ -0,0 +1,400 @@
1
+ Metadata-Version: 2.3
2
+ Name: holmesgpt
3
+ Version: 0.11.5
4
+ Summary:
5
+ Author: Natan Yellin
6
+ Author-email: natan@robusta.dev
7
+ Requires-Python: >=3.10,<4.0
8
+ Classifier: Programming Language :: Python :: 3
9
+ Classifier: Programming Language :: Python :: 3.10
10
+ Classifier: Programming Language :: Python :: 3.11
11
+ Classifier: Programming Language :: Python :: 3.12
12
+ Classifier: Programming Language :: Python :: 3.13
13
+ Requires-Dist: aiohttp (>=3.10.2,<4.0.0)
14
+ Requires-Dist: azure-core (>=1.34.0,<2.0.0)
15
+ Requires-Dist: azure-identity (>=1.23.0,<2.0.0)
16
+ Requires-Dist: azure-mgmt-alertsmanagement (>=1.0.0,<2.0.0)
17
+ Requires-Dist: azure-mgmt-monitor (>=6.0.2,<7.0.0)
18
+ Requires-Dist: azure-mgmt-resource (>=24.0.0,<25.0.0)
19
+ Requires-Dist: azure-mgmt-sql (>=3.0.1,<4.0.0)
20
+ Requires-Dist: azure-monitor-query (>=1.2.0,<2.0.0)
21
+ Requires-Dist: backoff (>=2.2.1,<3.0.0)
22
+ Requires-Dist: boto3 (>=1.34.145,<2.0.0)
23
+ Requires-Dist: bs4 (>=0.0.2,<0.0.3)
24
+ Requires-Dist: cachetools (>=5.5.0,<6.0.0)
25
+ Requires-Dist: certifi (>=2024.7.4,<2025.0.0)
26
+ Requires-Dist: colorlog (>=6.8.2,<7.0.0)
27
+ Requires-Dist: confluent-kafka (>=2.6.1,<3.0.0)
28
+ Requires-Dist: fastapi (>=0.115,<0.116)
29
+ Requires-Dist: google-api-python-client (>=2.156.0,<3.0.0)
30
+ Requires-Dist: humanize (>=4.9.0,<5.0.0)
31
+ Requires-Dist: jinja2 (>=3.1.2,<4.0.0)
32
+ Requires-Dist: kubernetes (>=32.0.1,<33.0.0)
33
+ Requires-Dist: litellm (==1.66.0)
34
+ Requires-Dist: markdown (>=3.6,<4.0)
35
+ Requires-Dist: markdownify (>=1.1.0,<2.0.0)
36
+ Requires-Dist: mcp (==v1.9.0)
37
+ Requires-Dist: openai (>=1.6.1,<2.0.0)
38
+ Requires-Dist: opensearch-py (>=2.8.0,<3.0.0)
39
+ Requires-Dist: prompt-toolkit (>=3.0.51,<4.0.0)
40
+ Requires-Dist: protobuf (>=6.31.1)
41
+ Requires-Dist: pydantic (>=2.7,<3.0)
42
+ Requires-Dist: pydantic-settings (>=2.1.0,<3.0.0)
43
+ Requires-Dist: pydash (>=8.0.1,<9.0.0)
44
+ Requires-Dist: pyodbc (>=5.0.1,<6.0.0)
45
+ Requires-Dist: python-benedict (>=0.33.1,<0.34.0)
46
+ Requires-Dist: python_multipart (>=0.0.18,<0.0.19)
47
+ Requires-Dist: pyyaml (>=6.0.1,<7.0.0)
48
+ Requires-Dist: requests (>=2.32.4,<3.0.0)
49
+ Requires-Dist: rich (>=13.7.1,<14.0.0)
50
+ Requires-Dist: sentry-sdk[fastapi] (>=2.20.0,<3.0.0)
51
+ Requires-Dist: setuptools (>=80.9.0,<81.0.0)
52
+ Requires-Dist: slack-bolt (>=1.18.1,<2.0.0)
53
+ Requires-Dist: starlette (>=0.40,<0.41)
54
+ Requires-Dist: strenum (>=0.4.15,<0.5.0)
55
+ Requires-Dist: supabase (>=2.5,<3.0)
56
+ Requires-Dist: typer (>=0.15.4,<0.16.0)
57
+ Requires-Dist: urllib3 (>=1.26.19,<2.0.0)
58
+ Requires-Dist: uvicorn (>=0.30,<0.31)
59
+ Description-Content-Type: text/markdown
60
+
61
+ <div align="center">
62
+ <h1 align="center">Solve alerts faster with an AI Agent</h1>
63
+ <p align="center">
64
+ <a href="#how-it-works"><strong>How it Works</strong></a> |
65
+ <a href="#installation"><strong>Installation</strong></a> |
66
+ <a href="#supported-llm-providers"><strong>LLM Providers</strong></a> |
67
+ <a href="https://www.youtube.com/watch?v=TfQfx65LsDQ"><strong>YouTube Demo</strong></a> |
68
+ <a href="https://deepwiki.com/robusta-dev/holmesgpt"><img src="https://deepwiki.com/badge.svg" alt="Ask DeepWiki"></a>
69
+ </p>
70
+ </div>
71
+
72
+ Respond to alerts faster, using AI to automatically:
73
+
74
+ - Fetch logs, traces, and metrics
75
+ - Determine if issues are application or infrastructure related
76
+ - Find upstream root-causes
77
+
78
+ Using HolmesGPT, you can transform your existing alerts from this 👇
79
+
80
+ ![Before HolmesGPT](https://github.com/user-attachments/assets/931ebd71-ccd2-4b7b-969d-a061a99cec2d)
81
+
82
+ To this 👇
83
+
84
+ <img width="600" alt="example-holmesgpt-analysis" src="https://github.com/user-attachments/assets/d03df693-9eff-4d61-8947-2b101f648c3e" />
85
+
86
+ ### How it Works
87
+
88
+ HolmesGPT connects AI models with live observability data and organizational knowledge. It uses an **agentic loop** to analyze data from multiple sources and identify possible root causes.
89
+
90
+ <img width="3114" alt="holmesgpt-architecture-diagram" src="https://github.com/user-attachments/assets/f659707e-1958-4add-9238-8565a5e3713a" />
91
+
92
+ ### 🔗 Data Sources
93
+
94
+ HolmesGPT integrates with popular observability and cloud platforms. The following data sources ("toolsets") are built-in. [Add your own](#customizing-holmesgpt).
95
+
96
+ | Data Source | Status | Notes |
97
+ |-------------|--------|-------|
98
+ | [<img src="images/integration_logos/argocd-icon.png" alt="ArgoCD" width="20" style="vertical-align: middle;"> **ArgoCD**](https://docs.robusta.dev/master/configuration/holmesgpt/toolsets/argocd.html) | ✅ | Get status, history and manifests and more of apps, projects and clusters |
99
+ | [<img src="images/integration_logos/aws_rds_logo.png" alt="AWS RDS" width="20" style="vertical-align: middle;"> **AWS RDS**](https://docs.robusta.dev/master/configuration/holmesgpt/toolsets/aws.html) | ✅ | Fetch events, instances, slow query logs and more |
100
+ | [<img src="images/integration_logos/confluence_logo.png" alt="Confluence" width="20" style="vertical-align: middle;"> **Confluence**](https://docs.robusta.dev/master/configuration/holmesgpt/toolsets/confluence.html) | ✅ | Private runbooks and documentation |
101
+ | [<img src="images/integration_logos/coralogix-icon.png" alt="Coralogix Logs" width="20" style="vertical-align: middle;"> **Coralogix Logs**](https://docs.robusta.dev/master/configuration/holmesgpt/toolsets/coralogix_logs.html) | ✅ | Retrieve logs for any resource |
102
+ | [<img src="images/integration_logos/date_time_icon.png" alt="Datetime" width="20" style="vertical-align: middle;"> **Datetime**](https://docs.robusta.dev/master/configuration/holmesgpt/toolsets/datetime.html) | ✅ | Date and time-related operations |
103
+ | [<img src="images/integration_logos/docker_logo.png" alt="Docker" width="20" style="vertical-align: middle;"> **Docker**](https://docs.robusta.dev/master/configuration/holmesgpt/toolsets/docker.html) | ✅ | Get images, logs, events, history and more |
104
+ | <img src="images/integration_logos/github_logo.png" alt="GitHub" width="20" style="vertical-align: middle;"> **GitHub** | 🟡 Beta | Remediate alerts by opening pull requests with fixes |
105
+ | <img src="images/integration_logos/datadog_logo.png" alt="DataDog" width="20" style="vertical-align: middle;"> **DataDog** | 🟡 Beta | Fetches log data from datadog |
106
+ | [<img src="images/integration_logos/grafana_loki-icon.png" alt="Loki" width="20" style="vertical-align: middle;"> **Grafana Loki**](https://docs.robusta.dev/master/configuration/holmesgpt/toolsets/grafanaloki.html) | ✅ | Query logs for Kubernetes resources or any query |
107
+ | [<img src="images/integration_logos/tempo_logo.png" alt="Tempo" width="20" style="vertical-align: middle;"> **Grafana Tempo**](https://docs.robusta.dev/master/configuration/holmesgpt/toolsets/grafanatempo.html) | ✅ | Fetch trace info, debug issues like high latency in application. |
108
+ | [<img src="images/integration_logos/helm_logo.png" alt="Helm" width="20" style="vertical-align: middle;"> **Helm**](https://docs.robusta.dev/master/configuration/holmesgpt/toolsets/helm.html) | ✅ | Release status, chart metadata, and values |
109
+ | [<img src="images/integration_logos/http-icon.png" alt="Internet" width="20" style="vertical-align: middle;"> **Internet**](https://docs.robusta.dev/master/configuration/holmesgpt/toolsets/internet.html) | ✅ | Public runbooks, community docs etc |
110
+ | [<img src="images/integration_logos/kafka_logo.png" alt="Kafka" width="20" style="vertical-align: middle;"> **Kafka**](https://docs.robusta.dev/master/configuration/holmesgpt/toolsets/kafka.html) | ✅ | Fetch metadata, list consumers and topics or find lagging consumer groups |
111
+ | [<img src="images/integration_logos/kubernetes-icon.png" alt="Kubernetes" width="20" style="vertical-align: middle;"> **Kubernetes**](https://docs.robusta.dev/master/configuration/holmesgpt/toolsets/kubernetes.html) | ✅ | Pod logs, K8s events, and resource status (kubectl describe) |
112
+ | <img src="images/integration_logos/newrelic_logo.png" alt="NewRelic" width="20" style="vertical-align: middle;"> **NewRelic** | 🟡 Beta | Investigate alerts, query tracing data |
113
+ | [<img src="images/integration_logos/opensearchserverless-icon.png" alt="OpenSearch" width="20" style="vertical-align: middle;"> **OpenSearch**](https://docs.robusta.dev/master/configuration/holmesgpt/toolsets/opensearch.html) | ✅ | Query health, shard, and settings related info of one or more clusters|
114
+ | [<img src="images/integration_logos/prometheus-icon.png" alt="Prometheus" width="20" style="vertical-align: middle;"> **Prometheus**](https://docs.robusta.dev/master/configuration/holmesgpt/toolsets/prometheus.html) | ✅ | Investigate alerts, query metrics and generate PromQL queries |
115
+ | [<img src="images/integration_logos/rabbit_mq_logo.png" alt="RabbitMQ" width="20" style="vertical-align: middle;"> **RabbitMQ**](https://docs.robusta.dev/master/configuration/holmesgpt/toolsets/rabbitmq.html) | ✅ | Info about partitions, memory/disk alerts to troubleshoot split-brain scenarios and more |
116
+ | [<img src="images/integration_logos/robusta_logo.png" alt="Robusta" width="20" style="vertical-align: middle;"> **Robusta**](https://docs.robusta.dev/master/configuration/holmesgpt/toolsets/robusta.html) | ✅ | Multi-cluster monitoring, historical change data, user-configured runbooks, PromQL graphs and more |
117
+ | [<img src="images/integration_logos/slab_logo.png" alt="Slab" width="20" style="vertical-align: middle;"> **Slab**](https://docs.robusta.dev/master/configuration/holmesgpt/toolsets/slab.html) | ✅ | Team knowledge base and runbooks on demand |
118
+
119
+ ### 🔐 Data Privacy
120
+
121
+ By design, HolmesGPT has **read-only access** and respects RBAC permissions. It is safe to run in production environments.
122
+
123
+ We do **not** train HolmesGPT on your data. Data sent to Robusta SaaS is private to your account.
124
+
125
+ For extra privacy, [bring an API key](https://robusta-dev.github.io/holmesgpt/ai-providers/) for your own AI model.
126
+
127
+ ### 🚀 Bi-Directional Integrations With Your Tools
128
+
129
+ Robusta can investigate alerts - or just answer questions - from the following sources:
130
+
131
+ | Integration | Status | Notes |
132
+ |-------------------------|-----------|-------|
133
+ | Slack | 🟡 Beta | [Demo.](https://www.loom.com/share/afcd81444b1a4adfaa0bbe01c37a4847) Tag HolmesGPT bot in any Slack message |
134
+ | Prometheus/AlertManager | ✅ | Robusta SaaS or HolmesGPT CLI |
135
+ | PagerDuty | ✅ | HolmesGPT CLI only |
136
+ | OpsGenie | ✅ | HolmesGPT CLI only |
137
+ | Jira | ✅ | HolmesGPT CLI only |
138
+
139
+ ### See it in Action
140
+
141
+ <a href="https://www.loom.com/share/388d98aad1a04823b9ed50d0161a4819?sid=a2a669b4-f092-4067-adcb-c8527fbcaa90" target="_blank">
142
+ <img style="max-width:300px;" src="https://cdn.loom.com/sessions/thumbnails/388d98aad1a04823b9ed50d0161a4819-0ced91a0e8f80dcb-full-play.gif">
143
+ </a>
144
+
145
+
146
+ ## Installation
147
+
148
+ You can install HolmesGPT in one of the follow three methods:
149
+
150
+ 1. [Standalone](https://robusta-dev.github.io/holmesgpt/installation/cli-installation/): Run HolmesGPT from your terminal as a CLI tool. Typically installed with **Homebrew** or **Pip/Pipx**. Ideal for local use, **embedding into shell scripts, or CI/CD pipelines.** (E.g. to analyze why a pipeline deploying to Kubernetes failed.)
151
+ 2. **Web UIs and TUIs**: HolmesGPT is embedded in several third-party tools, like [Robusta SaaS](https://platform.robusta.dev/signup/?utm_source=github&utm_medium=holmesgpt-readme&utm_content=ways_to_use_holmesgpt_section) and [K9s](https://robusta-dev.github.io/holmesgpt/installation/ui-installation/) (as a plugin).
152
+ 3. **API**: Embed HolmesGPT in your own app to quickly add **root-cause-analysis functionality and data correlations across multiple sources like logs, metrics, and events**. HolmesGPT exposes an HTTP API and [Python SDK](https://robusta-dev.github.io/holmesgpt/installation/python-installation/), as well as [Helm chart](./helm/) to deploy the HTTP server on Kubernetes.
153
+
154
+ <table width="100%">
155
+ <tr valign="top">
156
+ <td colspan="2">
157
+ <h3>Standalone</h3>
158
+ <table width="100%">
159
+ <tr>
160
+ <td align="center" width="120">
161
+ <a href="https://robusta-dev.github.io/holmesgpt/installation/cli-installation/">
162
+ <img src="images/integration_logos/brew_logo.png" alt="Brew" width="50"><br>
163
+ <strong>Brew</strong>
164
+ </a>
165
+ </td>
166
+ <td align="center" width="120">
167
+ <a href="https://robusta-dev.github.io/holmesgpt/installation/cli-installation/">
168
+ <img src="images/integration_logos/pipx_logo.png" alt="pipx" width="50"><br>
169
+ <strong>Pipx</strong>
170
+ </a>
171
+ </td>
172
+ <td align="center" width="120">
173
+ <a href="https://robusta-dev.github.io/holmesgpt/installation/cli-installation/">
174
+ <img src="images/integration_logos/docker_logo.png" alt="Docker" width="50"><br>
175
+ <strong>Docker</strong>
176
+ </a>
177
+ </td>
178
+ <td align="center" width="120">
179
+ <a href="https://robusta-dev.github.io/holmesgpt/installation/cli-installation/">
180
+ <img src="images/integration_logos/docker_logo.png" alt="Docker Build" width="50"><br>
181
+ <strong>Docker Build</strong>
182
+ </a>
183
+ </td>
184
+ <td align="center" width="120">
185
+ <a href="https://robusta-dev.github.io/holmesgpt/installation/cli-installation/">
186
+ <img src="images/integration_logos/python_poetry_logo.png" alt="Python Poetry" width="50"><br>
187
+ <strong>Poetry</strong>
188
+ </a>
189
+ </td>
190
+ </tr>
191
+ </table>
192
+ </td>
193
+ </tr>
194
+ <tr valign="top">
195
+ <td width="30%">
196
+ <h3>Web UIs and TUIs</h3>
197
+ <table>
198
+ <tr>
199
+ <td align="center" width="120">
200
+ <a href="https://platform.robusta.dev/signup/?utm_source=github&utm_medium=holmesgpt-readme&utm_content=ways_to_use_holmesgpt_section">
201
+ <img src="images/integration_logos/robusta_logo.png" alt="Robusta SaaS" width="50"><br>
202
+ <strong>Robusta SaaS</strong>
203
+ </a>
204
+ </td>
205
+ <td align="center" width="120">
206
+ <a href="https://robusta-dev.github.io/holmesgpt/installation/ui-installation/">
207
+ <img src="images/integration_logos/k9s_logo.png" alt="K9s Plugin" width="50"><br>
208
+ <strong>K9s Plugin</strong>
209
+ </a>
210
+ </td>
211
+ </tr>
212
+ </table>
213
+ </td>
214
+ <td width="30%">
215
+ <h3>API</h3>
216
+ <table>
217
+ <tr>
218
+ <td align="center" width="120">
219
+ <a href="helm">
220
+ <img src="images/integration_logos/helm_logo.png" alt="Helm Chart" width="50"><br>
221
+ <strong>Helm Chart</strong>
222
+ </a>
223
+ </td>
224
+ <td align="center" width="120">
225
+ <a href="https://robusta-dev.github.io/holmesgpt/installation/python-installation/">
226
+ <img src="images/integration_logos/python_logo.png" alt="Python Package" width="50"><br>
227
+ <strong>Python API</strong>
228
+ </a>
229
+ </td>
230
+ </tr>
231
+ </table>
232
+ </td>
233
+
234
+ </tr>
235
+ </table>
236
+
237
+
238
+ ## Supported LLM Providers
239
+
240
+ Select your LLM provider to see how to set up your API Key.
241
+
242
+ <table>
243
+ <tr>
244
+ <td align="center" width="120">
245
+ <a href="https://robusta-dev.github.io/holmesgpt/ai-providers/openai/">
246
+ <img src="images/integration_logos/openai_logo.png" alt="OpenAI" width="50"><br>
247
+ <strong>OpenAI</strong>
248
+ </a>
249
+ </td>
250
+ <td align="center" width="120">
251
+ <a href="https://robusta-dev.github.io/holmesgpt/ai-providers/anthropic/">
252
+ <img src="images/integration_logos/anthropic_logo.png" alt="Anthropic" width="50"><br>
253
+ <strong>Anthropic</strong>
254
+ </a>
255
+ </td>
256
+ <td align="center" width="120">
257
+ <a href="https://robusta-dev.github.io/holmesgpt/ai-providers/aws-bedrock/">
258
+ <img src="images/integration_logos/aws_bedrock_logo.png" alt="AWS Bedrock" width="50"><br>
259
+ <strong>AWS Bedrock</strong>
260
+ </a>
261
+ </td>
262
+ <td align="center" width="120">
263
+ <a href="https://robusta-dev.github.io/holmesgpt/ai-providers/azure-openai/">
264
+ <img src="images/integration_logos/azure-openai.png" alt="Azure OpenAI" width="50"><br>
265
+ <strong>Azure OpenAI</strong>
266
+ </a>
267
+ </td>
268
+ <td align="center" width="120">
269
+ <a href="https://robusta-dev.github.io/holmesgpt/ai-providers/google-vertex-ai/">
270
+ <img src="images/integration_logos/google_vertexai_logo.png" alt="Google Vertex AI" width="50"><br>
271
+ <strong>Google Vertex AI</strong>
272
+ </a>
273
+ </td>
274
+ </tr>
275
+ <tr>
276
+ <td align="center" width="120">
277
+ <a href="https://robusta-dev.github.io/holmesgpt/ai-providers/gemini/">
278
+ <img src="images/integration_logos/gemini_logo.png" alt="Gemini" width="50"><br>
279
+ <strong>Gemini</strong>
280
+ </a>
281
+ </td>
282
+ <td align="center" width="120">
283
+ <a href="https://robusta-dev.github.io/holmesgpt/ai-providers/ollama/">
284
+ <img src="images/integration_logos/ollama_logo.png" alt="Ollama" width="50"><br>
285
+ <strong>Ollama</strong>
286
+ </a>
287
+ </td>
288
+ </tr>
289
+ </table>
290
+
291
+ You can also use any OpenAI-compatible models, read [here](https://robusta-dev.github.io/holmesgpt/ai-providers/openai-compatible/) for instructions.
292
+
293
+ ### Using HolmesGPT
294
+
295
+ - In the Robusta SaaS: Go to [platform.robusta.dev](https://platform.robusta.dev/signup/?utm_source=github&utm_medium=holmesgpt-readme&utm_content=ways_to_use_holmesgpt_section) and use Holmes from your browser
296
+ - With HolmesGPT CLI: [setup an LLM API key](https://robusta-dev.github.io/holmesgpt/ai-providers/) and ask Holmes a question 👇
297
+
298
+ ```bash
299
+ holmes ask "what pods are unhealthy and why?"
300
+ ```
301
+
302
+ You can also provide files as context:
303
+ ```bash
304
+ holmes ask "summarize the key points in this document" -f ./mydocument.txt
305
+ ```
306
+
307
+ You can also load the prompt from a file using the `--prompt-file` option:
308
+ ```bash
309
+ holmes ask --prompt-file ~/long-prompt.txt
310
+
311
+ Enter interactive mode to ask follow-up questions:
312
+ ```bash
313
+ holmes ask "what pods are unhealthy and why?" --interactive
314
+ # or
315
+ holmes ask "what pods are unhealthy and why?" -i
316
+ ```
317
+
318
+ Also supported:
319
+
320
+ <details>
321
+ <summary>HolmesGPT CLI: investigate Prometheus alerts</summary>
322
+
323
+ Pull alerts from AlertManager and investigate them with HolmesGPT:
324
+
325
+ ```bash
326
+ holmes investigate alertmanager --alertmanager-url http://localhost:9093
327
+ # if on Mac OS and using the Holmes Docker image👇
328
+ # holmes investigate alertmanager --alertmanager-url http://docker.for.mac.localhost:9093
329
+ ```
330
+
331
+ <b>To investigate alerts in your browser, sign up for a free trial of [Robusta SaaS](https://platform.robusta.dev/signup/?utm_source=github&utm_medium=holmesgpt-readme&utm_content=ways_to_use_holmesgpt_section). </b>
332
+
333
+
334
+ <b>Optional:</b> port-forward to AlertManager before running the command mentioned above (if running Prometheus inside Kubernetes)
335
+
336
+ ```bash
337
+ kubectl port-forward alertmanager-robusta-kube-prometheus-st-alertmanager-0 9093:9093 &
338
+ ```
339
+ </details>
340
+
341
+ <details>
342
+ <summary>HolmesGPT CLI: investigate PagerDuty and OpsGenie alerts</summary>
343
+
344
+ ```bash
345
+ holmes investigate opsgenie --opsgenie-api-key <OPSGENIE_API_KEY>
346
+ holmes investigate pagerduty --pagerduty-api-key <PAGERDUTY_API_KEY>
347
+ # to write the analysis back to the incident as a comment
348
+ holmes investigate pagerduty --pagerduty-api-key <PAGERDUTY_API_KEY> --update
349
+ ```
350
+
351
+ For more details, run `holmes investigate <source> --help`
352
+ </details>
353
+
354
+ ## Customizing HolmesGPT
355
+
356
+ HolmesGPT can investigate many issues out of the box, with no customization or training. Optionally, you can extend Holmes to improve results:
357
+
358
+ **Custom Data Sources**: Add data sources (toolsets) to improve investigations
359
+ - If using Robusta SaaS: See [Robusta's docs](https://docs.robusta.dev/master/configuration/holmesgpt/custom_toolsets.html)
360
+ - If using the CLI: Use `-t` flag with [custom toolset files](./examples/custom_toolset.yaml) or add to `~/.holmes/config.yaml`
361
+
362
+ **Custom Runbooks**: Give HolmesGPT instructions for known alerts:
363
+ - If using Robusta SaaS: Use the Robusta UI to add runbooks
364
+ - If using the CLI: Use `-r` flag with [custom runbook files](./examples/custom_runbooks.yaml) or add to `~/.holmes/config.yaml`
365
+
366
+ You can save common settings and API Keys in a config file to avoid passing them from the CLI each time:
367
+
368
+ <details>
369
+ <summary>Reading settings from a config file</summary>
370
+
371
+ You can save common settings and API keys in config file for re-use. Place the config file in <code>~/.holmes/config.yaml`</code> or pass it using the <code> --config</code>
372
+
373
+ You can view an example config file with all available settings [here](config.example.yaml).
374
+ </details>
375
+
376
+ ## Evals
377
+
378
+ Because HolmesGPT relies on LLMs, it relies on [a suite of pytest based evaluations](https://robusta-dev.github.io/holmesgpt/development/evals/) to ensure the prompt and HolmesGPT's default set of tools work as expected with LLMs.
379
+
380
+ - [Introduction to HolmesGPT's evals](https://robusta-dev.github.io/holmesgpt/development/evals/).
381
+ - [Write your own evals](https://robusta-dev.github.io/holmesgpt/development/evals/writing/).
382
+ - [Use Braintrust to view analyze results (optional)](https://robusta-dev.github.io/holmesgpt/development/evals/reporting/).
383
+
384
+
385
+ ## License
386
+ Distributed under the MIT License. See [LICENSE.txt](https://github.com/robusta-dev/holmesgpt/blob/master/LICENSE.txt) for more information.
387
+ <!-- Change License -->
388
+
389
+ ## Support
390
+
391
+ If you have any questions, feel free to message us on [robustacommunity.slack.com](https://bit.ly/robusta-slack)
392
+
393
+ ## How to Contribute
394
+
395
+ Please read our [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines and instructions.
396
+
397
+ For help, contact us on [Slack](https://bit.ly/robusta-slack) or ask [DeepWiki AI](https://deepwiki.com/robusta-dev/holmesgpt) your questions.
398
+
399
+ [![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/robusta-dev/holmesgpt)
400
+