User Installer x64 Arm64

A self-contained Windows app - no SDK, no cloud setup. Current release: v0.15.5. macOS and Linux are not supported yet. Windows x64 and Windows ARM64 installers are available today. 🛠️ Install guide - setup, verification, and upgrade steps.

Previous release — this repo keeps only the current and the immediately preceding version available for download.

Welcome to the Microsoft Discovery community — the public home for the Discovery platform, where users, partners, and the product team build together. Share what you've built, ask questions, file bugs, suggest ideas, and see what other Discovery users are doing across disciplines.

Microsoft Discovery is an extensible platform that brings together agentic orchestration, advanced reasoning, a graph-based knowledge foundation, and high-performance computing for accelerating scientific research and R&D workflows.

Microsoft Discovery is offered in two complementary experiences: an enterprise-grade platform powered by Azure, and a local app with select features and capabilities. The two share the same core concepts and features.

In addition, this repository hosts the public Discovery Catalog — the canonical metadata catalog of AI research agents and starter kits contributed by Microsoft and ecosystem partners. Agent code, container images, and model weights live in each contributor's own infrastructure; the metadata and documentation that describe them live here, where they are PR-reviewed, schema-validated, and surfaced to every Discovery user.

The canonical conceptual reference for both the app and the services is Microsoft Discovery on Microsoft Learn. The starting points most users want:

• Microsoft Discovery & the Microsoft Discovery app - detailed comparison of Discovery experiences
• Discovery Agent concepts — what an agent is and how it's invoked
• Discovery Engine overview — the cognition layer
• Bookshelf and Knowledge Bases — how indexing and retrieval work
• Tasks and investigations — the task-graph model

For an app-specific 15-minute hands-on tour, see docs/discovery-app/quickstart.md.

The Microsoft Discovery app is a self-contained Windows application — no SDK, no cloud setup, no IT ticket. Download the latest release installer and follow the Quickstart guide to get started.

Have feedback? See docs/discovery-app/feedback.md.

• Agents: open the agents/ directory — each folder is one agent with its own README.md.
• Starter kits: open the starter-kits/ directory — each folder contains a single kit.json describing the bundled agents, sample prompts, and risk profile.
• Programmatic access: the same content is exposed as a single aggregated JSON in .auto-registry/agent-registry.json and .auto-registry/starter-kit-registry.json, regenerated automatically on every merge.

All contributions — from Microsoft engineers and external partners — arrive via pull request from a fork. Direct pushes to main are not permitted.

The full contributor contract is in CONTRIBUTING.md. Every PR runs through an automated review that validates structure, schemas, policy, documentation, and secrets — failures are reported inline with rule IDs and remediation hints.

# Fork microsoft/discovery on GitHub, then:
git clone https://github.com/<your-alias>/discovery.git
cd discovery
git remote add upstream https://github.com/microsoft/discovery.git

# Create a branch and add your agent (or starter-kit) folder
git checkout -b add-my-agent
mkdir agents/my-agent
# … author metadata.yaml, agent.yaml, README.md (see authoring guide)

# Push and open a PR targeting upstream/main
git push origin add-my-agent

Everything community-facing goes to Discussions, posted in the matching category:

• Questions / how-to → Q&A
• Bugs → Bugs (the Bug template prompts you for version, repro steps, logs)
• Ideas → Ideas
• Show what you've built → Show and tell

For security-sensitive reports, follow SECURITY.md — do not open a public Discussion or issue for vulnerabilities.

discovery/
├── agents/
│   └── <agent-name>/                         ← flat catalog: one folder per agent
│       ├── metadata.yaml                     ← Discovery catalog contract (required)
│       ├── agent.yaml                        ← Prompt-agent definition (required)
│       ├── README.md                         ← Agent documentation (required)
│       └── tools/<tool-name>/                ← Discovery-managed tools (optional)
│           ├── tool.yaml
│           └── Dockerfile
├── starter-kits/
│   └── <kit-name>/                           ← flat catalog: one folder per kit
│       └── kit.json                          ← Starter-kit manifest (required, the only file allowed in the folder)
├── .auto-registry/                           ← Auto-generated catalog registries; do not edit by hand
│   ├── agent-registry.json                   ← Aggregated agent metadata from agents/*/
│   └── starter-kit-registry.json             ← Aggregated starter-kit metadata from starter-kits/*/
├── docs/
│   ├── discovery-app/                        ← End-user docs for the Discovery app
│   │   ├── install.md
│   │   ├── quickstart.md
│   │   └── feedback.md
│   ├── discovery-services/                   ← Pointer to Microsoft Learn (services live there)
│   ├── authoring-guides/                     ← How to author and submit catalog content
│   │   ├── agent-authoring-guide.md
│   │   └── starter-kit-authoring-guide.md
│   └── schemas/                              ← Canonical JSON schemas (*-schema.json)
├── utilities/                                ← Operator PowerShell scripts for Discovery services (resource-provider registration, RBAC, data-asset migration)
├── .github/
│   ├── skills/                               ← Copilot skills (auto-discovered)
│   │   ├── discovery-catalog/                ← Read-only catalog inventory
│   │   ├── discovery-services-agent-deployer/          ← Agent deployment to Microsoft Foundry
│   │   ├── discovery-services-starter-kit-deployer/    ← Starter-kit deployment to Microsoft Foundry
│   │   └── README.md                         ← Skill documentation
│   ├── DISCUSSION_TEMPLATE/                  ← Templates for Bugs / Ideas / Q&A / Show-and-tell
│   ├── workflows/                            ← Automated PR validation and registry pipelines
│   ├── scripts/                              ← Python validation and registry-builder scripts
│   ├── CODEOWNERS                            ← Maintainer assignments
│   └── pull_request_template.md
└── .vscode/                                  ← Editor settings: wires JSON Schemas to YAML/JSON files; recommends Copilot, PowerShell, Python, YAML, and markdownlint extensions

The catalog uses a flat layout — there is no Microsoft-versus-partner folder split. The optional party field inside metadata.yaml and kit.json (1p for Microsoft-authored, 3p for partner-contributed) drives PR labels and surfacing; it is not encoded in the folder path.

This project follows the Microsoft Open Source Code of Conduct. To report a security vulnerability, see SECURITY.md.

Trademarks — this project may contain trademarks or logos for projects, products, or services. Authorized use of Microsoft trademarks or logos is subject to and must follow Microsoft's Trademark & Brand Guidelines. Use of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship. Any use of third-party trademarks or logos is subject to those third parties' policies.

Third-party agent entries in the catalog are governed solely by each partner's own terms — see the individual agent README.md for details.