Microsoft Foundry DevTools

https://github.com/user-attachments/assets/66a5dd71-5bc6-4c6b-a4db-5676e364c74f

Your idea. Your workflow. Build with Foundry.

Build AI applications and agents with Microsoft Foundry, from your first local experiment to a deployed agent. Choose tools for your terminal, coding agent, VS Code, or a guided visual workflow.

This repository is your starting point for Foundry developer tools, documentation, and community feedback. It also hosts the source code for Foundry Canvas.

🧰 Choose your tools

Start with the workflow that fits how you work. These tools work together, so you can move between your terminal, coding agent, and visual tools as your project grows.

Tool	What you can do	Explore	Release notes
⌨️ Azure Developer CLI (azd)	Use azd and its Foundry extensions (azd ai) to scaffold, deploy, evaluate, and automate AI applications and agents from the terminal.	Repository and quick start	Release notes
🧠 Foundry Skills	Give your coding agent reusable guidance for Foundry development. The Microsoft Foundry Skill helps it build, deploy, and manage agents and models with azd.	Skill guide	Release notes
💻 Foundry Toolkit for VS Code	Discover models, build and test agents, evaluate results, and manage Foundry resources without leaving VS Code. Formerly AI Toolkit.	Toolkit documentation	Release notes
🎨 Foundry Canvas (preview)	Design, configure, test, and deploy hosted agents from a guided side panel in GitHub Copilot App, with Copilot making the code changes.	Canvas overview	Release notes

🚀 Get started

Follow Prepare your development environment for prerequisites and setup on Windows, macOS, or Linux. Foundry DevPack is the recommended way to install the developer tools together. The guide also covers installing each tool separately.

DevPack adds the Toolkit and Canvas extensions only when their host apps are present. It does not install VS Code or GitHub Copilot App. See the DevPack installer releases for version history.

Your starting point	Next step
Terminal	Install azd and the Foundry extensions.
Coding agent	Install the Microsoft Foundry Skill for your coding-agent host.
VS Code	Install Foundry Toolkit, then follow the Toolkit setup guide.
GitHub Copilot App	Open the Customize tab, select Plugin, search for microsoft-foundry, and install it from the awesome-copilot marketplace. Follow the Canvas guide to build your first hosted agent.

🛠️ Source code and contributions

The tools have different source-code homes. This repository does not contain the implementation of every tool listed above.

Tool	Source code
azd	Developed in Azure/azure-dev. See its contributing guide.
Foundry Skills	Developed in microsoft/GitHub-Copilot-for-Azure. Browse the Microsoft Foundry Skill source and contributing guide.
Foundry Toolkit for VS Code	Not open source. Its implementation is not in this repository, but we welcome Toolkit issues and feature requests here.
Foundry Canvas	Source code is in microsoft-foundry/ in this repository. See its README for installation and usage.

We welcome contributions to the source and documentation available in these repositories. Follow the contribution guidance in the repository you want to change. For contributions here, see the Code of Conduct. Source code in this repository is covered by its license; the closed-source Toolkit implementation is not included.

💬 Join the conversation

Talk with the developers building these tools. Share what you are working on, ask questions, discuss ideas, and help us improve the experience. You do not need to contribute code to take part. Whether you have a first experiment, a feature idea, or a bug to report, you are welcome here.

Tool	Questions and ideas	Bugs and feature requests
azd	Discussions	Issues
Foundry Skills	Discussions	Issues
Foundry Toolkit for VS Code	Start or join an issue conversation	Issues
Foundry Canvas	Start or join an issue conversation	Issues

Search existing discussions and issues first. When you report a bug, include the tool name, version, operating system, steps to reproduce, and expected behavior. Remove secrets and personal data from logs and screenshots.

For security vulnerabilities, follow our security reporting policy instead of opening a public issue.

📚 Documentation and updates

• Foundry development environment: prerequisites and installation.
• Foundry Toolkit documentation and tutorials: detailed features and walkthroughs.
• Foundry Canvas documentation: the guided hosted-agent workflow.
• Microsoft Foundry Discord community: connect with other developers.

For private Foundry Toolkit bug reports or support concerns, contact vscai-support@microsoft.com. Report security vulnerabilities through the security policy linked above.

Foundry Toolkit data and telemetry

Microsoft Foundry Toolkit for Visual Studio Code collects usage data and sends it to Microsoft to help improve our products and services. Read our privacy statement to learn more. This extension respects the telemetry.enableTelemetry setting—learn more at disable telemetry reporting.