Skip to content

Installation

Devo CLI can be installed as a standalone binary (recommended) or from source for development.

No Python installation required. Download and run the installer:

curl -fsSL https://devo.heyedu.dev/install.sh | bash

The installer will:

  1. Detect your platform (Linux/macOS, architecture)
  2. Download the latest binary
  3. Install to /usr/local/bin (system-wide) or ~/.local/bin (user-only)
  4. Verify installation

Open PowerShell and run:

irm https://devo.heyedu.dev/install.ps1 | iex

The installer will:

  1. Download the latest Windows binary
  2. Install to C:\Program Files\devo or user directory
  3. Add to PATH automatically
  4. Verify installation

Note

If you get an execution policy error, run:

Set-ExecutionPolicy -Scope CurrentUser RemoteSigned

Manual Binary Installation

Download the binary for your platform from GitHub Releases:

# Download
curl -L https://github.com/edu526/devo-cli/releases/latest/download/devo-linux-amd64 -o devo

# Make executable
chmod +x devo

# Move to PATH
sudo mv devo /usr/local/bin/
# or for user-only:
mkdir -p ~/.local/bin && mv devo ~/.local/bin/

# Download and extract
curl -L https://github.com/edu526/devo-cli/releases/latest/download/devo-darwin-amd64.tar.gz -o devo.tar.gz
tar -xzf devo.tar.gz

# Move to PATH (moves the entire directory)
sudo mv devo-darwin-amd64 /usr/local/bin/devo-app
sudo ln -s /usr/local/bin/devo-app/devo /usr/local/bin/devo

# Or for user-only installation:
mkdir -p ~/.local/bin
mv devo-darwin-amd64 ~/.local/bin/devo-app
ln -s ~/.local/bin/devo-app/devo ~/.local/bin/devo

# Download and extract
curl -L https://github.com/edu526/devo-cli/releases/latest/download/devo-darwin-arm64.tar.gz -o devo.tar.gz
tar -xzf devo.tar.gz

# Move to PATH (moves the entire directory)
sudo mv devo-darwin-arm64 /usr/local/bin/devo-app
sudo ln -s /usr/local/bin/devo-app/devo /usr/local/bin/devo

# Or for user-only installation:
mkdir -p ~/.local/bin
mv devo-darwin-arm64 ~/.local/bin/devo-app
ln -s ~/.local/bin/devo-app/devo ~/.local/bin/devo

Note

macOS binaries are distributed as directories (not single files) for faster startup performance.

  1. Download devo-windows-amd64.exe from releases
  2. Rename to devo.exe
  3. Move to a directory in your PATH (e.g., C:\Program Files\devo\)
  4. Add directory to PATH if needed

Python Package Installation (Development)

For development or if you prefer pip:

# Clone repository
git clone https://github.com/edu526/devo-cli.git
cd devo-cli

# Create virtual environment
python3 -m venv venv

source venv/bin/activate

venv\Scripts\activate

. venv/Scripts/activate

# Install in editable mode
pip install -e .

Verify Installation

# Check version
devo --version

# Show help
devo --help

# Test a command
devo config show

AWS Configuration

Devo CLI requires AWS credentials to use AI features:

# Configure AWS CLI
aws configure

# Or use AWS SSO
aws sso login --profile my-profile

See AWS Setup Guide for detailed instructions.

Shell Completion

Enable tab completion for your shell:

Add to ~/.zshrc:

eval "$(_DEVO_COMPLETE=zsh_source devo)"

Add to ~/.bashrc:

eval "$(_DEVO_COMPLETE=bash_source devo)"

Add to ~/.config/fish/config.fish:

_DEVO_COMPLETE=fish_source devo | source

See Shell Completion Guide for more details.

Updating

Update to the latest version:

devo upgrade

Uninstallation

Binary Installation

sudo rm /usr/local/bin/devo
# or for user-only installation:
rm ~/.local/bin/devo
  1. Remove from C:\Program Files\devo or user directory
  2. Remove the directory from PATH in System Properties

Python Installation

pip uninstall devo-cli

Troubleshooting

See Troubleshooting Guide for common issues.

Command Not Found

After installation, restart your terminal or run:

source ~/.bashrc  # or ~/.zshrc

Restart PowerShell or open a new terminal window.

Permission Denied

chmod +x /path/to/devo

Right-click the terminal and select Run as administrator.

AWS Credentials

# Verify AWS credentials
aws sts get-caller-identity

# Configure if needed
aws configure

Next Steps