Servonaut Documentation

A modern Python TUI for managing AWS, OVH Cloud, Hetzner Cloud, and any custom SSH host — with full server lifecycle, AI log analysis, and an MCP surface your agent can call.

New to Servonaut?

Start with the Quick Start guide — get from zero to managing your first server in under 5 minutes.

Overview

Servonaut is an open-source CLI tool built with Python and Textual. It provides a keyboard-driven, mouse-friendly TUI that unifies AWS EC2, OVH Cloud (Public Cloud / VPS / dedicated), Hetzner Cloud, and arbitrary SSH hosts in one searchable list — with lifecycle controls for supported OVH and Hetzner resources, plus AWS EC2 discovery and observability. Paid tiers add cloud config sync, a hosted MCP server for AI agents like Claude Code, Server Memory — a zero-knowledge inventory + drift timeline — and Servonaut AI, a hosted AI gateway with its own dollar budget so you don't need to wire up your own provider keys.

Documentation sections

Quick Start

Install Servonaut and be up and running in minutes. Covers install, first run, and core operations.

Installation

System requirements, all install methods, upgrading, uninstalling, and optional dependencies.

Configuration

Full reference for ~/.servonaut/config.json — AWS, SSH, AI providers, MCP, secrets handling.

Features

SSH/SCP, AWS / OVH / Hetzner lifecycle, CloudTrail, CloudWatch, WAF management, keyboard shortcuts reference.

Hetzner Cloud

Setup wizard, full Hetzner lifecycle and discovery via MCP, Manager screen, and project SSH key registry.

OVH Cloud

Region-first create wizard with API-backed pricing, Manager screen, project SSH keys, lifecycle, plus OVH read-only inspection via MCP (DNS, IPs, billing, …).

MCP Server

Connect AI agents like Claude Code to your infrastructure. Auto-install, tools, and guard levels.

Server Memory Premium

A zero-knowledge inventory + drift timeline for every server. End-to-end encrypted; the backend only sees safe metadata until you explicitly ask for an AI summary.

Secrets & Integrations Premium

Bring your own Bitwarden vault. The CLI resolves SSH keys and secrets at the moment you need them — pointers on our backend, values stay on your machine.

Teams Teams

Shared server inventory, shared SSH vault, role-based access, per-seat AI budget, full audit trail. Per-seat Stripe billing.

Servonaut AI Premium

Hosted AI gateway with a dollar budget. No API keys to manage; transparent multi-provider failover (Gemini → OpenAI → Anthropic → Ollama).

API Reference Premium

REST API for config sync and team management. OAuth2 device flow authentication.

Quick links

GitHub Repository — source code, issues, and contributions
Pricing — free OSS tier and paid plans
Contact — get support or report an issue

Last verified against CLI v2.12.0

Next Quick Start