zphinx
65c74dde5a
All checks were successful
CI / test (push) Successful in 14s
Co-authored-by: Copilot <copilot@github.com>
36 lines
1.6 KiB
Markdown
36 lines
1.6 KiB
Markdown
# 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
|
|
1. The hostname of the affected system
|
|
1. 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.
|