Skip to main content
The Ascii Agent Server allows you to run AI agents on your own cloud VMs or local machines. The agent server comes with a CLI that makes installation and management straightforward.
Your machine must be publicly accessible and reachable over the internet.
The easiest way to install the agent server is through the Ascii app:
  1. Open the Ascii app
  2. Click the top-left menu
  3. Go to Custom Machines
  4. Click Add
This generates a dynamic one-liner installation script that’s valid for 60 minutes. The script automatically installs everything and connects to your Ascii account.
Adding a custom machine

​
Install and Connect via CLI

Alternatively, you can install the CLI manually. The Ascii Agent Server is managed through the Ascii CLI. Install the CLI first: 
curl -fsSL https://github.com/ariana-dot-dev/agent-server/releases/latest/download/install-cli.sh | sudo bash
What this does:
  1. Detects your platform (Linux/macOS) and architecture (x64/ARM64)
  2. Downloads the appropriate CLI binary from GitHub releases
  3. Installs it to /usr/local/bin/one
  4. Makes it executable and verifies the installation
After installation, you’ll have access to the one command for managing your agent server.
Some one commands may require sudo access to manage system services and install dependencies.

​
Post-Installation

​
Connect to Ascii

After installing the CLI, connect your machine to your Ascii account using a registration token: 
one connect --token <YOUR_TOKEN>
Get your registration token from the Ascii app: Top-left menu → Custom Machines → Add. This will:
  1. Register your machine with Ascii
  2. Install the agent server
  3. Install required dependencies (Git, GitHub CLI, Node.js, Claude Code CLI)
  4. Start the agent server automatically