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

Release History

This version
History Node


History Node


History Node


History Node


Download Files

Download Files

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

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
hipchav-0.1.3.tar.gz (3.5 kB) Copy SHA256 Checksum SHA256 Source Nov 7, 2013

Supported By

WebFaction WebFaction Technical Writing 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 Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting