Your cookbook for building AI with Microsoft Foundry.
Forgebook is a curated collection of runnable Jupyter notebook recipes, hands-on guides, and examples for building agents, model inference workflows, and multimodal apps with Microsoft Foundry.
✨ Browse recipes at microsoft-foundry.github.io/forgebook
| Recipe | Description | Tags |
|---|---|---|
| Create Your First Agent (Part 1) | Step-by-step tutorial to deploy gpt-5-mini on Microsoft Foundry, create an AI agent with Web Search, and test it — all from the Foundry portal. Part 1 of 4. | agents |
- Python 3.10+
- Azure account — Create one for free
- Microsoft Foundry resource — Set up Microsoft Foundry
git clone https://github.com/microsoft-foundry/forgebook.git
cd forgebook
pip install -r requirements.txt
jupyter notebookMost notebooks walk you through setting up Azure resources as part of the tutorial. Follow the instructions in each notebook to configure your environment.
Forgebook is currently operating as a curated Microsoft-authored cookbook while the recipe format, content bar, and publishing workflow stabilize. Recipe publishing is focused on approved contributors from Foundry Developer Experience / Developer Marketing and the Foundry product group, including PM and engineering. Broader contribution paths may be added as the cookbook matures.
Approved Microsoft authors should follow the internal authoring workflow, then submit the finished notebook, assets, and metadata here for review.
- Create your notebook in
notebooks/ - Add an entry to
registry.yaml:- slug: my-notebook path: notebooks/my-notebook.ipynb title: "My Awesome Notebook" authors: - github: your-username
- Open a PR — CI validates, builds a live preview, and auto-deploys on merge
See CONTRIBUTING.md for the full authoring guide, content guidelines, and PR checklist.
forgebook/
├── notebooks/ # Jupyter notebooks (source of truth)
│ ├── data/ # Sample datasets
│ └── media/ # Images referenced in notebooks
├── registry.yaml # Notebook metadata for the site
└── site/ # Astro static site
Notebooks are the source of truth — they stay clean and portable with no site-specific metadata baked in. Authors register notebooks in registry.yaml and the site builds automatically.
Recipes cover a range of AI development topics:
agents · multi-agent · inference · knowledge · evaluation · fine-tuning · memory · multimodal · safety · local · tools · models · mai · agent-framework · a2a · langchain · mcp
The Forgebook public site uses standard pseudonymous web telemetry. Microsoft uses these insights only to improve Forgebook content, recipe planning, and site performance. By choosing to use the public site, you consent to this telemetry.
See CONTRIBUTING.md for the current authoring workflow and review checklist.
This project follows the Microsoft Open Source Code of Conduct. For support options, see SUPPORT.md. To report security vulnerabilities, see SECURITY.md.