Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
25 changes: 25 additions & 0 deletions docs/community/index.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,25 @@
---
icon: material/account-group
---

# Community

The AI Catalog specification is developed openly under the Linux Foundation's Agent Card Working Group. Everyone is welcome to participate.

## Chat

Join the conversation on Discord — ask questions, share feedback, and connect with other implementers and contributors.

[:fontawesome-brands-discord: Join the AI Catalog Discord](https://discord.gg/wh4XQQG4tt){ .md-button }

## Community Meetings

The working group holds regular community meetings open to all. Come discuss the spec roadmap, raise issues, and meet the contributors.

[:octicons-video-16: Join the Community Meeting](https://zoom-lfx.platform.linuxfoundation.org/meeting/91656063701?password=946db53a-d3d4-4dd2-a8d5-5ed46ae035d3){ .md-button }

## Contributing

The specification and all tooling live on GitHub. Contributions of all kinds are welcome — bug reports, spec proposals, documentation improvements, and code.

[:fontawesome-brands-github: Agent-Card/ai-catalog on GitHub](https://github.com/Agent-Card/ai-catalog){ .md-button }
11 changes: 11 additions & 0 deletions docs/examples/index.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,11 @@
---
icon: material/code-json
---

# Examples

Annotated catalog documents illustrating common patterns and conformance levels.

- [Minimal Catalog](minimal-catalog.md) — the simplest valid catalog (Level 1 conformance)
- [Multi-Protocol Agent](multi-protocol-agent.md) — a single agent entry spanning MCP and A2A
- [Nested Catalogs](nested-catalogs.md) — enterprise-scale organisation with hierarchical sub-catalogs
4 changes: 4 additions & 0 deletions docs/getting-started.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,7 @@
---
icon: material/rocket-launch
---

# Getting Started

This guide gets a working AI Catalog live in about 5 minutes.
Expand Down
13 changes: 13 additions & 0 deletions docs/guides/index.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,13 @@
---
icon: material/book-open-variant
---

# Guides

Step-by-step guides for working with AI Catalog as an author, publisher, or consumer.

- [Creating a Catalog](creating-a-catalog.md) — author a well-formed catalog from scratch
- [Organizing Catalogs](organizing-catalogs.md) — use nesting and federation for large inventories
- [Consuming Catalogs](consuming-catalogs.md) — discover, fetch, and process catalogs as a client
- [Serving Your Catalog](serving-your-catalog.md) — distribution models and hosting options
- [Adding Trust](adding-trust.md) — verifiable identity and compliance attestations via the Trust Manifest
17 changes: 16 additions & 1 deletion docs/implementations.md
Original file line number Diff line number Diff line change
@@ -1,8 +1,23 @@
---
icon: material/code-braces
---

# Implementations

This page lists various implementations and testbeds for the AI Catalog specification.
This page lists implementations and tooling for the AI Catalog specification.

## Official

These implementations are maintained by the Agent Card Working Group or its member organisations.

- [spec-works/ai-catalog](https://github.com/spec-works/ai-catalog) (C#, Python)
- [ai-catalog-go-sdk](https://github.com/agntcy/ai-catalog-go-sdk/) (Go)
- [ai-catalog-rust](https://github.com/agntcy/ai-catalog-rust) (Rust)
- [AI Catalog](https://ai-catalog.outshift.io/) (testbed service)

## Community Projects

Community-built tools, libraries, and integrations. Listed here to help discovery — not formally endorsed by the working group.

!!! tip "Add your project"
Have an implementation to share? Open a pull request to add it here.
4 changes: 4 additions & 0 deletions docs/index.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,7 @@
---
icon: material/home
---

# AI Catalog

**A JSON format for making all your AI artifacts discoverable.**
Expand Down
4 changes: 4 additions & 0 deletions docs/specification.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,7 @@
---
icon: material/file-document
---

# Full Specification

The AI Catalog specification is published as a W3C-style normative document.
Expand Down
8 changes: 7 additions & 1 deletion mkdocs.yml
Original file line number Diff line number Diff line change
Expand Up @@ -33,10 +33,11 @@ theme:
- navigation.instant
- navigation.instant.prefetch
- navigation.tracking
- navigation.sections
- navigation.expand
- navigation.top
- navigation.footer
- navigation.indexes
- navigation.sections
- search.suggest
- search.highlight
- content.code.copy
Expand Down Expand Up @@ -75,21 +76,26 @@ extra:
social:
- icon: fontawesome/brands/github
link: https://github.com/Agent-Card/ai-catalog
- icon: fontawesome/brands/discord
link: https://discord.gg/wh4XQQG4tt

nav:
- Home: index.md
- Specification: specification.md
- Getting Started: getting-started.md
- Guides:
- guides/index.md
- Creating a Catalog: guides/creating-a-catalog.md
- Organizing Catalogs: guides/organizing-catalogs.md
- Consuming Catalogs: guides/consuming-catalogs.md
- Serving Your Catalog: guides/serving-your-catalog.md
- Adding Trust: guides/adding-trust.md
- Examples:
- examples/index.md
- Minimal Catalog: examples/minimal-catalog.md
- Multi-Protocol Agent: examples/multi-protocol-agent.md
- Nested Catalogs: examples/nested-catalogs.md
- Implementations: implementations.md
- Community: community/index.md