AgentUse - Autonomous Agents That Work Without You

System Requirements

Node.js

Version 18.0.0 or higher required

Operating System

macOS, Linux, or Windows with WSL

Installation Methods

Global Installation (Recommended)

pnpm
npm
bun
yarn

pnpm install -g agentuse

# Verify installation
agentuse --version

npm install -g agentuse

# Verify installation
agentuse --version

bun add -g agentuse

# Verify installation
agentuse --version

yarn global add agentuse

# Verify installation
agentuse --version

Run Without Installation

Use pnpx or bunx to run AgentUse without installing:

# Using pnpx
pnpx agentuse@latest run your-agent.agentuse

# Using npx
npx agentuse@latest run your-agent.agentuse

# Using bunx with Bun runtime (faster)
bunx --bun agentuse run your-agent.agentuse

Development Setup

Clone and build from source:

# Clone the repository
git clone https://github.com/agentuse/agentuse.git
cd agentuse

# Enable corepack if pnpm is not available
corepack enable

# Install dependencies with pnpm
pnpm install

# Build the project
pnpm run build

# Link for local development
pnpm link

# Now you can use 'agentuse' command globally
agentuse --version

Authentication Setup

AgentUse supports multiple AI providers. Authenticate using the interactive login:

agentuse auth login

Model Configuration

See the complete authentication guide for OAuth setup, API keys, environment variables, and security best practices.

Verify Installation

Check that everything is working:

Check Version

agentuse --version

Check Authentication

agentuse auth list
# or use the short alias
agentuse auth ls

Run Test Agent

echo '---
name: test
model: anthropic:claude-haiku-4-5
---
Say "Installation successful!"' > test.agentuse

agentuse run test.agentuse

Docker

AgentUse provides an official Docker image with Node.js, Python, and common utilities pre-installed.

Self-Hosting

Run AgentUse in Docker for local development or production deployment.

Troubleshooting

Command not found

If agentuse command is not found after installation:

Check your PATH:

echo $PATH

Find where pnpm installs global packages:

pnpm config get prefix

Add to PATH if needed:

export PATH="$PATH:$(pnpm config get prefix)/bin"

Node version issues

Check your Node.js version:

node --version

If below v18, update Node.js:

Use nvm: nvm install 20
Or download from nodejs.org

Getting Started

Building

Running

Reference

Installation

System Requirements

Node.js

Operating System

Installation Methods

Global Installation (Recommended)

Run Without Installation

Development Setup

Authentication Setup

Model Configuration

Verify Installation

Docker

Self-Hosting

Troubleshooting

​System Requirements

Node.js

Operating System

​Installation Methods

​Global Installation (Recommended)

​Run Without Installation

​Development Setup

​Authentication Setup

Model Configuration

​Verify Installation

​Docker

Self-Hosting

​Troubleshooting

System Requirements

Installation Methods

Global Installation (Recommended)

Run Without Installation

Development Setup

Authentication Setup

Verify Installation

Docker

Troubleshooting