Amplifier Ecosystem¶

Amplifier's modular architecture allows you to mix and match capabilities. This page catalogs all available components — core infrastructure, applications, libraries, bundles, and runtime modules.

Core Infrastructure¶

The foundational kernel that everything builds on.

Applications¶

User-facing applications that compose libraries and modules.

Note: When you install amplifier, you get amplifier-app-cli as the executable application. amplifierd is a separate daemon that exposes Amplifier capabilities over HTTP, and amplifier-chat and amplifier-voice are plugins that extend it with web-based chat and voice interfaces.

Documentation & Learning¶

These are the canonical documentation and learning sites for the Amplifier ecosystem. They reflect the framework but do not run it.

Libraries¶

Foundational libraries used by applications (not used directly by runtime modules).

Architectural Boundary: Libraries are consumed by applications (like amplifier-app-cli). Runtime modules only depend on amplifier-core and never use these libraries directly.

Bundles¶

Composable configuration packages that combine providers, behaviors, agents, and context into reusable units.

Usage: Bundles are loaded via the amplifier bundle commands:

# Add a bundle to the registry (name auto-derived from bundle metadata)
amplifier bundle add git+https://github.com/microsoft/amplifier-bundle-recipes@main

# Use a bundle by name
amplifier bundle use foundation
amplifier bundle use recipes

# Show current bundle
amplifier bundle current

# Check for bundle updates
amplifier bundle update --check

# Update bundle to latest
amplifier bundle update

Runtime Modules¶

Modules are loaded dynamically at runtime based on bundle configuration.

Orchestrators¶

Control the AI agent execution loop.

Providers¶

Connect to AI model providers.

Tools¶

Extend AI capabilities with actions.

Context Managers¶

Manage conversation state and history.

Hooks¶

Extend lifecycle events and observability.

Using Modules¶

In Bundles¶

tools:
  - module: tool-web
    source: git+https://github.com/microsoft/amplifier-module-tool-web@main

Command Line¶

amplifier module add tool-web --source git+https://github.com/microsoft/amplifier-module-tool-web@main
amplifier module list
amplifier module show tool-filesystem

Module Contracts¶

All runtime modules follow the same pattern and implement one of five contract types:

Quick Start Pattern¶

# 1. Implement the Protocol from interfaces.py
class MyModule:
    pass  # implement required methods

# 2. Provide mount() function
async def mount(coordinator, config):
    instance = MyModule(config)
    await coordinator.mount("category", instance, name="my-module")
    return instance

# 3. Register entry point in pyproject.toml
# [project.entry-points."amplifier.modules"]
# my-module = "my_package:mount"

Community Modules¶

Providers¶

Tools¶

Hooks¶

SECURITY WARNING: Community modules execute arbitrary code in your environment with full access to your filesystem, network, and credentials. Only use modules from sources you trust. Review code before installation.