Cloudify - Automated Cloud Migration System

Automated migration of local applications to Google Cloud Platform using AI agents

Cloudify is an intelligent, multi-agent system built with Dedalus AI that automates the complete migration process from local development to Google Cloud Platform. Perfect for hackathons and rapid prototyping!

🌟 Features

🤖 AI-Powered Migration: Uses Claude AI for intelligent decision-making and recommendations
🔄 Event-Driven Architecture: Agents communicate via publish-subscribe pattern
📊 Real-Time Progress: Beautiful CLI with live progress tracking using Rich
🛡️ Safe Execution: Comprehensive error handling and validation
🎯 Zero Configuration: Works out-of-the-box with sensible defaults
🚀 One Command Deployment: Migrate entire stack with a single command

🏗️ Architecture

Cloudify uses a multi-agent system where each agent handles a specific migration task:

┌─────────────────────────────────────────────────────────────┐
│                   ORCHESTRATOR AGENT                        │
│         (Coordinates all agents via event bus)              │
└────────┬────────────────────────────────────────────────────┘
         │
    ┌────┴─────┬──────────┬──────────────┬──────────────┐
    │          │          │              │              │
┌───▼───┐  ┌──▼───┐  ┌───▼────┐  ┌──────▼─────┐  ┌────▼────┐
│ Code  │  │Infra │  │Database│  │  Backend   │  │Frontend │
│Analyze│─▶│Prov. │─▶│Migrat. │─▶│ Deployment │  │Deploym. │
└───────┘  └──────┘  └────────┘  └────────────┘  └─────────┘
                                         │              │
                                         ▼              ▼
                                   Cloud Run      Firebase
                                                   Hosting

Agent Responsibilities

Code Analyzer Agent
- Scans Spring Boot application.properties
- Detects database configuration (H2, MySQL, PostgreSQL)
- Identifies API endpoints and CORS settings
- Analyzes React app for API configurations
- Outputs migration requirements report
Infrastructure Provisioning Agent
- Creates GCP project resources using gcloud CLI
- Sets up Cloud Run service
- Configures Artifact Registry
- Sets up Firebase project for hosting
- Manages IAM permissions
Database Migration Agent
- Analyzes H2 database mode (in-memory vs file-based)
- Recommends Cloud SQL setup OR keeps H2 with warnings
- Optionally migrates data to Cloud SQL
- Updates Spring Boot datasource configuration
Backend Deployment Agent
- Generates optimized Dockerfile for Spring Boot
- Updates application properties with GCP configurations
- Builds Docker image
- Pushes to Artifact Registry
- Deploys to Cloud Run
- Configures environment variables
Frontend Deployment Agent
- Detects React build configuration (Vite/CRA)
- Updates API endpoint to Cloud Run URL
- Builds React production bundle
- Deploys to Firebase Hosting
- Configures custom domain if provided

📋 Prerequisites

Before using Cloudify, ensure you have the following installed:

Required

Python 3.10+ (Download)
Google Cloud SDK (Install Guide)
Docker (Install Guide)
Node.js 18+ and npm (Download)

API Keys

Dedalus API Key (primary) (Get one here)
Anthropic Claude API Key (fallback if Dedalus key not set) (Get one here)

🚀 Quick Start

1. Clone the Repository

git clone <your-repo-url>
cd Cloudify

2. Install Dependencies

# Create virtual environment
python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

# Install dependencies
pip install -r requirements.txt

3. Configure Environment Variables

# Copy example environment file
cp .env.example .env

# Edit .env and add your API keys
DEDALUS_API_KEY=your-dedalus-api-key-here
ANTHROPIC_API_KEY=your-claude-api-key-here  # fallback if DEDALUS_API_KEY not set

4. Set Up GCP Authentication

# Login to GCP
gcloud auth login

# Set your project
gcloud config set project YOUR_PROJECT_ID

# Configure Docker for Artifact Registry
gcloud auth configure-docker us-central1-docker.pkg.dev

5. Initialize Configuration

python migration_orchestrator.py init

This creates a migration_config.yaml template. Edit it with your settings:

source:
  path: "./BasicApp"  # Path to your application

gcp:
  project_id: "cloudify-486706"
  region: "us-central1"

migration:
  mode: "interactive"  # or "automated"

6. Run Migration

python migration_orchestrator.py migrate \
  --source-path /Users/anmolsahu2k/Stuff/Create/TartanHacks/BasicApp \
  --gcp-project cloudify-486706 \
  --region us-central1

Or use the config file:

python migration_orchestrator.py migrate --config migration_config.yaml

📖 Usage

Command-Line Options

python migration_orchestrator.py migrate [OPTIONS]

Options:
  -s, --source-path PATH      Path to source application directory
  -c, --config PATH           Path to migration configuration file
  -p, --gcp-project TEXT      GCP project ID (overrides config)
  -r, --region TEXT           GCP region (default: us-central1)
  -m, --mode TEXT             Execution mode: interactive or automated
  -d, --dry-run               Preview changes without executing
  -v, --verbose               Enable verbose logging
  --help                      Show this message and exit

