Agent-Matrix is a community and enterprise hub for production-ready AI agents, tools, and MCP servers. It brings together curated AI capabilities that integrate natively with:

• MCP Gateway for centralized registration, discovery, and governance.
• IBM watsonx Orchestrate via ready-to-import skills (e.g., skill.yaml).
• The agent-generator toolchain, enabling reuse-first development and rapid composition.

Every asset here is built or described with open manifest standards and is designed to be observable, governable, and easy to operate across teams and environments.

Turn custom Python logic and third-party services into manageable, observable, and orchestratable enterprise AI skills—with a frictionless path from prototype to production.

• Matrix Hub — a central, PyPI-like catalog and install service (FastAPI). Search agents/tools/MCP servers, compute install plans, and register them with MCP Gateway automatically.

• Catalog (manifests) — the community-curated index of agents, tools, and MCP servers (versioned, PR-friendly).

• CLI & SDK — a simple matrix CLI and matrix-python-sdk for programmatic search, show, install.

• agent-generator integration — a plugin that makes planning reuse-first; generate only when nothing suitable exists.

• Enterprise-ready agents with:

  • A standard FastAPI /invoke (where applicable).
  • Optional skill.yaml for watsonx Orchestrate import.
  • Container images and/or Python packages for easy deployment.

• Tools & MCP servers described by clear, versioned manifests.

• Reference infrastructure (Docker Compose / Helm) to run Matrix Hub alongside MCP Gateway.

All repositories live under github.com/agent-matrix.

• Matrix Hub (service) — matrix-hub Central catalog API + installer + ingestor. Publishes Docker images.

• Python SDK — matrix-python-sdk Lightweight client for Matrix Hub API.

• CLI — matrix-cli Developer CLI (matrix search, matrix install, etc.).

• Agent-generator plugin — agent-generator-matrix Reuse-first planning for agent-generator with adapters/templates.

• Catalog (manifests) — catalog PR-friendly repository of agents/, tools/, and mcp-servers/ manifests with an index.json.

• Infra — infra Dev/prod ops assets (Docker Compose, Helm charts).

Some repositories may be created or promoted over time as the ecosystem grows.

1. Authoring Build or wrap logic as an agent/tool/MCP server; add a manifest to the catalog (via PR).

2. Ingestion Matrix Hub periodically pulls index.json and manifests, validates them, and updates the catalog.

3. Discovery Developers run:

   matrix search "summarize pdfs" --type agent

   or call the SDK from apps, planners, or CI.

4. Install & Register

   matrix install agent:pdf-summarizer@1.4.2 --target ./apps/pdf-bot

   Matrix Hub executes the plan (pip/uv, docker, git), writes adapters, and registers with MCP Gateway.

5. Operate Your flows invoke registered tools/servers; MCP Gateway provides central visibility and policy.

Run the platform (dev):

# In agent-matrix/infra
docker compose -f docker-compose.dev.yaml up -d

Install the CLI (local):

pipx install matrix-cli
# or
pip install matrix-cli

Search, show, install:

matrix search "summarize pdfs" --type agent
matrix show agent:pdf-summarizer
matrix install agent:pdf-summarizer@1.4.2 --target ./apps/pdf-bot

Integrate with agent-generator:

pip install agent-generator-matrix
# planning_agent.py will consult Matrix Hub first (reuse-first)

Typical agent repository includes:

• FastAPI server exposing /invoke (where applicable).
• Orchestrate skill descriptor (skill.yaml) for direct import.
• Containerization (Dockerfile) and/or PyPI packaging.
• Documentation (README.md) with run/import/operate steps.
• Configuration (.env.template, templates, adapter glue).

• Open manifest schemas with CI validation.
• License policy (allowlist/denylist) and optional signature/SBOM checks.
• Auditability via MCP Gateway registration history and Matrix Hub logs.
• RBAC & tenancy planned; follow repo roadmaps for details.

• Enterprise-focused — solve real problems with reliability and scale in mind.
• Seamless integration — first-class with MCP Gateway and watsonx Orchestrate.
• Production-ready — observable, containerized, governed.
• Open & extensible — manifests, adapters, and templates encourage forking and reuse.

We welcome contributions across the stack:

• Catalog additions — submit manifests via PRs to the catalog repo.
• Matrix Hub / CLI / SDK / Infra — open issues and PRs in the respective repositories.
• Generator templates & flows — contribute to agent-generator to improve the entire ecosystem.

Please follow repository-specific CONTRIBUTING guidelines and coding standards.

All Agent-Matrix projects are released under the Apache 2.0 License unless noted otherwise. Individual agents/tools may include third-party dependencies with their own licenses—see each repository for details.

• Issues — use the issue tracker of the relevant repository.
• Discussions — GitHub Discussions (where enabled) for Q&A and proposals.
• Security — report vulnerabilities privately via repository security policy (SECURITY.md) if available.

Agent-Matrix builds on open standards and tooling, with special thanks to the agent-generator project and the broader OSS community driving MCP and orchestration ecosystems forward.