Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (
Help us improve Python packaging - Donate today!

A minimal command-line HipChat client.

Project Description

A minimal Python HipChat client with command-line interface.


Install hipchav from source, or using pip:

pip install hipchav

Then you’ll need to configure it with your HipChat API key:

export HIPCHAT_V1_TOKEN=thisismyhextokentheygaveme

or for the v2 API:

export HIPCHAT_V2_TOKEN=thisismyhextokentheygaveme


HipChav currenly only supports two functions, listing rooms and sending messages.

Listing rooms

$ rooms
Whole company
Bots only

Sending messages

Messages are quite straight-forward to send:

$ message 'Whole company' 'Freshly baked cookies in the kitchen'

You can also change their color and send notifications to people in the room:

$ message --color=red --notify 'Developers' 'Um, the build is broken'

With the v1 API, you can also choose who the message appears from:

$ message --from=Glados 'Whole company' 'Dispensing deadly neurotoxin'

Check its usage information for full options:

$ --help



  • Install as both a script and a module


  • Support HTML messages using the --format flag


  • Also support v1 API, autodetect based on environment variables present
  • For v1 API, support the from field with the --from option.
  • You’ll need to update HIPCHAT_AUTH_TOKEN to either HIPCHAT_V1_TOKEN or HIPCHAT_V2_TOKEN


  • Initial release, supports listing rooms and messaging with color and notifications

Release History

This version
History Node


History Node


History Node


History Node


Download Files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, Size & Hash SHA256 Hash Help File Type Python Version Upload Date
(3.5 kB) Copy SHA256 Hash SHA256
Source None Nov 7, 2013

Supported By

Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Google Google Cloud Servers DreamHost DreamHost Log Hosting