Awesome Open Source
Awesome Open Source


Microsoft has stated that they will be dropping support for the Skype desktop API. This adapter will likely stop working in the very near future (If it hasn't already... this change was slated for December 2013).

The adapter was always a hack at best, if you are looking to set up a bot for your company or community I would HIGHLY recommend using a network that better supports scripting such as Campfire or IRC.


This is the Skype adapter for hubot that allows you to communicate with hubot through Skype.


  • Add hubot-skype as a dependency in your hubot's package.json (use this repository url git:// as the version)
  • Install dependencies with npm install
  • Install Python dependency Skype4Py with pip or easy_install
  • Log into a Skype client on the same machine you are running hubot
  • Run hubot with bin/hubot -a skype


The Skype adapter works by communicating through a locally running Skype client. You need to create a Skype account for your bot, and log into it on a Skype client running on the same machine as hubot. When you first launch hubot with the Skype adapter, Skype will prompt you to allow for API permission. You must allow this before the bot will work.

OS Specific notes


On Windows, it's possible to communicate with Skype via native COM interface without installing Python (which is not preinstalled in this OS) but using edge.js (.NET adapter for Node.js).

So, if you don't have Python installed and target only Windows machines, you can try Skype4COM adapter.

Please not that you shouldn't use it if planning to run your script on other operating systems.


The current version of Skype4Py doesn't play nicely with the 64 bit version of python on OSX and would immediately cause a segmentation fault, but a workaround has been established in this repo using the arch command (see /src/python32bit for details).

If this built in workaround doesn't seem to work, you may need to force python to run in 32 bit mode by setting the environment variable VERSIONER_PYTHON_PREFER_32_BIT to true


./hubot -a skype


If you would like to use a different transport type than the default (x11) you may set the HUBOT_SKYPE_TRANSPORT environment variable. Currently supported values are x11 amd dbus. More information on module page.


Here's the most direct way to get your work merged into the project.

  1. Fork the project
  2. Clone down your fork
  3. Create a feature branch
  4. Hack away
  5. If necessary, rebase your commits into logical chunks without errors
  6. Push the branch up to your fork
  7. Send a pull request for your branch


Copyright © Dominick D'Aniello. See LICENSE for details.

Alternatives To Hubot Skype
Select To Compare

Alternative Project Comparisons
Related Awesome Lists
Top Programming Languages
Top Projects

Get A Weekly Email With Trending Projects For These Topics
No Spam. Unsubscribe easily at any time.
Python (821,947
Coffeescript (17,258
Adapter (11,212
Hubot (2,572
Skype (999
Workaround (934