The Bot Framework Emulator is a desktop application that allows bot developers to test and debug bots built using the Bot Framework SDK. You can use the Bot Framework Emulator to test bots running either locally on your machine or connect to bots running remotely through a tunnel.

This repo is part the Microsoft Bot Framework - a comprehensive framework for building enterprise-grade conversational AI experiences.

• Download the Bot Framework V4 Emulator for your platform from the GitHub releases page.

• Windows

• OS X

• Linux

  Note for Linux users:

  The Emulator leverages a library that uses libsecret so you may need to install it before running npm install.

  Depending on your distribution, you will need to run the following command:

  Debian/Ubuntu: sudo apt-get install libsecret-1-dev

  Red Hat-based: sudo yum install libsecret-devel

  Arch Linux: sudo pacman -S libsecret

Checkout the Wiki for docs.

• File a bug or suggestion in GitHub Issues
• Ask a question on Stack Overflow

• Microsoft Bot Framework
• Bot Framework SDK
• Bot Framework Tools
• Bot Framework Web Chat

Nightly builds are generated using the latest code. Therefore, they may not be stable, and most likely lack up to date documentation. These builds are better suited for more experienced users, although everyone is welcome to use them and provide feedback. Nightly builds of the V4 Emulator are available here.

This project welcomes contributions and suggestions. Most contributions require you to agree to a Contributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us the rights to use your contribution. For details, visit https://cla.microsoft.com.

When you submit a pull request, a CLA-bot will automatically determine whether you need to provide a CLA and decorate the PR appropriately (e.g., label, comment). Simply follow the instructions provided by the bot. You will only need to do this once across all repos using our CLA.

This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact [email protected] with any additional questions or comments.

Security issues and bugs should be reported privately, via email, to the Microsoft Security Response Center (MSRC) at [email protected]. You should receive a response within 24 hours. If for some reason you do not, please follow up via email to ensure we received your original message. Further information, including the MSRC PGP key, can be found in the Security TechCenter.

Copyright (c) Microsoft Corporation. All rights reserved.