@artale/pi-bux

24/7 Pi or Hermes agent on a VPS. Run your agent continuously, control via Telegram, browse the web.

Package details

← Back
skill

Install @artale/pi-bux from npm and Pi will load the resources declared by the package manifest.

npm repohome report
$ pi install npm:@artale/pi-bux
Package
@artale/pi-bux
Version
1.0.0
Published
May 2, 2026
Downloads
not available
Author
artale
License
MIT
Types
skill
Size
82.4 KB
Dependencies
0 dependencies · 0 peers
Pi manifest JSON
{
  "skills": [
    "bux",
    "server",
    "vps"
  ],
  "image": "https://unpkg.com/@artale/pi-bux@1.0.0/preview.png"
}

Security note

Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.

README

Pi Bux - 24/7 Pi or Hermes Agent

Run Pi or Hermes continuously on any VPS. Control from Telegram. Browse the web.

Inspired by browser-use/bux

Quick Start

Install Pi (default)

curl -fsSL https://raw.githubusercontent.com/artale93/pi-bux/main/install.sh \
  | sudo PI_API_KEY=your_key bash

Install Hermes (self-evolving agent)

curl -fsSL https://raw.githubusercontent.com/artale93/pi-bux/main/install.sh \
  | sudo PI_API_KEY=your_key AGENT=hermes bash

With Telegram bot

curl -fsSL https://raw.githubusercontent.com/artale93/pi-bux/main/install.sh \
  | sudo PI_API_KEY=xxx TELEGRAM_BOT_TOKEN=yyy bash

Choose Your Agent

Agent Description Best For
pi Standard Pi coding agent General coding, debugging
hermes Self-evolving with memory Long-term projects, learning

What You Get

  • ✅ 24/7 uptime via systemd
  • ✅ Telegram control (optional)
  • ✅ Browser harness for web scraping
  • ✅ Persistent state across reboots
  • ✅ $5/month VPS cost

Architecture

┌─────────────────────────────────────────────────┐
│  VPS ($5/mo)                                     │
│  ┌─────────────────────────────────────────────┐  │
│  │ systemd: pi-agent.service OR pi-hermes.service│  │
│  │   └─► pi/hermes run --continuous            │  │
│  └─────────────────────────────────────────────┘  │
│  ┌─────────────────────────────────────────────┐  │
│  │ telegram-bot.service (optional)             │  │
│  │   └─► Messages → Agent commands            │  │
│  └─────────────────────────────────────────────┘  │
└─────────────────────────────────────────────────┘

Requirements

  • Ubuntu 22.04+ VPS (≥2GB RAM)
  • Pi API key
  • Optional: Telegram bot token

Commands

# Check status
systemctl status pi-agent
systemctl status pi-hermes

# View logs
journalctl -u pi-agent -f
journalctl -u pi-hermes -f

# Restart
systemctl restart pi-agent
systemctl restart pi-hermes

# Uninstall
curl -fsSL https://raw.githubusercontent.com/artale93/pi-bux/main/scripts/uninstall.sh | sudo bash

Telegram Bot Commands

  • /start - Welcome
  • /status - Check agent status
  • /memory - Memory usage
  • /uptime - How long running
  • /help - Show commands

Docs