amplifier-distro

The complete distribution layer for Amplifier. It handles the install and onboarding experience to get Amplifier working correctly, bundles a curated set of experience apps, and ships a set of optional capabilities users can enable as they go.

Everything in amplifier-distro is built around the AMPLIFIER_HOME_CONTRACT — the shared filesystem spec that lets any interface share sessions, memory, and state.

Install

Prerequisites: git, gh (authenticated), uv (auto-installed if missing)

curl -fsSL https://raw.githubusercontent.com/microsoft/amplifier-distro/main/install.sh | bash

The installer verifies your environment, installs the amp-distro tool, and walks you through provider setup so Amplifier works immediately.

Then start the server:

amp-distro serve

Open http://localhost:8400 to begin.

Experience Apps

Multiple front-ends into the same Amplifier runtime — sessions, memory, and context are shared across all of them.

App	Description
Web Chat	Browser-based chat with full session persistence
Slack	Full Slack bridge via Socket Mode
Voice	WebRTC voice via OpenAI Realtime API
Routines	Scheduled recipe execution

Apps included in amplifier-distro conform to the AMPLIFIER_HOME_CONTRACT. The set will grow over time.

Capabilities

amplifier-distro ships an amplifier-start bundle with a set of conventions and capabilities users can opt into:

Providers — configure any combination:

Provider	Key
Anthropic	ANTHROPIC_API_KEY
OpenAI	OPENAI_API_KEY
Google	GOOGLE_API_KEY
xAI	XAI_API_KEY
Azure OpenAI	AZURE_OPENAI_API_KEY
Ollama	OLLAMA_HOST (local)

Features — opt-in capabilities:

• Persistent memory, planning mode
• Vector search, recipes, content studio, session discovery, routines

The onboarding experience guides setup. Capabilities can be enabled or changed at any time via amp-distro serve.

Developer Install

git clone https://github.com/microsoft/amplifier-distro && cd amplifier-distro
cd distro-server
uv tool install -e .

Commands

amp-distro serve — Start the experience server

amp-distro serve                 # Foreground on http://localhost:8400
amp-distro serve --reload        # Auto-reload for development

amp-distro backup / restore — State backup

amp-distro backup                # Back up ~/.amplifier/ state to GitHub
amp-distro restore               # Restore from backup
amp-distro backup --name my-bak  # Custom backup repo name

Uses a private GitHub repo (created automatically via gh). API keys are never backed up.

amp-distro service — Auto-start on boot

amp-distro service install       # Register systemd/launchd service
amp-distro service uninstall     # Remove the service
amp-distro service status        # Check service status

Docs

File	Description
AMPLIFIER_HOME_CONTRACT.md	Filesystem contract all apps must conform to
distro-server/docs/SLACK_SETUP.md	Slack bridge setup guide

License

MIT — see LICENSE.