https://github.com/inference-gateway/registry
A registry website for hosting the a2a agents that were built using the Inference Gateway ADK
https://github.com/inference-gateway/registry
a2a a2a-protocol agents container-as-a-service containers enterprise enterprise-ready oci registry
Last synced: 25 days ago
JSON representation
A registry website for hosting the a2a agents that were built using the Inference Gateway ADK
- Host: GitHub
- URL: https://github.com/inference-gateway/registry
- Owner: inference-gateway
- Created: 2025-07-23T21:27:14.000Z (11 months ago)
- Default Branch: main
- Last Pushed: 2026-05-21T15:30:56.000Z (29 days ago)
- Last Synced: 2026-05-21T17:13:15.869Z (29 days ago)
- Topics: a2a, a2a-protocol, agents, container-as-a-service, containers, enterprise, enterprise-ready, oci, registry
- Language: TypeScript
- Homepage: http://registry.inference-gateway.com/
- Size: 4.28 MB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Codeowners: .github/CODEOWNERS
Awesome Lists containing this project
- awesome-a2a - Registry - 2.0` - Web registry for hosting and discovering A2A agents built with the Inference Gateway ADK family. (🛠️ Tools & Libraries / 📦 Registries, Catalogs & Schemas)
README
# Inference Gateway Registry
[](https://github.com/inference-gateway/registry/actions/workflows/static.yml)
[](https://github.com/inference-gateway/registry/actions/workflows/ci.yml)
[](https://www.apache.org/licenses/LICENSE-2.0)
[](https://vitepress.dev/)
[](https://vuejs.org/)
Discovery hub for A2A (Agent-to-Agent) services and portable skills in the
inference-gateway ecosystem. Every entry follows the
[Agent Definition Language](https://adl.inference-gateway.com/) schema.
## Overview
The registry is a static documentation site that lists ADL-compliant agents and
portable skills. Both catalogs are fetched at runtime from sibling repos via
jsDelivr, so adding or updating an entry doesn't require redeploying this site:
- **Agents catalog**: [`inference-gateway/agents`](https://github.com/inference-gateway/agents)
-> `https://cdn.jsdelivr.net/gh/inference-gateway/agents@main/catalog.json`
- **Skills catalog**: [`inference-gateway/skills`](https://github.com/inference-gateway/skills)
-> `https://cdn.jsdelivr.net/gh/inference-gateway/skills@main/catalog.json`
Override the catalog URLs locally with `VITE_AGENTS_CATALOG_URL` /
`VITE_SKILLS_CATALOG_URL` (the Vite env vars exposed by VitePress).
## Tech stack
- [VitePress](https://vitepress.dev/) 1.6 for the static site
- [Vue 3](https://vuejs.org/) Composition API for the dynamic Agents and Skills browsers
- Plain Markdown for the landing page and How-To guides
- Deployed to [GitHub Pages](https://registry.inference-gateway.com) on push to `main`
The look and feel matches the
[ADL docs site](https://adl.inference-gateway.com/) (teal `#3c8772`, Inter,
light/dark toggle).
## Quick start
```sh
# All commands run from the docs/ workspace
cd docs
# Install dependencies (requires Node ^24.15.0)
npm install
# Start the dev server with HMR
npm run dev
# Build the static site into docs/.vitepress/dist
npm run build
# Serve the production build locally
npm run preview
```
A `Taskfile.yml` at the repo root wraps the same commands (`task dev`,
`task build`, `task preview`, `task install`, `task lint`, `task generate`,
`task format`, `task format:check`).
## Project layout
```text
docs/
├── index.md # Landing page (hero + features)
├── agents/index.md # Embeds
├── skills/index.md # Embeds
├── how-to/ # Six markdown how-to guides
├── public/ # Favicons, OG images, CNAME, robots.txt
├── scripts/codegen-adl.mjs # Regenerates the ADL TypeScript types
└── .vitepress/
├── config.ts # Nav, sidebar, theme color, head meta
├── theme/{index.ts,custom.css}
├── components/ # AgentsBrowser, SkillsBrowser, AgentCard, SkillCard
├── lib/ # agentService, skillService, adl, types
└── types/adl.ts # Generated from the upstream ADL JSON Schema
```
## Adding new agents
Agent metadata is **not** in this repo. Any public GitHub repo that ships an
ADL `agent.yaml` at its root is eligible. Open a PR against
[`inference-gateway/agents`](https://github.com/inference-gateway/agents)
adding one entry to `agents.yaml` with the repo URL and an optional `ref`.
CI in the agents repo rebuilds `catalog.json` on merge; the new agent appears
on this site within the jsDelivr `@main` cache window (up to ~12h) with no
redeploy here.
To submit a new **skill**, open a PR against `inference-gateway/skills`.
The ADL schema itself lives in [`inference-gateway/adl`](https://github.com/inference-gateway/adl).
Schema changes require running `npm run codegen` inside `docs/` here to refresh
`docs/.vitepress/types/adl.ts`.
## Contributing
1. Fork the repository
2. Create a feature branch
3. Make your changes inside `docs/`
4. Run `npm run build` to confirm it still builds
5. Open a pull request
## License
Apache 2.0 - see [LICENSE](./LICENSE).