Skip to content
Bot Framework Emulator
TypeScript CSS JavaScript Other
Branch: master
Clone or download
Type Name Latest commit message Commit time
Failed to load latest commit information.
.github Update issue templates May 30, 2019
.vscode Setup initial e2e tests with Spectron. Jul 24, 2019
content Fixed bot inspector docs page accessibility. Sep 10, 2019
docs/media updates for //build May 5, 2019
jestMocks Bumped several dependencies to improve security. Jun 3, 2019
packages Enabled HTML-based app menu for Linux. (#2020) Dec 9, 2019
scripts Delete PublishToCoveralls.ps1 May 9, 2019
.babelrc Emulator Launch, Commands and Extension Tech Debt Buydown (#1577) May 23, 2019
.editorconfig let git handle line endings instead of editor Jan 11, 2019
.eslintrc.js show message when nothing has been inspected yet (#1290) Feb 1, 2019
.eslintrc.react.js 💅 integrate prettier and eslint (#1240) Jan 17, 2019
.gitattributes let git handle line endings instead of editor Jan 11, 2019
.gitignore Added several e2e tests from the release checklist. Sep 5, 2019
.node-version set node version to latest LTS Dec 17, 2018
.prettierrc Relaxed prettier print-width rule to 120. (#1255) Jan 28, 2019
.travis.yml Jwilaby/debugging doc (#1463) Apr 25, 2019 Enabled HTML-based app menu for Linux. (#2020) Dec 9, 2019 Update Stack Overflow tag after community merged it with botframework Sep 16, 2019
LICENSE.txt Update README, CONTRIBUTING, etc (#470) May 4, 2018 Added first-time data collection dialog. (#1624) Jun 18, 2019 Update Jul 3, 2019 Added Microsoft SECURITY notice. Sep 4, 2019
ThirdPartyNotices.txt Renamed and updated oss notice. (#1628) Jun 12, 2019
babel-jest-config.js Unit tests for core Oct 1, 2018
copyright.js 💅 integrate prettier and eslint (#1240) Jan 17, 2019
env.js Build tweaks May 29, 2018
lerna.json Rewrote emulator/core package & moved to app/main. (#1989) Nov 18, 2019
package-lock.json Rewrote emulator/core package & moved to app/main. (#1989) Nov 18, 2019
package.json #1753 fix focus indicator on file upload button Sep 10, 2019
testSetup.js Fixed and added tests for state consolidation. Aug 16, 2019
tsconfig.json Emulator Launch, Commands and Extension Tech Debt Buydown (#1577) May 23, 2019

Bot Framework Emulator

Click here to find out what's new with Bot Framework

Bot Framework Emulator

Build Status Coverage Status

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.

Supported platforms

  • 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.



Nightly builds

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

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 with any additional questions or comments.

Reporting Security Issues

Security issues and bugs should be reported privately, via email, to the Microsoft Security Response Center (MSRC) at 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.

You can’t perform that action at this time.