systemhealthai 0.1.0

An SRE AI agent to analyze, and report back on health of a node

AI SRE for system health triaging

As an SRE, Cloud engineer, you may have to constantly look at logs, metrics, traces to troubleshoot and triage issues to figure out why particular systems may be having issues. SystemHealthAI ( SHAI ) is an AI agent which will act as an AI SRE, to look at different data sources like prometheus, elasticsearch, cloudwatch, splunk and help triage issues and provide insights into why the system or systems might be acting up.

SHAI Architecture

Show Your Support ⭐

If you find SHAI useful, please consider giving it a STAR ! ⭐

Quick start

Pre-Reqs

• Install uv to run mcp servers
• OpenAI Api Key
• Datasource url for prometheus have a prometheus url ready to use
• pip or poetry

Using pip

pip install systemhealthai

From Source using poetry

git clone [e-mail]:ajinkyakadam/systemhealthai.git
cd systemhealthai
poetry install -e . 

Setup

Using SHAI

shai nodeA --model "openai:o4-mini"

The above command instructs shai to use the o4-mini model and triage the nodeA server. Please replace the nodeA with an actual hostname that you would like to find information for.

Roadmap

Datasource support

Data Source	Status	Description
Prometheus	✅	Find node metrics to correlate and triage health issues
Grafana Loki	🟡	search loki logs
Elasticsearch	🟡	search elasticsearch logs for system issues
Splunk	🟡	search splunk logs for system issues

LLM Provider Support

Provider	Status	Description
OpenAI	✅	Integrate with OpenAI models for advanced insights and triaging
Claude	🟡	Support for Claude models to assist in system health analysis
Hugging Face	🟡	Utilize Hugging Face models
Local LLMs	🟡	Deploy and use local LLMs for on-premise triaging solutions

How to Contribute

Contributions are welcome, be it bug reports, feature requests, or PRs!

• Open a github issue to report issues, or suggest features
• Open a pull request with improvements
• Share your experience and how it has been useful to you or your organization.

Citation

If you use shai in your work, blogs, projects, please do cite:

@software{systemhealthai,
  author = {Kadam, Ajinkya},
  title = {SHAI: An AI SRE for triaging system health issues},
  year = {2025},
  publisher = {GitHub},
  url = {https://github.com/ajinkyakadam/systemhealthai}
}

License

MIT