Microsoft Bot Framework Emulator

Microsoft Bot Framework Emulator is a free, open-source desktop application for macOS (and Windows) that lets developers run, inspect, and troubleshoot conversational AI bots locally — without deploying them to Azure or any cloud service first.

What is Microsoft Bot Framework Emulator?

Microsoft Bot Framework Emulator is a local development client for bots built with the Bot Framework SDK. It opens a chat-style UI directly against your bot's localhost endpoint, so you can send messages, inspect every request-and-response payload in real time, and iterate on dialog logic without touching a staging environment. Think of it as Postman for bots — but instead of raw HTTP calls you're having actual conversations, and the activity inspector shows you the full Activity JSON underneath each turn.

What does Microsoft Bot Framework Emulator do best?

Its killer feature is the activity inspector. Every message exchange — user utterance, bot reply, card attachment, suggested action — is captured as a collapsible JSON tree in the sidebar. I've spent hours in this panel tracing exactly where a LUIS intent mis-fired or why an Adaptive Card payload was malformed. No log-scraping, no printf debugging.

• Transcript recording and replay: save a conversation to a .transcript file and reopen it later to walk through a previous session step-by-step. Invaluable for reproducing intermittent bugs reported by QA.
• Directline and ngrok integration: the emulator can tunnel to a public URL via ngrok with a single click, so you can hand a tester a URL and they can hit your local bot from a phone.
• OAuth and token inspection: built-in support for testing authentication flows and inspecting the token exchange, which would otherwise require a deployed app registration.
• Multi-bot and multi-endpoint management: save connection profiles for every bot in your solution — Dev, Staging, different skill bots — and switch between them in seconds.

Who should use Microsoft Bot Framework Emulator?

Anyone writing bots with the Bot Framework SDK (Node.js or C#/.NET) needs this tool in their workflow. If you're building on Azure Bot Service, it's essentially non-negotiable — the feedback loop without it means deploy, test in Azure portal, read cloud logs, repeat, which can burn 10 minutes per iteration. With the emulator that cycle drops to seconds.

It's less useful if your bot backend is entirely custom HTTP and you're not using the Activity schema — in that case Insomnia or Postman may serve you better. And if you're building with Rasa, Botpress, or Dialogflow, this is the wrong tool entirely; those ecosystems have their own testing UIs.

Is Microsoft Bot Framework Emulator free?

Yes — completely free and fully open-source under the MIT licence, maintained by Microsoft on GitHub. There is no paid tier, no rate limit, and no account required. You can install it in seconds via Homebrew: brew install --cask microsoft-bot-framework-emulator.

How does Microsoft Bot Framework Emulator compare to testing bots in Azure portal?

The Azure portal's "Test in Web Chat" is a production-grade surface: it's fast to reach but it requires a deployed bot, live credentials, and real Azure traffic. Every iteration costs a deploy cycle and makes reading logs painful. The emulator is the opposite — purely local, zero cloud cost, full message inspection, and you can pause, replay, and diff transcripts. I only switch to Web Chat for a final smoke-test before shipping; everything else happens in the emulator.

There's no real macOS-native alternative that does the same job. Proxyman or Charles Proxy can intercept the HTTP traffic, but they don't understand the Bot Framework Activity schema and won't give you the structured inspector. For Bot Framework development specifically, the emulator is the only practical choice.

What are the best Microsoft Bot Framework Emulator alternatives?

If you're outside the Bot Framework ecosystem, Botpress Studio has a built-in conversation simulator for its own runtime, and Rasa X / Rasa Pro ships a conversation review UI. For pure HTTP API inspection of any chatbot backend, Insomnia and Postman remain the gold standard. None of these, however, speak the Activity protocol or understand Bot Framework channels — making them poor substitutes if you're actually building on the SDK.