# awdx
**awdx** (AWS DevOps X) is a next-generation, human-friendly CLI tool for AWS DevSecOps. It helps you manage, automate, and secure your AWS environment with simple, interactive commands and smart suggestions.
---
## Table of Contents
- [Features](#features)
- [Requirements](#requirements)
- [Installation](#installation)
- [Quick Start](#quick-start)
- [Modules](#modules)
- [Future Plans](#future-plans)
- [Project Status](#project-status)
---
## Features
- **Profile Management:** Create, switch, and validate AWS profiles interactively
- **Cost Intelligence:** Advanced cost analysis with anomaly detection and forecasting
- **IAM Management:** Comprehensive IAM security audit and compliance checking
- **S3 Security:** Complete S3 bucket security assessment and compliance monitoring
- **Secret Management:** Automated secret discovery, rotation, and compliance
- **Security Assessment:** Comprehensive security posture and vulnerability scanning
- **Task Automation:** 40+ high-level DevSecOps automation commands with AI enhancement
- **AI-Powered Interface:** Natural language commands with Google Gemini integration
- **MCP Server:** Model Context Protocol integration for AI assistants
- **Smart Suggestions:** Receive actionable best-practice tips after every action
- **Human-Friendly CLI:** Simple, memorable commands and interactive prompts
---
## Requirements
- Python 3.8+
- [boto3](https://boto3.amazonaws.com/v1/documentation/api/latest/index.html)
- [typer](https://typer.tiangolo.com/)
---
## Installation
### From Source
```bash
pip install .
```
### From PyPI
```bash
pip install awdx
```
📦 **Available on PyPI:** [awdx on PyPI](https://pypi.org/project/awdx/)
---
## Quick Start
Show help and available commands:
```bash
awdx --help
```
---
## Modules
### AWDX with Gen AI + NLP based CLI execution
🤖 **Revolutionary AI-powered natural language interface that understands your DevSecOps intent!** Chat with your AWS infrastructure using plain English. No more memorizing complex commands - just ask AWDX what you want to accomplish.
```bash
# Ask anything in natural language
awdx ai ask "show me all my AWS profiles"
🤖 Analyzing your request...
💡 Intent: list_profiles
🎯 AWDX Command: awdx profile list
✨ Confidence: 95%
# Interactive AI chat session
awdx ai chat
🤖 AWDX AI Assistant ready! Ask me anything about your AWS environment.
💬 You: "What are my highest cost services this month?"
🤖 I'll help you analyze your AWS costs. Running: awdx cost summary
💰 Your top 3 services: EC2 ($567.89), S3 ($234.56), RDS ($123.45)
💡 Suggestion: Consider EC2 reserved instances to save up to 30%
# Get intelligent explanations
awdx ai explain "awdx iam audit --fix"
🧠 Command Breakdown:
📋 awdx iam audit: Performs comprehensive IAM security assessment
🔧 --fix flag: Automatically remediates safe issues
⚠️ Security Note: Review changes before applying in production
🎯 Best Practice: Run without --fix first to preview changes
```
💡 **AI Features:**
• **Smart Intent Recognition** - 25+ supported DevSecOps intents
• **Google Gemini Integration** - Powered by advanced AI models
• **Security-First** - Built-in security recommendations and warnings
• **Context Awareness** - Understands your AWS environment and suggests workflows
• **Interactive Chat** - Conversational DevSecOps automation
📖 **Full Documentation:** [AI Features](docs/AI_FEATURES.md) | [AI Engine Architecture](https://github.com/pxkundu/awdx/tree/development/docs/AIENGINEARCH.md)
### MCP Server Integration
🔌 **Model Context Protocol (MCP) server for AI assistant integration!** Connect AWDX to Claude Desktop, ChatGPT, and other AI assistants for seamless DevSecOps automation.
```bash
# Start MCP server
awdx mcp start
🔌 MCP server is ready to accept connections!
Connect your AI assistant to: localhost:3000
# List available tools
awdx mcp tools
Profile Management
awdx_profile_list List all AWS profiles configured in AWDX
awdx_profile_switch Switch to a different AWS profile
awdx_profile_add Add a new AWS profile
Cost Analysis
awdx_cost_summary Get AWS cost summary and analysis
awdx_cost_trends Analyze cost trends over time
awdx_cost_optimize Get cost optimization recommendations
# Test connection
awdx mcp test
✓ Connection successful!
Server: AWDX MCP Server v1.0.0
```
💡 **MCP Features:**
• **17 MCP Tools** - All AWDX capabilities exposed as standardized tools
• **AI Assistant Integration** - Connect to Claude Desktop, ChatGPT, and custom assistants
• **Real-time AWS Data** - Live access to AWS resources and security posture
• **Secure Communication** - Local execution with AWS credential management
• **Standardized Protocol** - Compatible with MCP-compliant AI assistants
📖 **Full Documentation:** [MCP Integration](https://github.com/pxkundu/awdx/tree/development/docs/MCP_INTEGRATION.md)
### Profile Management
Manage AWS profiles with security best practices and validation.
```bash
# List all profiles
awdx profile list
👤 Found 3 profiles:
🎯 👤 default (current)
👤 devops
👤 prod
# Switch profiles
awdx profile switch devops
✅ To switch profile, run:
export AWS_PROFILE=devops
# Validate credentials
awdx profile validate devops
✅ Profile 'devops' is valid. Account: 123456789012, ARN: arn:aws:iam::123456789012:user/devops
```
📖 **Full Documentation:** [Profilyze Module README](https://github.com/pxkundu/awdx/blob/development/Profilyze/DESIGN.md)
### Cost Analysis
Monitor, analyze, and optimize AWS spending with intelligent insights.
```bash
# Get cost summary
awdx cost summary
💰 Total Cost: $1,234.56
📊 Top 10 Services by Cost:
1. Amazon EC2 $567.89
2. Amazon S3 $234.56
3. Amazon RDS $123.45
# Detect anomalies
awdx cost anomaly --threshold 2.5
🔍 Detecting cost anomalies for the last 30 days...
📊 Average daily cost: $123.45
📈 Standard deviation: $45.67
✅ No significant anomalies detected!
# Forecast costs
awdx cost forecast --months 3
🔮 Forecasting costs for the next 3 months...
📈 Trend direction: Upward
📊 Monthly change: $45.67
🎯 Trend confidence: 85.2%
```
📖 **Full Documentation:** [Costlyzer Module README](https://github.com/pxkundu/awdx/tree/development/Costlyzer)
### IAM Management
Comprehensive IAM security audit, compliance checking, and smart automation.
```bash
# Security audit
awdx iam audit
🔍 Starting comprehensive IAM security audit...
🔍 Checking root account usage...
✅ Using IAM user/role
🔍 Checking MFA configuration...
❌ HIGH: 3 users without MFA
🔍 Audit Summary:
🔴 Critical Issues: 0
🟠 High Issues: 1
🟡 Medium Issues: 1
# Analyze access patterns
awdx iam access
🔑 Analyzing IAM access patterns...
👤 admin (user)
⚡ Total Permissions: 45
🎯 Privileged: 12
❌ Wildcards: 3
# Smart recommendations
awdx iam smart --auto-fix --dry-run
🚀 Generating smart IAM recommendations...
1. 🔴 Remove unused users 🤖
2. 🟠 Rotate old access keys 👤
3. 🔴 Review wildcard permissions 👤
```
📖 **Full Documentation:** [IAMply Module README](https://github.com/pxkundu/awdx/tree/development/IAMply)
### S3 Security & Compliance
Complete S3 bucket security assessment, compliance monitoring, and automated remediation.
```bash
# Comprehensive S3 audit
awdx s3 audit
🪣 Starting comprehensive S3 security audit...
🔍 Checking bucket configurations...
✅ Encryption: Enabled
❌ HIGH: Public access detected
🔍 Audit Summary:
🔴 Critical Issues: 0
🟠 High Issues: 2
🟡 Medium Issues: 3
# Scan for vulnerabilities
awdx s3 scan --type public
🔍 Scanning for public S3 buckets...
🚨 Found 2 publicly accessible buckets:
- my-public-bucket (HIGH RISK)
- test-bucket (MEDIUM RISK)
# Compliance assessment
awdx s3 compliance --framework sox
📋 Assessing SOX compliance for S3...
✅ Encryption controls: PASS
❌ Access logging: FAIL
✅ Versioning: PASS
```
📖 **Full Documentation:** [S3ntry Module README](https://github.com/pxkundu/awdx/tree/development/S3ntry)
### Secret Management
Automated secret discovery, rotation, compliance monitoring, and smart remediation.
```bash
# Discover all secrets
awdx secret discover
🔐 Discovering secrets across AWS services...
🔍 Found 15 secrets:
- 8 in Secrets Manager
- 5 in Parameter Store
- 2 in IAM access keys
❌ HIGH: 3 secrets expired
⚠️ MEDIUM: 5 secrets expiring soon
# Rotate secrets
awdx secret rotate my-secret-id
🔄 Rotating secret: my-secret-id
✅ Secret rotated successfully
📅 Next rotation: 2024-02-15
# Monitor secret health
awdx secret monitor --days 30
📊 Monitoring secret health for last 30 days...
✅ Successful rotations: 12
❌ Failed rotations: 1
⚠️ Expiring soon: 3
```
📖 **Full Documentation:** [Secrex Module README](https://github.com/pxkundu/awdx/tree/development/Secrex)
### Task Automation
🚀 **High-level DevSecOps task automation and productivity commands!** Streamline your DevSecOps workflows with intelligent automation that combines multiple AWS services into single, powerful commands.
```bash
# Comprehensive security audit
awdx task security-audit --comprehensive --fix-safe
🔍 Starting comprehensive security audit across AWS services...
🔐 IAM Security: Checking users, roles, and policies
🛡️ EC2 Security: Analyzing security groups and encryption
🪣 S3 Security: Validating bucket configurations
🔐 Secrets: Auditing secret rotation and age
📊 Audit Summary: 3 high issues, 5 medium issues found
🔧 Auto-fixing safe issues: 2 issues resolved
# Cost optimization with AI insights
awdx task cost-optimize --auto-fix --dry-run
💰 Analyzing AWS costs for optimization opportunities...
🔍 EC2 Optimization: Found 3 oversized instances
🗄️ RDS Optimization: 2 instances can be downsized
📊 Potential Savings: $234.56/month (15% reduction)
🤖 AI Recommendation: Consider reserved instances for predictable workloads
# Compliance validation
awdx task compliance-check --framework sox --output pdf
📋 Validating SOX compliance across AWS services...
✅ IAM Controls: PASS
✅ Data Protection: PASS
❌ Access Logging: FAIL (2 issues)
📄 Generating compliance report: sox_compliance_report.pdf
# Continuous security monitoring
awdx task security-monitor --continuous --alert
🛡️ Starting continuous security monitoring...
📊 Monitoring: IAM changes, S3 access, EC2 security
🚨 Alerts: Configured for critical security events
⏰ Interval: 5 minutes
📱 Notifications: Slack, email, SMS
```
💡 **Task Module Features:**
• **40+ Automation Commands** - From basic security audits to complex infrastructure automation
• **AI-Enhanced Workflows** - Intelligent insights and recommendations when AI is configured
• **Multi-Service Integration** - Combines IAM, EC2, S3, RDS, Lambda, and more
• **Compliance Frameworks** - SOX, HIPAA, PCI-DSS, SOC2, ISO27001, NIST support
• **Rich Output Formats** - Table, JSON, CSV, and PDF reports
• **Graceful AI Fallback** - Works perfectly without AI configuration
📖 **Full Documentation:** [Task Module Summary](docs/TASK_MODULE_SUMMARY.md)
### Security Assessment
Comprehensive security posture assessment, vulnerability scanning, and incident response.
```bash
# Security posture assessment
awdx security posture
🛡️ Starting comprehensive security posture assessment...
🔍 Network Security: 85/100
🔍 IAM Security: 92/100
🔍 Data Protection: 78/100
📊 Overall Security Score: 85/100
# Vulnerability scanning
awdx security vulnerabilities --service ec2
🚨 Scanning EC2 instances for vulnerabilities...
🔍 Found 5 security issues:
- 2 open security groups (HIGH)
- 1 unencrypted EBS volume (MEDIUM)
- 2 outdated AMIs (LOW)
# Incident response
awdx security incident --type breach
🚨 Initiating incident response for security breach...
📋 Investigation checklist:
- CloudTrail logs analysis
- IAM access review
- Resource access audit
- Threat detection alerts
```
📖 **Full Documentation:** [SecuTide Module README](https://github.com/pxkundu/awdx/tree/development/SecuTide)
---
## Future Plans
### Upcoming Features
- **Multi-Cloud Support:** Extend beyond AWS to Azure and GCP
- **Integration Hub:** Connect with popular DevOps tools and CI/CD pipelines
- **Real-time Monitoring:** Live cost and security monitoring with alerts
- **Advanced AI:** Multi-modal processing and workflow automation
### Enterprise Features
- **Team Collaboration:** Multi-user support with role-based access
- **Audit Trails:** Comprehensive logging and compliance reporting
- **Custom Policies:** Define organization-specific security and cost policies
- **API Access:** RESTful API for integration with existing tools
---
## Project Status
Active development with comprehensive module coverage. The project follows a modular architecture allowing for easy extension and customization.
### Current Status
- ✅ **Profilyze Module:** Complete with full feature set
- ✅ **Costlyzer Module:** Complete with smart analytics
- ✅ **IAMply Module:** Complete with security audit and compliance
- ✅ **S3ntry Module:** Complete with security assessment and compliance
- ✅ **Secrex Module:** Complete with secret management and rotation
- ✅ **SecuTide Module:** Complete with security posture and incident response
- ✅ **Task Module:** Complete with 40+ high-level automation commands
- ✅ **AI Engine:** Complete with Google Gemini integration and natural language processing
- ✅ **MCP Server:** Complete with Model Context Protocol integration
- ✅ **Core Infrastructure:** Stable and production-ready
- ✅ **Documentation:** Comprehensive guides and examples
### Contributing
We welcome contributions! See our [Contributing Guide](CONTRIBUTING.md) for details on how to get started.
### Community
- 📖 **Documentation:** [GitHub Wiki](https://github.com/pxkundu/awdx/wiki)
- 🐛 **Issues:** [GitHub Issues](https://github.com/pxkundu/awdx/issues)
- 💬 **Discussions:** [GitHub Discussions](https://github.com/pxkundu/awdx/discussions)
- 📄 **License:** [MIT License](LICENSE)
---
## 👨💻 Author & Attribution
**AWDX** is created and maintained by **Partha Sarathi Kundu** (@pxkundu).
**Independence Notice**: AWDX is developed independently and is not affiliated with, endorsed by, or sponsored by any organization, university, or company.
### Copyright & License
- **Copyright**: © 2024 Partha Sarathi Kundu. All rights reserved.
- **License**: MIT License - see [LICENSE](https://github.com/pxkundu/awdx/blob/development/LICENSE) for details
- **Trademark**: "AWDX" and "AWS DevOps X" are trademarks of Partha Sarathi Kundu
### Citation
If you use AWDX in academic research or commercial projects, please cite:
```
Kundu, P. S. (2024). AWDX: AWS DevOps X - Gen AI-powered AWS DevSecOps CLI tool.
GitHub. https://github.com/pxkundu/awdx
```
For academic papers (BibTeX):
```bibtex
@software{awdx2024,
author = {Kundu, Partha Sarathi},
title = {AWDX: AWS DevOps X - Gen AI-powered AWS DevSecOps CLI tool},
year = {2024},
url = {https://github.com/pxkundu/awdx},
note = {MIT License}
}
```
### Contact
- **Email**: inboxkundu@gmail.com
- **GitHub**: [@pxkundu](https://github.com/pxkundu)
- **Project**: [https://github.com/pxkundu/awdx](https://github.com/pxkundu/awdx)
### Support & Troubleshooting
- **📖 Troubleshooting Guide**: [TROUBLESHOOTING.md](TROUBLESHOOTING.md) - Common issues and solutions
- **🐛 Issues**: [GitHub Issues](https://github.com/pxkundu/awdx/issues)
- **💬 Discussions**: [GitHub Discussions](https://github.com/pxkundu/awdx/discussions)
### Contributors
See [AUTHORS.md](https://github.com/pxkundu/awdx/blob/development/AUTHORS.md) for a complete list of contributors and their contributions.
Raw data
{
"_id": null,
"home_page": null,
"name": "awdx",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": "Partha Sarathi Kundu <inboxkundu@gmail.com>",
"keywords": "aws, devops, devsecops, cli, cost-analysis, security, automation, ai, nlp, gemini, natural-language",
"author": null,
"author_email": "Partha Sarathi Kundu <inboxkundu@gmail.com>",
"download_url": "https://files.pythonhosted.org/packages/6a/4f/c995a18facf173b890631158f1d1de47ceaf86e0b709fa6a4e2cabfa9e7f/awdx-0.0.15.tar.gz",
"platform": null,
"description": "# awdx\n\n**awdx** (AWS DevOps X) is a next-generation, human-friendly CLI tool for AWS DevSecOps. It helps you manage, automate, and secure your AWS environment with simple, interactive commands and smart suggestions.\n\n\n\n---\n\n## Table of Contents\n- [Features](#features)\n- [Requirements](#requirements)\n- [Installation](#installation)\n- [Quick Start](#quick-start)\n- [Modules](#modules)\n- [Future Plans](#future-plans)\n- [Project Status](#project-status)\n\n---\n\n## Features\n- **Profile Management:** Create, switch, and validate AWS profiles interactively\n- **Cost Intelligence:** Advanced cost analysis with anomaly detection and forecasting\n- **IAM Management:** Comprehensive IAM security audit and compliance checking\n- **S3 Security:** Complete S3 bucket security assessment and compliance monitoring\n- **Secret Management:** Automated secret discovery, rotation, and compliance\n- **Security Assessment:** Comprehensive security posture and vulnerability scanning\n- **Task Automation:** 40+ high-level DevSecOps automation commands with AI enhancement\n- **AI-Powered Interface:** Natural language commands with Google Gemini integration\n- **MCP Server:** Model Context Protocol integration for AI assistants\n- **Smart Suggestions:** Receive actionable best-practice tips after every action\n- **Human-Friendly CLI:** Simple, memorable commands and interactive prompts\n\n---\n\n## Requirements\n- Python 3.8+\n- [boto3](https://boto3.amazonaws.com/v1/documentation/api/latest/index.html)\n- [typer](https://typer.tiangolo.com/)\n\n---\n\n## Installation\n\n### From Source\n```bash\npip install .\n```\n\n### From PyPI\n```bash\npip install awdx\n```\n\n\ud83d\udce6 **Available on PyPI:** [awdx on PyPI](https://pypi.org/project/awdx/)\n\n---\n\n## Quick Start\n\nShow help and available commands:\n```bash\nawdx --help\n```\n\n---\n\n## Modules\n\n### AWDX with Gen AI + NLP based CLI execution\n\ud83e\udd16 **Revolutionary AI-powered natural language interface that understands your DevSecOps intent!** Chat with your AWS infrastructure using plain English. No more memorizing complex commands - just ask AWDX what you want to accomplish.\n\n\n\n```bash\n# Ask anything in natural language\nawdx ai ask \"show me all my AWS profiles\"\n\ud83e\udd16 Analyzing your request...\n\ud83d\udca1 Intent: list_profiles\n\ud83c\udfaf AWDX Command: awdx profile list\n\u2728 Confidence: 95%\n\n# Interactive AI chat session \nawdx ai chat\n\ud83e\udd16 AWDX AI Assistant ready! Ask me anything about your AWS environment.\n\ud83d\udcac You: \"What are my highest cost services this month?\"\n\ud83e\udd16 I'll help you analyze your AWS costs. Running: awdx cost summary\n\ud83d\udcb0 Your top 3 services: EC2 ($567.89), S3 ($234.56), RDS ($123.45)\n\ud83d\udca1 Suggestion: Consider EC2 reserved instances to save up to 30%\n\n# Get intelligent explanations\nawdx ai explain \"awdx iam audit --fix\"\n\ud83e\udde0 Command Breakdown:\n\ud83d\udccb awdx iam audit: Performs comprehensive IAM security assessment\n\ud83d\udd27 --fix flag: Automatically remediates safe issues\n\u26a0\ufe0f Security Note: Review changes before applying in production\n\ud83c\udfaf Best Practice: Run without --fix first to preview changes\n```\n\n\ud83d\udca1 **AI Features:**\n\u2022 **Smart Intent Recognition** - 25+ supported DevSecOps intents\n\u2022 **Google Gemini Integration** - Powered by advanced AI models\n\u2022 **Security-First** - Built-in security recommendations and warnings\n\u2022 **Context Awareness** - Understands your AWS environment and suggests workflows\n\u2022 **Interactive Chat** - Conversational DevSecOps automation\n\n\ud83d\udcd6 **Full Documentation:** [AI Features](docs/AI_FEATURES.md) | [AI Engine Architecture](https://github.com/pxkundu/awdx/tree/development/docs/AIENGINEARCH.md)\n\n### MCP Server Integration\n\ud83d\udd0c **Model Context Protocol (MCP) server for AI assistant integration!** Connect AWDX to Claude Desktop, ChatGPT, and other AI assistants for seamless DevSecOps automation.\n\n\n\n```bash\n# Start MCP server\nawdx mcp start\n\ud83d\udd0c MCP server is ready to accept connections!\nConnect your AI assistant to: localhost:3000\n\n# List available tools\nawdx mcp tools\nProfile Management\n awdx_profile_list List all AWS profiles configured in AWDX \n awdx_profile_switch Switch to a different AWS profile \n awdx_profile_add Add a new AWS profile \n\nCost Analysis\n awdx_cost_summary Get AWS cost summary and analysis \n awdx_cost_trends Analyze cost trends over time \n awdx_cost_optimize Get cost optimization recommendations \n\n# Test connection\nawdx mcp test\n\u2713 Connection successful!\nServer: AWDX MCP Server v1.0.0\n```\n\n\ud83d\udca1 **MCP Features:**\n\u2022 **17 MCP Tools** - All AWDX capabilities exposed as standardized tools\n\u2022 **AI Assistant Integration** - Connect to Claude Desktop, ChatGPT, and custom assistants\n\u2022 **Real-time AWS Data** - Live access to AWS resources and security posture\n\u2022 **Secure Communication** - Local execution with AWS credential management\n\u2022 **Standardized Protocol** - Compatible with MCP-compliant AI assistants\n\n\ud83d\udcd6 **Full Documentation:** [MCP Integration](https://github.com/pxkundu/awdx/tree/development/docs/MCP_INTEGRATION.md)\n\n### Profile Management\nManage AWS profiles with security best practices and validation.\n\n\n\n```bash\n# List all profiles\nawdx profile list\n\ud83d\udc64 Found 3 profiles:\n\ud83c\udfaf \ud83d\udc64 default (current)\n\ud83d\udc64 devops\n\ud83d\udc64 prod\n\n# Switch profiles\nawdx profile switch devops\n\u2705 To switch profile, run:\n export AWS_PROFILE=devops\n\n# Validate credentials\nawdx profile validate devops\n\u2705 Profile 'devops' is valid. Account: 123456789012, ARN: arn:aws:iam::123456789012:user/devops\n```\n\n\ud83d\udcd6 **Full Documentation:** [Profilyze Module README](https://github.com/pxkundu/awdx/blob/development/Profilyze/DESIGN.md)\n\n### Cost Analysis\nMonitor, analyze, and optimize AWS spending with intelligent insights.\n\n\n\n```bash\n# Get cost summary\nawdx cost summary\n\ud83d\udcb0 Total Cost: $1,234.56\n\ud83d\udcca Top 10 Services by Cost:\n 1. Amazon EC2 $567.89\n 2. Amazon S3 $234.56\n 3. Amazon RDS $123.45\n\n# Detect anomalies\nawdx cost anomaly --threshold 2.5\n\ud83d\udd0d Detecting cost anomalies for the last 30 days...\n\ud83d\udcca Average daily cost: $123.45\n\ud83d\udcc8 Standard deviation: $45.67\n\u2705 No significant anomalies detected!\n\n# Forecast costs\nawdx cost forecast --months 3\n\ud83d\udd2e Forecasting costs for the next 3 months...\n\ud83d\udcc8 Trend direction: Upward\n\ud83d\udcca Monthly change: $45.67\n\ud83c\udfaf Trend confidence: 85.2%\n```\n\n\ud83d\udcd6 **Full Documentation:** [Costlyzer Module README](https://github.com/pxkundu/awdx/tree/development/Costlyzer)\n\n### IAM Management\nComprehensive IAM security audit, compliance checking, and smart automation.\n\n\n\n```bash\n# Security audit\nawdx iam audit\n\ud83d\udd0d Starting comprehensive IAM security audit...\n\ud83d\udd0d Checking root account usage...\n \u2705 Using IAM user/role\n\ud83d\udd0d Checking MFA configuration...\n \u274c HIGH: 3 users without MFA\n\ud83d\udd0d Audit Summary:\n \ud83d\udd34 Critical Issues: 0\n \ud83d\udfe0 High Issues: 1\n \ud83d\udfe1 Medium Issues: 1\n\n# Analyze access patterns\nawdx iam access\n\ud83d\udd11 Analyzing IAM access patterns...\n\ud83d\udc64 admin (user)\n \u26a1 Total Permissions: 45\n \ud83c\udfaf Privileged: 12\n \u274c Wildcards: 3\n\n# Smart recommendations\nawdx iam smart --auto-fix --dry-run\n\ud83d\ude80 Generating smart IAM recommendations...\n1. \ud83d\udd34 Remove unused users \ud83e\udd16\n2. \ud83d\udfe0 Rotate old access keys \ud83d\udc64\n3. \ud83d\udd34 Review wildcard permissions \ud83d\udc64\n```\n\n\ud83d\udcd6 **Full Documentation:** [IAMply Module README](https://github.com/pxkundu/awdx/tree/development/IAMply)\n\n### S3 Security & Compliance\nComplete S3 bucket security assessment, compliance monitoring, and automated remediation.\n\n\n\n```bash\n# Comprehensive S3 audit\nawdx s3 audit\n\ud83e\udea3 Starting comprehensive S3 security audit...\n\ud83d\udd0d Checking bucket configurations...\n \u2705 Encryption: Enabled\n \u274c HIGH: Public access detected\n\ud83d\udd0d Audit Summary:\n \ud83d\udd34 Critical Issues: 0\n \ud83d\udfe0 High Issues: 2\n \ud83d\udfe1 Medium Issues: 3\n\n# Scan for vulnerabilities\nawdx s3 scan --type public\n\ud83d\udd0d Scanning for public S3 buckets...\n\ud83d\udea8 Found 2 publicly accessible buckets:\n - my-public-bucket (HIGH RISK)\n - test-bucket (MEDIUM RISK)\n\n# Compliance assessment\nawdx s3 compliance --framework sox\n\ud83d\udccb Assessing SOX compliance for S3...\n\u2705 Encryption controls: PASS\n\u274c Access logging: FAIL\n\u2705 Versioning: PASS\n```\n\n\ud83d\udcd6 **Full Documentation:** [S3ntry Module README](https://github.com/pxkundu/awdx/tree/development/S3ntry)\n\n### Secret Management\nAutomated secret discovery, rotation, compliance monitoring, and smart remediation.\n\n\n\n```bash\n# Discover all secrets\nawdx secret discover\n\ud83d\udd10 Discovering secrets across AWS services...\n\ud83d\udd0d Found 15 secrets:\n - 8 in Secrets Manager\n - 5 in Parameter Store\n - 2 in IAM access keys\n\u274c HIGH: 3 secrets expired\n\u26a0\ufe0f MEDIUM: 5 secrets expiring soon\n\n# Rotate secrets\nawdx secret rotate my-secret-id\n\ud83d\udd04 Rotating secret: my-secret-id\n\u2705 Secret rotated successfully\n\ud83d\udcc5 Next rotation: 2024-02-15\n\n# Monitor secret health\nawdx secret monitor --days 30\n\ud83d\udcca Monitoring secret health for last 30 days...\n\u2705 Successful rotations: 12\n\u274c Failed rotations: 1\n\u26a0\ufe0f Expiring soon: 3\n```\n\n\ud83d\udcd6 **Full Documentation:** [Secrex Module README](https://github.com/pxkundu/awdx/tree/development/Secrex)\n\n### Task Automation\n\ud83d\ude80 **High-level DevSecOps task automation and productivity commands!** Streamline your DevSecOps workflows with intelligent automation that combines multiple AWS services into single, powerful commands.\n\n\n\n```bash\n# Comprehensive security audit\nawdx task security-audit --comprehensive --fix-safe\n\ud83d\udd0d Starting comprehensive security audit across AWS services...\n\ud83d\udd10 IAM Security: Checking users, roles, and policies\n\ud83d\udee1\ufe0f EC2 Security: Analyzing security groups and encryption\n\ud83e\udea3 S3 Security: Validating bucket configurations\n\ud83d\udd10 Secrets: Auditing secret rotation and age\n\ud83d\udcca Audit Summary: 3 high issues, 5 medium issues found\n\ud83d\udd27 Auto-fixing safe issues: 2 issues resolved\n\n# Cost optimization with AI insights\nawdx task cost-optimize --auto-fix --dry-run\n\ud83d\udcb0 Analyzing AWS costs for optimization opportunities...\n\ud83d\udd0d EC2 Optimization: Found 3 oversized instances\n\ud83d\uddc4\ufe0f RDS Optimization: 2 instances can be downsized\n\ud83d\udcca Potential Savings: $234.56/month (15% reduction)\n\ud83e\udd16 AI Recommendation: Consider reserved instances for predictable workloads\n\n# Compliance validation\nawdx task compliance-check --framework sox --output pdf\n\ud83d\udccb Validating SOX compliance across AWS services...\n\u2705 IAM Controls: PASS\n\u2705 Data Protection: PASS\n\u274c Access Logging: FAIL (2 issues)\n\ud83d\udcc4 Generating compliance report: sox_compliance_report.pdf\n\n# Continuous security monitoring\nawdx task security-monitor --continuous --alert\n\ud83d\udee1\ufe0f Starting continuous security monitoring...\n\ud83d\udcca Monitoring: IAM changes, S3 access, EC2 security\n\ud83d\udea8 Alerts: Configured for critical security events\n\u23f0 Interval: 5 minutes\n\ud83d\udcf1 Notifications: Slack, email, SMS\n```\n\n\ud83d\udca1 **Task Module Features:**\n\u2022 **40+ Automation Commands** - From basic security audits to complex infrastructure automation\n\u2022 **AI-Enhanced Workflows** - Intelligent insights and recommendations when AI is configured\n\u2022 **Multi-Service Integration** - Combines IAM, EC2, S3, RDS, Lambda, and more\n\u2022 **Compliance Frameworks** - SOX, HIPAA, PCI-DSS, SOC2, ISO27001, NIST support\n\u2022 **Rich Output Formats** - Table, JSON, CSV, and PDF reports\n\u2022 **Graceful AI Fallback** - Works perfectly without AI configuration\n\n\ud83d\udcd6 **Full Documentation:** [Task Module Summary](docs/TASK_MODULE_SUMMARY.md)\n\n### Security Assessment\nComprehensive security posture assessment, vulnerability scanning, and incident response.\n\n\n\n```bash\n# Security posture assessment\nawdx security posture\n\ud83d\udee1\ufe0f Starting comprehensive security posture assessment...\n\ud83d\udd0d Network Security: 85/100\n\ud83d\udd0d IAM Security: 92/100\n\ud83d\udd0d Data Protection: 78/100\n\ud83d\udcca Overall Security Score: 85/100\n\n# Vulnerability scanning\nawdx security vulnerabilities --service ec2\n\ud83d\udea8 Scanning EC2 instances for vulnerabilities...\n\ud83d\udd0d Found 5 security issues:\n - 2 open security groups (HIGH)\n - 1 unencrypted EBS volume (MEDIUM)\n - 2 outdated AMIs (LOW)\n\n# Incident response\nawdx security incident --type breach\n\ud83d\udea8 Initiating incident response for security breach...\n\ud83d\udccb Investigation checklist:\n - CloudTrail logs analysis\n - IAM access review\n - Resource access audit\n - Threat detection alerts\n```\n\n\ud83d\udcd6 **Full Documentation:** [SecuTide Module README](https://github.com/pxkundu/awdx/tree/development/SecuTide)\n\n---\n\n## Future Plans\n\n### Upcoming Features\n- **Multi-Cloud Support:** Extend beyond AWS to Azure and GCP\n- **Integration Hub:** Connect with popular DevOps tools and CI/CD pipelines\n- **Real-time Monitoring:** Live cost and security monitoring with alerts\n- **Advanced AI:** Multi-modal processing and workflow automation\n\n### Enterprise Features\n- **Team Collaboration:** Multi-user support with role-based access\n- **Audit Trails:** Comprehensive logging and compliance reporting\n- **Custom Policies:** Define organization-specific security and cost policies\n- **API Access:** RESTful API for integration with existing tools\n\n---\n\n## Project Status\n\nActive development with comprehensive module coverage. The project follows a modular architecture allowing for easy extension and customization.\n\n### Current Status\n- \u2705 **Profilyze Module:** Complete with full feature set\n- \u2705 **Costlyzer Module:** Complete with smart analytics\n- \u2705 **IAMply Module:** Complete with security audit and compliance\n- \u2705 **S3ntry Module:** Complete with security assessment and compliance\n- \u2705 **Secrex Module:** Complete with secret management and rotation\n- \u2705 **SecuTide Module:** Complete with security posture and incident response\n- \u2705 **Task Module:** Complete with 40+ high-level automation commands\n- \u2705 **AI Engine:** Complete with Google Gemini integration and natural language processing\n- \u2705 **MCP Server:** Complete with Model Context Protocol integration\n- \u2705 **Core Infrastructure:** Stable and production-ready\n- \u2705 **Documentation:** Comprehensive guides and examples\n\n### Contributing\nWe welcome contributions! See our [Contributing Guide](CONTRIBUTING.md) for details on how to get started.\n\n### Community\n- \ud83d\udcd6 **Documentation:** [GitHub Wiki](https://github.com/pxkundu/awdx/wiki)\n- \ud83d\udc1b **Issues:** [GitHub Issues](https://github.com/pxkundu/awdx/issues)\n- \ud83d\udcac **Discussions:** [GitHub Discussions](https://github.com/pxkundu/awdx/discussions)\n- \ud83d\udcc4 **License:** [MIT License](LICENSE)\n\n---\n\n## \ud83d\udc68\u200d\ud83d\udcbb Author & Attribution\n\n**AWDX** is created and maintained by **Partha Sarathi Kundu** (@pxkundu).\n\n**Independence Notice**: AWDX is developed independently and is not affiliated with, endorsed by, or sponsored by any organization, university, or company.\n\n### Copyright & License\n- **Copyright**: \u00a9 2024 Partha Sarathi Kundu. All rights reserved.\n- **License**: MIT License - see [LICENSE](https://github.com/pxkundu/awdx/blob/development/LICENSE) for details\n- **Trademark**: \"AWDX\" and \"AWS DevOps X\" are trademarks of Partha Sarathi Kundu\n\n### Citation\nIf you use AWDX in academic research or commercial projects, please cite:\n\n```\nKundu, P. S. (2024). AWDX: AWS DevOps X - Gen AI-powered AWS DevSecOps CLI tool. \nGitHub. https://github.com/pxkundu/awdx\n```\n\nFor academic papers (BibTeX):\n```bibtex\n@software{awdx2024,\n author = {Kundu, Partha Sarathi},\n title = {AWDX: AWS DevOps X - Gen AI-powered AWS DevSecOps CLI tool},\n year = {2024},\n url = {https://github.com/pxkundu/awdx},\n note = {MIT License}\n}\n```\n\n### Contact\n- **Email**: inboxkundu@gmail.com\n- **GitHub**: [@pxkundu](https://github.com/pxkundu)\n- **Project**: [https://github.com/pxkundu/awdx](https://github.com/pxkundu/awdx)\n\n### Support & Troubleshooting\n- **\ud83d\udcd6 Troubleshooting Guide**: [TROUBLESHOOTING.md](TROUBLESHOOTING.md) - Common issues and solutions\n- **\ud83d\udc1b Issues**: [GitHub Issues](https://github.com/pxkundu/awdx/issues)\n- **\ud83d\udcac Discussions**: [GitHub Discussions](https://github.com/pxkundu/awdx/discussions)\n\n### Contributors\nSee [AUTHORS.md](https://github.com/pxkundu/awdx/blob/development/AUTHORS.md) for a complete list of contributors and their contributions. \n",
"bugtrack_url": null,
"license": null,
"summary": "AWS DevOps X: Gen AI-powered AWS DevSecOps CLI tool with natural language interface.",
"version": "0.0.15",
"project_urls": {
"Homepage": "https://github.com/pxkundu/awdx",
"Repository": "https://github.com/pxkundu/awdx"
},
"split_keywords": [
"aws",
" devops",
" devsecops",
" cli",
" cost-analysis",
" security",
" automation",
" ai",
" nlp",
" gemini",
" natural-language"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "610a696f3f7b972a65ed9d217de8ec6039c5380a8d94121665ad08ec203af5eb",
"md5": "d57c26565423d4508e641cb131fb9ac8",
"sha256": "1cb5ceb2d6344f3b24edc25a0e57303e86116f977d93478e49cdc9e17818b105"
},
"downloads": -1,
"filename": "awdx-0.0.15-py3-none-any.whl",
"has_sig": false,
"md5_digest": "d57c26565423d4508e641cb131fb9ac8",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 192306,
"upload_time": "2025-07-23T01:32:52",
"upload_time_iso_8601": "2025-07-23T01:32:52.116606Z",
"url": "https://files.pythonhosted.org/packages/61/0a/696f3f7b972a65ed9d217de8ec6039c5380a8d94121665ad08ec203af5eb/awdx-0.0.15-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "6a4fc995a18facf173b890631158f1d1de47ceaf86e0b709fa6a4e2cabfa9e7f",
"md5": "92605d02e26861fddf64078481ae0821",
"sha256": "f931b9732c413c7921554a0b068c1b30d8ce2e186102b021a5691496faa36f01"
},
"downloads": -1,
"filename": "awdx-0.0.15.tar.gz",
"has_sig": false,
"md5_digest": "92605d02e26861fddf64078481ae0821",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 203279,
"upload_time": "2025-07-23T01:32:53",
"upload_time_iso_8601": "2025-07-23T01:32:53.308697Z",
"url": "https://files.pythonhosted.org/packages/6a/4f/c995a18facf173b890631158f1d1de47ceaf86e0b709fa6a4e2cabfa9e7f/awdx-0.0.15.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-07-23 01:32:53",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "pxkundu",
"github_project": "awdx",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "awdx"
}
JSON