Other Commands

# Initialize a new migration configuration file
python migration_orchestrator.py init

# Show version and SDK information
python migration_orchestrator.py version

Configuration File

The migration_config.yaml file controls all aspects of the migration:

# Source Application Configuration
source:
  path: "./BasicApp"
  backend:
    type: "spring-boot"
    path: "backend"
    build_tool: "maven"
    java_version: "21"
  frontend:
    type: "react"
    path: "frontend"
    build_tool: "vite"

# GCP Configuration
gcp:
  project_id: "my-project"
  region: "us-central1"

  backend:
    service_name: "expense-calculator-backend"
    memory: "1Gi"
    cpu: "1"
    min_instances: 0
    max_instances: 10
    allow_unauthenticated: true

  frontend:
    site_name: "expense-calculator-frontend"

  database:
    strategy: "keep-h2"  # or "migrate-to-cloud-sql"

# Migration Behavior
migration:
  mode: "interactive"
  dry_run: false
  verbose: true
  backup_enabled: true

# AI Configuration
ai:
  model: "claude-opus-4-6"
  temperature: 0.3

See migration_config.yaml for full configuration options.

🎯 Example Migration

Let's migrate the sample expense calculator app:

# 1. Clone the sample application
git clone https://github.com/sanathmahesh/BasicApp.git

# 2. Run migration with all defaults
python migration_orchestrator.py migrate \
  --source-path /Users/aritraraychaudhuri/Downloads/BasicApp \
  --gcp-project cloudify-486706 \
  --mode automated

# Output:
# ╔═══════════════════════════════════════════════════════════╗
# ║                      CLOUDIFY                             ║
# ║        Automated Cloud Migration to Google Cloud         ║
# ╚═══════════════════════════════════════════════════════════╝
#
# ✓ Prerequisites check passed
# ✓ Configuration valid
#
# Starting migration...
#
# ✓ CodeAnalyzer         ████████████████████ 100%  2.3s
# ✓ Infrastructure       ████████████████████ 100%  8.1s
# ✓ DatabaseMigration    ████████████████████ 100%  1.2s
# ✓ BackendDeployment    ████████████████████ 100% 45.7s
# ✓ FrontendDeployment   ████████████████████ 100% 32.4s
#
# Migration completed successfully! ✓
#
# Deployment URLs:
#   • Backend API:  https://expense-calculator-backend-abc123-uc.a.run.app
#   • Frontend App: https://my-gcp-project.web.app

🧪 Testing

Run unit tests:

pytest tests/unit -v

Run integration tests (requires GCP credentials):

pytest tests/integration -v

📁 Project Structure

Cloudify/
├── agents/
│   ├── __init__.py
│   ├── base_agent.py              # Base agent class with event handling
│   ├── orchestrator.py            # Main orchestrator agent
│   ├── code_analyzer.py           # Code analysis agent
│   ├── infrastructure.py          # GCP infrastructure provisioning
│   ├── database_migration.py      # Database migration logic
│   ├── backend_deployment.py      # Backend to Cloud Run
│   ├── frontend_deployment.py     # Frontend to Firebase
│   └── dedalus_tools.py           # Dedalus SDK tool definitions
├── utils/
│   ├── __init__.py
│   ├── gcp_helpers.py             # GCP API helpers
│   ├── file_operations.py         # File I/O utilities
│   └── logger.py                  # Logging configuration
├── templates/
│   ├── Dockerfile.spring-boot.template
│   └── cloudbuild.yaml
├── tests/
│   ├── unit/
│   └── integration/
├── frontend/                      # Sample frontend application
├── migration_orchestrator.py      # Main CLI entry point
├── migration_config.yaml          # Configuration template
├── requirements.txt               # Python dependencies
├── setup.py                       # Package setup
├── quickstart.sh                  # Quick start script
├── .env.example                   # Environment variables template
├── ARCHITECTURE.md                # Architecture documentation
├── CONTRIBUTING.md                # Contributing guide
├── PROJECT_SUMMARY.md             # Project summary
├── LICENSE                        # MIT License
└── README.md                      # This file

🔧 Advanced Configuration

Database Migration Strategies

Keep H2 (Default for Development)

gcp:
  database:
    strategy: "keep-h2"

Note: H2 in-memory database will lose data on container restart. Only suitable for development/testing.

Migrate to Cloud SQL

gcp:
  database:
    strategy: "migrate-to-cloud-sql"
    cloud_sql:
      instance_name: "my-database"
      database_name: "appdb"
      tier: "db-f1-micro"
      database_version: "POSTGRES_15"

Custom Environment Variables

gcp:
  backend:
    env_vars:
      SPRING_PROFILES_ACTIVE: "prod"
      CUSTOM_VAR: "value"

