zb-ss/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:**
**Windows (PowerShell):**
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:**
**Desktop app (preview), Linux:** download the .deb from
servonaut.dev/download, and see the
Linux desktop preview
notes before you install it.
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.
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:**
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
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.