Natural language to AWS CLI converter with real-time validation
Project description
AWS CLI Assistant - Lite Edition
Overview
AWS CLI Assistant converts your natural language requests into proper AWS CLI commands with real-time validation against your AWS environment.
Features
✅ Natural Language Processing - Just describe what you want to do
✅ 5 AWS Services - S3, DynamoDB, EC2, Lambda, IAM
✅ Real-time Validation - Commands tested against your actual AWS account
✅ Instant Results - Get command syntax and execution results immediately
Supported Operations
S3 Operations
- List buckets
- Create buckets
- Delete buckets
- List objects in bucket
DynamoDB Operations
- List tables
- Describe table
- Query table
- Scan table
EC2 Operations
- List instances
- Describe instances
- Start/stop instances
Lambda Operations
- List functions
- Invoke function
- Get function configuration
IAM Operations
- List users
- List roles
- Get user details
Installation
Prerequisites
- Python 3.10 or higher
- AWS CLI configured with credentials
- Valid AWS account
Quick Start
- Clone or download the package
git clone <your-repo-url>
cd aws-cli-assistant-lite
- Install dependencies
pip install -r requirements.txt
- Configure AWS credentials
aws configure
- Start the MCP server
python mcp_server.py
- Connect to Claude Desktop (if using MCP)
Add to your
claude_desktop_config.json:
{
"mcpServers": {
"aws-cli-assistant-lite": {
"command": "C:/myworkspace/mcp/MCP-phase-1/venv-phase-1/Scripts/python.exe",
"args": [
"C:/myworkspace/mcp/MCP-phase-1/src/mcp_server.py"
],
"env": {
"AWS_REGION": "us-west-1",
"PYTHONPATH": "C:/myworkspace/mcp/MCP-phase-1/src",
"PYTHONUNBUFFERED": "1"
}
}
}
}
Usage Examples
Example 1: List S3 Buckets
Input: "list all my s3 buckets"
Output:
aws s3 ls
Validation: ✅ Valid - Found 19 buckets
Example 2: List Lambda Functions
Input: "show me lambda functions"
Output:
aws lambda list-functions --region us-west-1
Validation: ✅ Valid - Found 11 functions
Example 3: List DynamoDB Tables
Input: "list dynamodb tables"
Output:
aws dynamodb list-tables
Validation: ✅ Valid - Found 4 tables
Architecture
User Input (Natural Language)
↓
NLP Transformer Model
↓
AWS CLI Command Generation
↓
Boto3 Validation (Real AWS)
↓
Result + Validation Status
API Reference
generate_aws_cli(query: str)
Converts natural language to AWS CLI command
Parameters:
query(string): Natural language request
Returns:
{
"command": "aws s3 ls",
"explanation": "Lists S3 buckets in your account",
"validation": {
"intent": "list_s3_buckets",
"region": "us-west-1",
"status": "valid",
"reason": "Listed buckets",
"detail": { "buckets": [...] }
}
}
health_check()
Verifies service status
Returns:
{
"status": "ok",
"model": "local-transformer"
}
list_supported_services()
Returns supported AWS services
Returns:
["s3", "dynamodb", "ec2", "lambda", "iam"]
Configuration
Environment Variables
AWS_REGION=us-west-1 # Your preferred AWS region
AWS_PROFILE=default # AWS profile to use
MCP_PORT=3000 # Server port (optional)
Custom Settings
Edit config.yaml:
services:
- s3
- dynamodb
- ec2
- lambda
- iam
validation:
enabled: true
timeout: 30
model:
type: local-transformer
cache_size: 1000
Pricing
Lite Edition: $49/month or $500 one-time purchase
Includes:
- 5 AWS services
- 100 queries per day
- Email support
- Monthly updates
Need more? Contact us about Pro Edition (15+ services, unlimited queries)
Support
- Email: aws2minutes@gmail.com
- Documentation: https://docs.yourdomain.com
- Issues: https://github.com/yourrepo/issues
FAQ
Q: Does this work with all AWS regions?
A: Yes, specify your region in AWS configuration.
Q: Can I use this with multiple AWS accounts?
A: Lite edition supports one account. Pro edition supports multiple.
Q: Is my AWS data secure?
A: Yes, all processing is local. We never store your AWS credentials or data.
Q: What happens if I exceed 100 queries/day?
A: Service pauses until next day. Upgrade to Pro for unlimited queries.
Roadmap
Coming in Q1 2026:
- RDS support
- CloudFormation support
- Cost estimation
- Batch operations
License
Commercial License - See LICENSE.txt
About
Created by [Malini Agrawal] - AWS Certified Solutions Architect & Developer
Transitioned from Banking & Finance to AWS Cloud Engineering in 2021
Ready to simplify your AWS CLI experience?
Download and get started today!#\x00 \x00a\x00w\x00s\x00-\x00c\x00l\x00i\x00-\x00a\x00s\x00s\x00i\x00s\x00t\x00a\x00n\x00t\x00-\x00l\x00i\x00t\x00e\x00
\x00
\x00
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
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file aws_cli_assistant_lite-1.0.0.tar.gz.
File metadata
- Download URL: aws_cli_assistant_lite-1.0.0.tar.gz
- Upload date:
- Size: 22.3 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.11.2
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
671c69fb1696908488db6e84b1a171a2ea7ac9339944dfd409d40930c272c5ce
|
|
| MD5 |
4000b99528a9ad4aeb7094e7579310a7
|
|
| BLAKE2b-256 |
4394a6b581c9cc11883a14989506a15a29393621ec539baa102bcfc988d52bb6
|
File details
Details for the file aws_cli_assistant_lite-1.0.0-py3-none-any.whl.
File metadata
- Download URL: aws_cli_assistant_lite-1.0.0-py3-none-any.whl
- Upload date:
- Size: 26.3 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.11.2
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
221914881745945e23464bb5e7ddab8d6fcf503ae2248c9773ab0e5bd2ec7333
|
|
| MD5 |
37f6face53d7f9925fc23a4fae45c058
|
|
| BLAKE2b-256 |
9969bfc737675fe73813c9d443ab17db617acecd790447868171820ecfd4ede1
|