HostKit
Open Source · MIT License

Your AI agent runs the server.

HostKit gives AI agents direct control of a Linux VPS through the Model Context Protocol. No Docker. No Kubernetes. Just systemd, nginx, and PostgreSQL — managed by your agent.

Get StartedView on GitHub
pip install hostkit
Why HostKit

The deployment gap

AI agents can write entire applications. But they still can't ship them — until now.

Agents write code. You deploy it.

  • Manual deployment
    Copy code, SSH in, restart services, check logs — all by hand.
  • Context switching
    Agent generates a Dockerfile, you debug it, push to registry, update K8s manifests.
  • Lost momentum
    The agent had a plan. By the time you deploy, the context window is gone.
  • Infrastructure complexity
    Docker + Kubernetes + Helm + Terraform for what should be a Python app on a Linux box.

Agents write code and deploy it.

  • Direct deployment
    Agent runs deploy myapp --install and the app is live in seconds.
  • Service activation
    payments enable myapp — Stripe configured, webhooks set, env vars injected.
  • Self-monitoring
    Agent checks health, reads logs, fixes issues without human intervention.
  • Zero overhead
    No containers, no orchestrators. systemd manages processes. nginx routes traffic. That's it.
How It Works

Three steps to autonomous deployment

Your AI agent talks to your server through MCP. No manual steps required.

1

Your AI Agent

Claude Code, Cursor, Windsurf, or any MCP-compatible agent. It decides what to build and deploy.

Tool Calls
2

MCP Server

A local TypeScript server that translates agent tool calls into SSH commands. Runs on your machine, connects to your VPS.

SSH
3

Your VPS

A standard Linux server running the HostKit CLI. Projects are systemd services. Services are real processes. Everything is auditable.

Architecture

How the pieces connect

A standard architecture. No magic, no abstractions — just SSH, systemd, and nginx.

Your Machine

Claude Code / Agent
↓
MCP Server (TypeScript)
• hostkit_execute
• hostkit_state
• hostkit_deploy
• hostkit_search
• ... 15+ tools
SSH

Your VPS

HostKit CLI (Python)
systemd services
• hostkit-myapp
• hostkit-myapp-auth
• hostkit-myapp-payments
Infrastructure
• nginx (reverse proxy + SSL)
• PostgreSQL
• Redis
• MinIO (S3 storage)
Features

Everything your agent needs

A complete platform for AI-driven server management. Every capability accessible through MCP tools.

Zero-Config Deployment

Push code, agent deploys. Python, Node.js, Next.js, or static sites. No Dockerfile, no build pipeline.

Built-in Services

Auth, payments, SMS, voice, chatbot — enable any service with one command. Pre-configured, ready to use.

PostgreSQL + Redis

Managed databases per project. Automatic backups. Connection strings injected into environment.

Agent Self-Healing

Agents monitor health, read logs, diagnose failures, and fix problems. Cross-project learning means solutions propagate.

Object Storage

S3-compatible storage via MinIO. Per-project buckets with isolated credentials. Public or private.

SSL + Custom Domains

Automatic Let's Encrypt certificates. Add custom domains with one command. Nginx configured automatically.

Full Observability

Health checks, structured logs, resource metrics. Your agent can monitor everything and respond.

Open Source

MIT licensed. Inspect every line. Self-host on any VPS. No vendor lock-in. No phone-home.

Services

One command to enable

Pre-built services your agent can activate instantly. Each one is a real process with a real API.

Auth

OAuth, JWT, magic links, session management

auth enable myapp

Payments

Stripe Connect, subscriptions, webhooks

payments enable myapp

SMS

Twilio integration, send/receive messages

sms enable myapp

Voice

Real-time voice with Deepgram + Cartesia

voice enable myapp

Chatbot

Anthropic/OpenAI powered conversational AI

chatbot enable myapp

Booking

Appointment scheduling and availability

booking enable myapp

Storage

S3-compatible object storage via MinIO

minio enable myapp

Vector/RAG

Embedding search and retrieval

vector enable myapp
See It In Action

From prompt to production

Watch an AI agent deploy a full-stack app with auth and payments in three commands.

Terminal — claude
Quick Start

Up and running in five steps

From zero to AI-managed infrastructure. No prior setup required.

1

Install the CLI

Install the HostKit CLI on your local machine.

pip install hostkit
2

Initialize your VPS

Point HostKit at any Ubuntu/Debian VPS. It installs everything.

hostkit init user@your-server-ip
3

Add the MCP server

The MCP server lets your AI agent talk to HostKit.

npm install -g hostkit-context
4

Configure your agent

Add this to your Claude Code or Cursor settings.

{
  "mcpServers": {
    "hostkit": {
      "command": "hostkit-context",
      "args": ["--host", "your-server-ip"]
    }
  }
}
5

Ask your agent to deploy

That's it. Your agent handles the rest.

"Create a Python web app and deploy it to my server"

Built in the open.

HostKit is MIT licensed. Every line of code is on GitHub. Run it on your own VPS. Fork it. Extend it. It's your infrastructure.

MIT LicenseTypeScript + PythonSelf-Hostable
Star on GitHubRead the Source