Skip to content

Installation Options

Most users should follow the Getting Started guide. This page covers alternative installation methods and troubleshooting.

Alternative Install Methods

Using pipx

If you prefer pipx over uv:

pipx install git+https://github.com/microsoft/amplifier

Development Installation

For contributors or those who want to modify Amplifier:

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

# Install in development mode
uv pip install -e .

Manual Configuration

If you prefer manual setup:

1. Set Your API Key

export ANTHROPIC_API_KEY="your-api-key"

export OPENAI_API_KEY="your-api-key"

export AZURE_OPENAI_API_KEY="your-api-key"
export AZURE_OPENAI_ENDPOINT="https://your-resource.openai.azure.com"

# Ollama runs locally, no API key needed
# Just ensure Ollama is running: ollama serve

2. Select Your Provider

amplifier provider use anthropic  # or openai, azure, ollama

3. Verify Setup

amplifier run "Hello! Are you working?"

Shell Completion

Enable tab completion for your shell:

amplifier --install-completion

Supports bash, zsh, fish, and PowerShell.

Updating

Update to the latest version:

amplifier update

Or reinstall:

uv tool install --force git+https://github.com/microsoft/amplifier

Troubleshooting

"Command not found: amplifier"

Ensure your tool bin directory is in PATH:

# For uv
export PATH="$HOME/.local/bin:$PATH"

# For pipx
export PATH="$HOME/.local/bin:$PATH"

Add this to your shell profile (.bashrc, .zshrc, etc.).

"No API key found"

Make sure your API key environment variable is set:

echo $ANTHROPIC_API_KEY  # Should show your key

Or run amplifier init to configure it.

"Module not found" errors

Try reinstalling with a clean state:

uv tool uninstall amplifier
uv tool install git+https://github.com/microsoft/amplifier

Next Steps