← Back to catalog
Paperclip AI

Paperclip AI

vlatest

AI agent orchestration with Hermes, Claude Code, Codex, Gemini CLI, and OpenCode

Install

$curl -fsSL https://virtua.sh/i/paperclip | bash
No server?Virtua.Cloud →

What's included

  • Paperclip AI -- orchestration platform for AI agent teams
  • Hermes Agent -- 30+ tools, persistent memory, multi-provider (Nous Research)
  • Claude Code -- Anthropic's CLI coding agent
  • OpenAI Codex -- OpenAI's CLI coding agent
  • Gemini CLI -- Google's CLI coding agent
  • OpenCode -- open-source coding agent
  • Caddy -- reverse proxy with auto-HTTPS and basic auth
  • Embedded PostgreSQL -- zero-config database

After install

  • Switch to the paperclip user: su - paperclip
  • Authenticate your agents: claude, codex, gemini, opencode, hermes setup
  • Open the dashboard URL shown at the end of install
  • Create a company and start hiring AI agents

How the install works

Generated from the install script itself -- these are the exact phases it runs on your server.

  1. 1.Pre-flight checks
  2. 2.Configuration
  3. 3.Installing system dependencies
  4. 4.Installing Node.js
  5. 5.Installing pnpm
  6. 6.Installing Caddy
  7. 7.Creating user
  8. 8.Installing Paperclip
  9. 9.Installing Hermes Agent
  10. 10.Installing Claude Code
  11. 11.Installing OpenAI Codex
  12. 12.Installing Gemini CLI
  13. 13.Installing OpenCode
  14. 14.Configuring Caddy
  15. 15.Creating systemd service
  16. 16.Saving credentials
  17. 17.Starting services

Supported Operating Systems

Ubuntu 24Ubuntu 25Debian 12Debian 13Rocky 9Rocky 10Alma 9Alma 10

Requirements

RAM
1GB minimum
Disk
10GB minimum

Configuration

VariableDefaultDescription
PAPERCLIP_HOSTserver hostnameHostname or IP for Caddy reverse proxy. Hostnames get auto-HTTPS via Let's Encrypt.
PAPERCLIP_USERpaperclipUsername for Caddy basic auth
PAPERCLIP_PASSrandom 24-charPassword for Caddy basic auth. Auto-generated if not set.
715 installsOfficial website →

Changelog

v1.0.02026-04-01
  • Initial release with Paperclip AI + Hermes Agent
  • Claude Code, Codex, Gemini CLI, OpenCode included
  • Caddy reverse proxy with basic auth and auto-HTTPS
v1.1.02026-04-02
  • Switched to shared base.sh for improved reliability
  • Public DNS during install (Cloudflare + Google)
  • Firewall auto-configuration (firewalld, ufw, iptables)
  • Stronger passwords (24-char)
  • System update before installing dependencies
v1.1.12026-07-12
  • HTTPS detection no longer silently downgrades to HTTP when dig is missing
  • Reliable Caddy config load (restart instead of enable --now)