Skip to main content

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

Project details

Download files

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

Source Distribution

hipchav-0.1.3.tar.gz (3.5 kB view hashes)

Uploaded source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page