# 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:

1. The ticket description or error message
2. The hostname of the affected system
3. 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](https://github.com/vllm-project/vllm) |
| Model | `gemma4:a4b` |

> **Note:** A suitable implementation language for this project is yet to be determined.