Parallel vs Sequential Deployment

migration:
  agents:
    parallel_execution: true  # Deploy backend and frontend simultaneously

🤝 Contributing

Contributions are welcome! Please follow these steps:

Fork the repository
Create a feature branch (git checkout -b feature/amazing-feature)
Commit your changes (git commit -m 'Add amazing feature')
Push to the branch (git push origin feature/amazing-feature)
Open a Pull Request

📝 License

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

🙏 Acknowledgments

Dedalus AI for the agent framework
Anthropic for the Claude API
Google Cloud Platform for cloud infrastructure
TartanHacks for the hackathon opportunity

🐛 Troubleshooting

Common Issues

1. Authentication Errors

# Re-authenticate with GCP
gcloud auth login
gcloud auth application-default login

2. Docker Build Fails

# Ensure Docker daemon is running
docker ps

# Check Docker authentication
gcloud auth configure-docker

3. Firebase Deployment Fails

# Login to Firebase
firebase login

# Check project association
firebase projects:list

4. API Key Not Found

# Check environment variables
echo $ANTHROPIC_API_KEY

# Make sure .env is loaded
source .env  # or restart your terminal

Debug Mode

Enable verbose logging for detailed information:

python migration_orchestrator.py migrate --verbose

📚 Resources

🎓 Learn More

How It Works

Code Analysis: Claude AI analyzes your application structure and generates migration recommendations
Infrastructure Setup: Automated GCP resource provisioning with proper IAM permissions
Containerization: Optimized multi-stage Docker builds for minimal image size
Deployment: Parallel deployment to Cloud Run and Firebase Hosting
Configuration: Automatic environment variable injection and API endpoint updates

Event-Driven Architecture

Agents communicate via an event bus using the publish-subscribe pattern:

# Agent publishes event
await event_bus.publish(Event(
    event_type=EventType.BACKEND_DEPLOYED,
    source_agent="BackendDeployment",
    data={"service_url": "https://..."}
))

# Other agents subscribe
event_bus.subscribe(EventType.BACKEND_DEPLOYED, callback)

This allows for:

Loose coupling between agents
Easy addition of new agents
Parallel execution where possible
Clear dependency management

💡 Tips & Best Practices

Always run in dry-run mode first:

python migration_orchestrator.py migrate --dry-run

Enable backups for safety:
```
migration:
  backup_enabled: true
```
Use interactive mode for manual approval:
```
migration:
  mode: "interactive"
```
Monitor costs with Cloud Billing alerts
Review generated Dockerfiles before production use
Set up CI/CD with the provided cloudbuild.yaml

🚀 What's Next?

Future enhancements planned:

Support for additional frameworks (Django, Express.js)
Multi-cloud support (AWS, Azure)
Database data migration tools
Web dashboard for migration monitoring
Cost optimization recommendations
Automated testing post-migration
Rollback capabilities

Built with ❤️ for TartanHacks 2026

For questions or support, please open an issue on GitHub.

Name		Name	Last commit message	Last commit date
Latest commit History 28 Commits
agents		agents
frontend		frontend
templates		templates
tests		tests
utils		utils
web_backend		web_backend
web_ui		web_ui
.env.example		.env.example
.gitignore		.gitignore
ARCHITECTURE.md		ARCHITECTURE.md
CONTRIBUTING.md		CONTRIBUTING.md
LICENSE		LICENSE
PROJECT_SUMMARY.md		PROJECT_SUMMARY.md
README.md		README.md
evidence_pack.json		evidence_pack.json
migration_config.yaml		migration_config.yaml
migration_orchestrator.py		migration_orchestrator.py
quickstart.sh		quickstart.sh
requirements.txt		requirements.txt
setup.py		setup.py

Folders and files

Latest commit

History

Repository files navigation

Cloudify - Automated Cloud Migration System

🌟 Features

🏗️ Architecture

Agent Responsibilities

📋 Prerequisites

Required

Recommended

API Keys

🚀 Quick Start

1. Clone the Repository

2. Install Dependencies

3. Configure Environment Variables

4. Set Up GCP Authentication

5. Initialize Configuration

6. Run Migration

📖 Usage

Command-Line Options

Other Commands

Configuration File

🎯 Example Migration

🧪 Testing

📁 Project Structure

🔧 Advanced Configuration

Database Migration Strategies

Keep H2 (Default for Development)

Migrate to Cloud SQL

Custom Environment Variables

Parallel vs Sequential Deployment

🤝 Contributing

📝 License

🙏 Acknowledgments

🐛 Troubleshooting

Common Issues

1. Authentication Errors

2. Docker Build Fails

3. Firebase Deployment Fails

4. API Key Not Found

Debug Mode

📚 Resources

🎓 Learn More

How It Works

Event-Driven Architecture

💡 Tips & Best Practices

🚀 What's Next?

About

Resources

License

Contributing

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Uh oh!

Contributors

Uh oh!

Languages

Packages