Skip to main content

Tiny multi-server automation tool.

Project description

😽 kitten

Build Status Maintainability PyPI - Python Version PyPI

Tiny multi-server automation tool.

Designed to be as simple as possible and play nice with Unix tools.



pip install kitten


kitten can get IP addresses from AWS resources for you. For that you'll need to have your AWS credentials set up. You can do that using awscli:

pip install awscli


aws configure


Run command on servers

Use kitten run:

$ kitten run uptime ubuntu	run	uptime	run	uptime	17:11:48 up 2 days,  6:02,  0 users,  load average: 0.91, 2.99, 3.49	17:11:48 up 5 days, 11:19,  0 users,  load average: 6.34, 5.94, 5.72
  • Replace ubuntu with the user used to log in on the servers.
  • Use -i to specify a private key. Otherwise, behavior is similar to ssh.
  • Use --threads to specify the number of concurrent connections (defaults to 10).

Get IP addresses from AWS resources

Use kitten ip with either id, asg, elb or opsworks:

$ kitten ip asg my-tiny-asg
  • By default only private IP addresses are returned. Use --public if you prefer public IPs.
  • You can change region using --region.

If you're in a hurry, you can just paste any text that contains instance IDs:

$ kitten ip id prod-mongo-0901bc21990109ed4-eu my-hostname-06a2fc734534ef6d9

Download files from servers

Use kitten get:

kitten ip opsworks a283c671-d4c1-4dfa-a7c2-823b7f7b2c2c | xargs kitten get /tmp/system.log ubuntu

Upload file to servers

Use kitten put:

kitten ip asg big-prod-asg | xargs kitten put -i ~/.ssh/key.pem cat.jpg /tmp ubuntu

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
kitten-0.5.0-py2.py3-none-any.whl (6.7 kB) Copy SHA256 hash SHA256 Wheel py2.py3

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page