{"id":28550341,"url":"https://github.com/seek-oss/aec","last_synced_at":"2025-07-02T14:07:26.950Z","repository":{"id":35479074,"uuid":"204802772","full_name":"seek-oss/aec","owner":"seek-oss","description":"AWS EC2 CLI - easily work with ec2 instances via the cli 🐶","archived":false,"fork":false,"pushed_at":"2025-06-10T08:39:01.000Z","size":663,"stargazers_count":10,"open_issues_count":7,"forks_count":6,"subscribers_count":6,"default_branch":"master","last_synced_at":"2025-06-26T09:04:13.499Z","etag":null,"topics":["aws","cli","ec2"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/seek-oss.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2019-08-27T22:44:13.000Z","updated_at":"2025-06-10T08:39:03.000Z","dependencies_parsed_at":"2024-03-09T07:25:14.431Z","dependency_job_id":"4c802a00-13b6-4a4c-a834-c3ac90f971d8","html_url":"https://github.com/seek-oss/aec","commit_stats":null,"previous_names":[],"tags_count":41,"template":false,"template_full_name":null,"purl":"pkg:github/seek-oss/aec","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/seek-oss%2Faec","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/seek-oss%2Faec/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/seek-oss%2Faec/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/seek-oss%2Faec/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/seek-oss","download_url":"https://codeload.github.com/seek-oss/aec/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/seek-oss%2Faec/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":263154302,"owners_count":23422008,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["aws","cli","ec2"],"created_at":"2025-06-10T03:08:50.971Z","updated_at":"2025-07-02T14:07:26.941Z","avatar_url":"https://github.com/seek-oss.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# AWS EC2 CLI\n\n[![Build](https://github.com/seek-oss/aec/actions/workflows/ci.yml/badge.svg)](https://github.com/seek-oss/aec/actions/workflows/ci.yml)\n[![Release](https://github.com/seek-oss/aec/actions/workflows/release.yml/badge.svg)](https://github.com/seek-oss/aec/actions/workflows/release.yml)\n[![PyPI version](https://badge.fury.io/py/aec-cli.svg)](https://pypi.org/project/aec-cli/)\n\n_\"Instead of using the console, use the cli!\"_.\n\nCommand-line tools for managing pet EC2 instances by name.\n\nDefaults only need to be supplied once via a [config file](src/aec/config-example/ec2.toml), which supports multiple profiles for different regions or AWS accounts.\n\nFor examples see:\n\n- [EC2](docs/ec2.md) - manipulate EC2 instances by name, and launch them with tags and EBS volumes of any size, as per the settings in the configuration file (subnet, security group etc).\n- [AMI](docs/ami.md) - describe, delete and share images\n- [Compute Optimizer](docs/compute-optimizer.md) - show over-provisioned instances\n- [SSM](docs/ssm.md) - run commands on instances, and [ssm patch management](https://docs.aws.amazon.com/systems-manager/latest/userguide/systems-manager-patch.html)\n\n## Prerequisites\n\n- python 3.9+\n\n## Install\n\nRun the following to install the latest master version using pip:\n\n```\npip install aec-cli\n```\n\nIf you have previously installed aec, run the following to upgrade to the latest version:\n\n```\npip install --upgrade aec-cli\n```\n\nNB: Consider using [pipx](https://github.com/pipxproject/pipx) to install aec-cli into its own isolated virtualenv.\n\n## Configure\n\nBefore you can use aec, you will need to create the config files in `~/.aec/`. The config files contain settings for your AWS account including VPC details and additional tagging requirements.\n\nTo get started, run `aec configure example` to install the [example config files](src/aec/config-example/) and then update them as needed.\n\n## Handy aliases\n\nFor even faster access to aec subcommands, you may like to add the following aliases to your .bashrc:\n\n```\nalias ec2='COLUMNS=$COLUMNS aec ec2'\nalias ami='COLUMNS=$COLUMNS aec ami'\nalias ssm='COLUMNS=$COLUMNS aec ssm'\n```\n\n`COLUMNS=$COLUMNS` will ensure output is formatted to the width of your terminal when piped.\n\n## FAQ\n\n### How do I use aec with other AWS profiles?\n\nTo use aec with the named profile 'production':\n\n```\nexport AWS_DEFAULT_PROFILE=production\naec ec2 describe\n```\n\n## Similar projects\n\n[wallix/awless](https://github.com/wallix/awless) is written in Go, and is an excellent substitute for awscli with\nsupport for many AWS services. It has human friendly commands for use on the command line or in templates. Unlike `aec` its ec2 create instance command doesn't allow you to specify the EBS volume size, or add tags.\n\n[achiku/jungle](https://github.com/achiku/jungle) is written in Python, and incorporates a smaller subset of ec2 commands and doesn't launch new instances. It does however have an ec2 ssh command. It also supports other AWS services like ELB, EMR, RDS.\n\n## Contributing\n\nSee [CONTRIBUTING.md](CONTRIBUTING.md) to get started and develop in this repo.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fseek-oss%2Faec","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fseek-oss%2Faec","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fseek-oss%2Faec/lists"}