tai — Linux AI Troubleshooting Agent
tai is an agentic AI-driven troubleshooting tool for Linux systems. It autonomously investigates issues on remote hosts via SSH, analyzes relevant logs and configuration files, and provides a clear diagnosis along with suggested remediation steps — all without making any changes to the target system.
Overview
Given a problem description and a target hostname, tai connects to the remote system over SSH, gathers relevant data (logs, configuration files, service status, etc.), and uses a locally-hosted AI model to reason about the root cause and recommend solutions.
The agent operates in read-only mode at all times. It will never modify the target system under any circumstances — all suggestions are presented to the human troubleshooter for review and action.
Supported Distributions
- Ubuntu
- Debian
- RHEL
- Rocky Linux
Example Workflow
A troubleshooter receives a ticket reporting that the Apache service on a remote server has failed to start. They provide tai with:
- The ticket description or error message
- The hostname of the affected system
- Any relevant directories to focus on
tai then connects to the host, reads through system logs, service configurations, and any other related files, and returns a structured analysis of the likely cause along with recommended next steps.
Suggested Tooling
| Component | Tool |
|---|---|
| AI inference backend | vLLM |
| Model | gemma4:a4b |
Note: A suitable implementation language for this project is yet to be determined.