☁️ Cloud Insight AI

AI-powered AWS cost and log analysis - Use as a Python library OR web dashboard

---

🎯 Two Ways to Use

1️⃣ Python Library (Pip Install)

Use Cloud Insight AI in your Python code for programmatic analysis.

2️⃣ Web Dashboard (Cloud-Based)

Run the interactive web interface for visual analysis and insights.

---

📦 Library Mode (Pip Package)

Installation

pip install cloud-insight-ai

Usage

from cloud_insight_ai import CloudAnalyzer

# Analyze your data
analyzer = CloudAnalyzer()
results = analyzer.run(cost_data, logs)
cost_data = [
    {'service': 'EC2', 'date': '2025-01-01', 'cost': 150.25},
    {'service': 'S3', 'date': '2025-01-01', 'cost': 45.50},
]

logs = [
    '2025-01-01 10:00:00 [INFO] Application started',
    '2025-01-01 10:05:30 [ERROR] Connection timeout',
]

# Analyze
analyzer = CloudAnalyzer()
result = analyzer.run(cost_data, logs)

# Results
print(f"Total cost: ${result['summary']['total_cost']:.2f}")
print(f"Errors: {result['summary']['error_count']}")
print(f"Alerts: {result['summary']['alert_count']}")

---

📚 Documentation

Basic Usage

# Full analysis
analyzer = CloudAnalyzer()
result = analyzer.run(cost_data, logs)

Cost Analysis Only

from cloud_insight_ai import analyze_cost

cost_result = analyze_cost(cost_data)
print(f"Total: ${cost_result['total_cost']:.2f}")
print(f"Top service: {cost_result['highest_cost_service']}")

Log Analysis Only

from cloud_insight_ai import analyze_logs

log_result = analyze_logs(logs)
print(f"Errors: {log_result['error_count']}")
print(f"Warnings: {log_result['warning_count']}")

With Configuration

config = {
    'cost_thresholds': {
        'high_cost_service_percent': 30.0
    },
    'log_thresholds': {
        'max_error_count': 15,
        'max_warning_count': 25
    },
    'error_patterns': [
        {'name': 'Connection Issues', 'keywords': ['connection', 'timeout']},
        {'name': 'Permission Errors', 'keywords': ['AccessDenied', 'unauthorized']}
    ]
}

analyzer = CloudAnalyzer(config=config)
result = analyzer.run(cost_data, logs)

# Check alerts
for alert in result['alerts']:
    print(f"[{alert['severity'].upper()}] {alert['message']}")

---

📊 Result Structure

{
    'cost': {
        'total_cost': 280.75,
        'service_totals': {'EC2': 150.25, 'S3': 45.50, 'RDS': 85.00},
        'daily_costs': {'2025-01-01': 280.75},
        'highest_cost_service': 'EC2',
        'highest_cost': 150.25
    },
    'logs': {
        'total_entries': 100,
        'error_count': 5,
        'warning_count': 10,
        'log_levels': {'INFO': 85, 'ERROR': 5, 'WARNING': 10},
        'recommendations': '...'
    },
    'alerts': [
        {'severity': 'high', 'category': 'cost', 'message': '...'}
    ],
    'summary': {
        'total_cost': 280.75,
        'total_services': 3,
        'total_log_entries': 100,
        'error_count': 5,
        'warning_count': 10,
        'alert_count': 1
    }
}

---

🧪 Testing

# Install dev dependencies
pip install -e ".[dev]"

# Run tests
pytest

# Run with coverage
pytest --cov=cloud_insight_ai

---

🤝 Contributing

Contributions are welcome! Please see CONTRIBUTING.md for guidelines.

---

📝 License

This project is licensed under the MIT License - see the LICENSE file for details.

---

👤 Author

MUBENDIRAN

• GitHub: @MUBENDIRAN
• Email: mubiii7722@gmail.com

---

⭐ Show Your Support

If this project helped you, please consider giving it a ⭐ on GitHub!

---

Made with ❤️ by MUBENDIRAN