Skip to content

Repository files navigation

Admin Assistant

Troubleshoot servers faster with AI-assisted SSH diagnostics
Run commands, analyze output, and get actionable suggestions — all in one desktop app.

Build Release License

⚡ Desktop tool for real-world troubleshooting workflows

AI-powered desktop tool for SSH troubleshooting and system diagnostics.

Admin Assistant helps sysadmins and DevOps engineers connect to Linux hosts, run commands safely, inspect output in a structured console, and use AI to explain problems in plain language.

It combines SSH execution, reusable scripts, incident investigation, and approval-based AI suggestions in one Windows desktop app built for real troubleshooting workflows.

🚀 Get started

👉 Download latest version

Install and start troubleshooting in minutes.

🤔 Why Admin Assistant?

Troubleshooting over SSH is often:

  • slow and repetitive
  • full of copy-paste between terminal and browser
  • hard to explain to others

Admin Assistant combines execution, context, and AI analysis in one place — so you can diagnose issues faster and with more confidence.

👤 Who is this for?

  • System administrators
  • DevOps engineers
  • Anyone working with Linux over SSH

Screenshots

Main Window

Main window

Main workspace where you connect to servers, run commands, and see AI analysis side by side.

Incident Analysis

Incident analysis

Incident Mode helps you investigate real server problems by collecting safe diagnostics and turning them into readable evidence-based analysis.

Suggested Actions

Suggested actions

AI-suggested follow-up actions stay understandable, reviewable, and approval-based before anything is executed.

Server Configuration

Server configuration

Add SSH hosts quickly with password or key authentication while keeping credentials out of plaintext storage.

AI Provider Configuration

AI provider configuration

Configure OpenAI, Ollama, or an OpenAI-compatible endpoint without leaving the desktop app.

Quick Start

  1. Download the latest installer from GitHub Releases.
  2. Run AdminAssistant_Setup.exe.
  3. Launch Admin Assistant from the Start Menu or Desktop shortcut.
  4. Add a server in the Servers panel using your SSH host, username, and authentication method.
  5. Click Test to verify SSH connectivity.
  6. Run a manual command or saved script.
  7. Click Analyze to get AI-based troubleshooting help.

👉 You’re ready in under 1 minute

Features

  • SSH command execution for one host or many hosts
  • Reusable script library for common operational tasks
  • Multi-host console with All Hosts and per-host output views
  • AI analysis with OpenAI, Ollama, or OpenAI-compatible providers
  • Suggested actions and structured fix plans
  • Approval-based execution flow for AI-generated actions
  • Incident Mode for guided, evidence-driven troubleshooting
  • Run history with output replay and linked AI context

🧱 Built with

  • Python + PySide6
  • Paramiko (SSH)
  • OpenAI / Ollama support

Safety

Admin Assistant is built to help with troubleshooting without turning AI into an autonomous operator.

  • The app does not execute dangerous AI-generated commands automatically.
  • Suggested actions must be reviewed and explicitly approved by the user.
  • Incident Mode auto-runs only finite, read-only diagnostic commands.
  • Unsafe or inappropriate commands are filtered, including nested ssh commands and risky actions such as restarting sshd.
  • Command output is treated as operational data and should be reviewed carefully before sending it to external AI providers.

Windows SmartScreen Note

Windows SmartScreen may show a warning because the app is not code-signed yet.

If that happens:

  1. Click More info.
  2. Click Run anyway.

Only do this if you downloaded the installer from the official project release page.

Development

Tech stack:

  • Python
  • PySide6
  • Paramiko
  • SQLite
  • PyInstaller

Local run:

python -m venv venv
.\venv\Scripts\Activate.ps1
python -m pip install -e .[dev]
$env:PYTHONPATH = "src"
python -m admin_assistant.main

Documentation

Author

Dmitrii Fedorov

About

AI-powered desktop tool for server troubleshooting and incident investigation

Resources

Contributing

Stars

4 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages