Servonaut

Servonaut

Your servers. Your terminal. Your AI agent. One TUI.

Manage AWS, Hetzner, OVH, and custom servers from one terminal — with a built-in AI assistant and MCP server.

Quick Install

Linux / macOS:

curl -fsSL https://github.com/zb-ss/servonaut/releases/latest/download/install.sh | bash

Windows (PowerShell):

irm https://github.com/zb-ss/servonaut/releases/latest/download/install.ps1 | iex

The scripts come from the latest stable release and install Servonaut from PyPI with pipx. Every release carries them with install-scripts_SHA256SUMS, to check a downloaded copy before you run it.

Or install directly via pipx / pip:

pipx install servonaut

Desktop app (preview), Linux: download the .deb from servonaut.dev/download, and see the Linux desktop preview notes before you install it.

Desktop app (preview), macOS 13 or later: releases that carry it have a signed and notarized disk image for Apple silicon (macos-arm64.dmg) and one for Intel Macs (macos-x64.dmg) on the releases page; see the macOS desktop preview notes. Both desktop previews tell you when a newer one is out, and never install it by themselves.

Try a release candidate

Each release is published as a release candidate (for example 2.28.0rc1) a few days before the stable release. Candidates are for people who want the next release early and will report what goes wrong. pip and pipx install one only when you ask for it.

# The newest candidate, with the install script

curl -fsSL https://github.com/zb-ss/servonaut/releases/latest/download/install.sh | bash -s -- --pre

With pipx: a specific candidate, or the newest one

pipx install --force 'servonaut==2.28.0rc1' pipx install --force 'servonaut>=0rc0'

With pip

pip install --upgrade 'servonaut>=0rc0'

Try one without changing your installation

pipx run --spec 'servonaut==2.28.0rc1' servonaut

Go back to the newest stable release (your configuration is kept)

pipx install --force servonaut

On Windows, run $env:SERVONAUT_PRE = "1" before the PowerShell installer. Avoid pip install --pre and pipx install --pip-args=--pre: they also install pre-release versions of Servonaut's dependencies, and some of those do not work with it.

While you run a candidate, the update check offers newer candidates and then the stable release. A stable installation is only ever offered stable releases. Please report problems in GitHub issues. Details: Release candidates.

Standalone CLI preview

Standalone console-only archives are being validated for Windows x64, macOS Intel and Apple Silicon, and Ubuntu x64. They are not published or downloadable yet. Until signed release installers are available, install Servonaut with pipx or pip.

Manual install from source:

git clone https://github.com/zb-ss/servonaut.git

cd servonaut pipx install .

Set up with an AI agent

Prefer to let an AI agent do the whole thing? Paste this prompt into Claude Code, Cursor, or any coding assistant — it installs Servonaut, generates the config, and walks you through AWS / SSH / bastion / custom-server / AI-provider setup plus the MCP server.

Copy-paste setup prompt

Install and configure Servonaut, a TUI for managing servers (AWS EC2, OVHcloud, Hetzner Cloud, and custom SSH servers).

1. Install with all optional features: pipx install 'servonaut[all]' (bundles the MCP server + OVH/Hetzner SDKs + keyring; AI log analysis needs no extra. Use plain pipx install servonaut for a minimal install.)
2. Run servonaut once to generate ~/.servonaut/config.json
3. (Optional) If I have a Servonaut account, run servonaut login to unlock the hosted features: Servonaut AI (chat with my fleet, no local API key), config sync across machines, Memory Sync, and proactive monitoring (Findings). Servonaut works fully offline against my own credentials if I skip this.
4. Read ~/.servonaut/config.json and help me configure:

• AWS regions to scan (default scans all, set regions array to limit)
• Default SSH username (default_username, default "ec2-user")
• Cache TTL (cache_ttl_seconds, default 3600)
• Terminal emulator if not auto-detected (terminal_emulator)

1. If I use bastion/jump hosts, help me set up connection_profiles and connection_rules
2. If I have non-AWS servers, help me add them to custom_servers
3. If I use OVHcloud or Hetzner Cloud, help me add the API credentials so those instances merge into the fleet
4. For AI log analysis or chat with my own model (instead of Servonaut AI), help me configure ai_provider (openai/anthropic/gemini/ollama)

• Each provider has its own key field (openai_api_key, anthropic_api_key, gemini_api_key, ollama_api_key); local Ollama needs none
• Key fields support $ENV_VAR and file:~/.secrets/key syntax so secrets stay out of the config file

1. Install the MCP server into my coding agent: servonaut --mcp-install claude (or cursor, windsurf, opencode, vscode, codex, agy, gemini, all)
2. (Optional) To let AI agents/teammates reach this machine over the relay — and to run proactive Findings scans — start it with servonaut connect

After setup, launch with servonaut and walk me through the key features, including the Findings inbox if I enabled the hosted features.

Screenshots

📸 More screenshots — CloudWatch Top IPs, IP banning, AI chat, sidebar, instance list

*Instance list — AWS, Hetzner, OVH, and custom servers merged into one view*

*Sidebar reveals Fleet Memory, Memory Sync, Secrets, Settings, and per-provider management for OVH and Hetzner*

*Built-in AI assistant with MCP server integration — chat with local providers or hosted Servonaut AI*

*CloudWatch log browsing with Top IPs analysis, geolocation, and abuse scoring*

*Ban/unban IPs via WAF, Security Groups, or NACLs with audit trail*

All screenshots and the launch video were recorded with --demo active, which replaces real IPs, ARNs, paths, and secrets with safe fake equivalents. See docs/demo-mode.md for what is redacted and how to use it.

Features

*Badges: Solo+ = included with paid Solo/Teams plans.*

Core & connectivity

• Interactive TUI — mouse + keyboard, powered by Textual.
• Multi-provider fleet — AWS EC2, OVHcloud (dedicated / VPS / Public Cloud), Hetzner Cloud, and custom servers from any provider (DigitalOcean, on-prem, …) — listed and searchable in one view across all regions.
• Multiple accounts per provider — several AWS accounts (named profiles), Hetzner projects and OVH accounts in the same fleet; servers show as account/name and every action runs in the server's own account. → docs
• Per-instance dashboard — click a server for a Server Actions view: a memory snapshot (OS, disk, web stack, databases, runtimes, containers) plus an opt-in live resource monitor (L — CPU / RAM / load / disk / uptime, polled only while open).
• SSH & SCP — one-key SSH in a new terminal window (auto-detected emulator); upload/download files and directories.
• Run remote commands — overlay panel with real-time streaming output, history, and saved favorites.
• Remote file browser — interactive file-tree navigation, inline in the dashboard or full-screen.
• Real-time log viewer — stream logs via tail -f with pause, search, and log switching.
• Robust SSH — bastion / jump-server (ProxyJump / ProxyCommand), keepalives on by default (tunable), per-host extra_ssh_options for legacy boxes, and key auto-discovery.
• SSH host-key checking — trust on first use: the first connection records a server's host key, and a later connection presenting a different key is refused, with the exact command that removes the old key once you have confirmed the change. → docs

Cloud provider management

• OVHcloud — OVH → ⚙ Manage: create / start / stop / reboot / delete (Cloud / VPS / dedicated), a region-first create wizard with API-backed pricing, plus DNS, IP blocks & failover IPs, snapshots, block storage, and billing.
• Hetzner Cloud — Hetzner → ⚙ Manage: full lifecycle + project SSH-key registry, with an equivalent CLI (servonaut hetzner …). Auto-registers new servers. → docs

Observability & security

• Proactive monitoring — Findings *(Solo+)* — cloud-side detectors surface fleet issues (disk, failed services, slow queries, credential-scanning cross-referenced with fail2ban, container health, TLS expiry, pending updates) as triageable cards, with gated one-click remediation (server-signed preview → human confirm → verb-allowlisted executor; block IP or renew a cert). → guide
• CloudWatch Logs browser — log groups with Top-IPs analysis, IP geolocation, and AbuseIPDB lookups.
• CloudTrail browser — AWS CloudTrail events with region / time / event / user filters.
• IP ban manager — ban IPs via AWS WAF, Security Groups, or NACLs, with an audit trail.
• Keyword server scanning — search file contents across instances.

AI

• Servonaut AI *(Solo+)* — hosted AI gateway; chat with your fleet with no local API key. The model can tail logs, run commands (with confirmation), and triage incidents over the relay — credentials and SSH keys never leave the CLI. Quota inline / servonaut ai quota.
• Bring your own key — OpenAI / Anthropic / Gemini / Ollama keys configured per-provider in Settings → AI Provider (local Ollama needs none). All coexist with Servonaut AI, switchable per-session.
• Built-in AI chat — LLM assistant with tool-calling against your instances (the same MCP tool surface below).
• AI log analysis — analyze logs with OpenAI, Anthropic, Gemini, or Ollama, with cost estimation.
• Voice — dictate into the chat panel with ctrl+t, have replies read aloud, or go fully hands-free with conversation mode (ctrl+n): the mic stays open between turns and replies are spoken — with optional barge-in (headphones mode) to interrupt a reply by talking over it. Transcription and speech synthesis run entirely on your machine, so audio never leaves the workstation. Opt-in — nothing is downloaded until you enable it in Settings. → docs

Memory & secrets

• Server memory — persistent per-server cache of OS / runtime / service / web-stack / log / database / container / git / disk facts; optional background fleet auto-scan. → docs
• Memory Sync *(Solo+)* — end-to-end-encrypted backup of fleet memory to servonaut.dev (X25519 + AES-256-GCM, your passphrase), with drift detection, cross-device history, and optional auto-sync. ☁ Memory Sync in the sidebar.
• Database credential vault *(Solo+)* — scan a server for the DB credentials its apps already use, store the password in your secret vault under a per-site label, and let the db_* tools resolve it by name — no password in config or agent context. → docs

Agents & automation (MCP)

• MCP server — ~80 tools