Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.pylon.to/llms.txt

Use this file to discover all available pages before exploring further.

Pylon ships as a single self-contained binary for Linux and macOS. There is no package manager dependency or runtime to install beyond Docker. This page covers prerequisites, the install command, shell completion, and how to upgrade.

​
Prerequisites

You need the following before installing Pylon:
  • Linux or macOS — amd64 or arm64. See the macOS note below for a limitation with Claude OAuth.
  • Docker — Pylon runs every AI agent inside an isolated Docker container. Install Docker Engine from docs.docker.com/engine/install, then verify it is running: 
    docker version
  • A Telegram bot or Slack app — Pylon posts notifications and agent results to a chat channel. You’ll configure this during pylon setup:
    • Telegram: create a bot via @BotFather and have your bot token ready.
    • Slack: create a Slack app with Socket Mode enabled. pylon setup prints the exact app manifest to paste.

​
Install

Download and install the binary with curl: 
curl -fsSL https://pylon.to/install.sh | sh
The install script detects your CPU architecture, downloads the matching binary from GitHub Releases, and places it at /usr/local/bin/pylon.

​
Verify

Confirm the installation succeeded: 
pylon version
You should see output like pylon 0.3.1. If the command is not found, check that /usr/local/bin is on your PATH.

​
Shell completion

Pylon can generate tab-completion scripts for Bash, Zsh, and Fish. Add the appropriate line to your shell profile: 
eval "$(pylon completion bash)"
After editing your profile, reload it: 
source ~/.bashrc   # or ~/.zshrc, depending on your shell
Tab completion lets you press <Tab> to complete pylon names in commands like pylon start <Tab> and pylon test <Tab>.

​
Upgrade

To upgrade Pylon to the latest release, run: 
pylon upgrade
pylon upgrade downloads the latest binary for your architecture from GitHub Releases, verifies it runs correctly, then atomically replaces the current binary. It also rebuilds the agent Docker images embedded in the new release. If Pylon is running under systemd, pylon upgrade restarts the daemon automatically.
If the binary is installed in a system directory, you may need to run sudo pylon upgrade.

​
macOS

Pylon works on macOS with one limitation: OAuth authentication is not supported. On macOS, applications store credentials in the system Keychain, which cannot be mounted into Docker containers. Use API key authentication instead — pylon setup will detect macOS and guide you automatically.

​
Next steps

With Pylon installed, run the interactive setup wizard to connect your chat channel and choose your AI agent:

Quick start

Configure Pylon and trigger your first agent run in five minutes.