Qovery Migration AI Agent

Qovery Migration AI Agent is an app designed to facilitate the migration of applications from various platforms to Qovery. Currently, it supports migrating Heroku applications to AWS, GCP, or Scaleway using Qovery.

Why this tool?

Migrating applications from one platform to another can be a time-consuming, error-prone process and super costly $$$. Qovery Migration AI Agent aims to simplify this process by automating the generation of Terraform configurations, Dockerfiles, and other necessary files for deploying applications on Qovery.

Features

Note: This project is still in development and may not support all features yet.

Migrate Heroku/Render applications to AWS, GCP, Azure or Scaleway via Qovery
Generate Terraform configurations for Qovery deployments
Create Dockerfiles for migrated applications

Structure

The project is structured as follows:

CLI: Contains the command-line interface for the migration agent (can be used on your local machine)
Web: Contains the web interface for the migration agent (can be deployed on a server)

Environment Variables

The following environment variables are required to run the application:

Environment Variable	Description	Required
`CLAUDE_API_KEY`	Claude AI API key	Yes
`HEROKU_API_KEY`	Heroku API key	Yes if you used it
`GITHUB_TOKEN`	GitHub token to avoid being rate limited	No

How it works

The migration agent uses the Heroku (or other provider) API to fetch information about the application to be migrated. It then generates Terraform configurations for deploying the application on Qovery. The generated Terraform configurations include the necessary resources such as the application, environment, database, and other services.

graph TD
    A[Start] --> B[AI Migration Agent fetches app data from Heroku API]
    B --> C[AI Migration Agent filters out sensitive data]
    C --> D[AI Migration Agent sends non-sensitive app data to Claude AI API]
    D --> E[Claude AI generates Dockerfiles]
    E --> F[AI Migration Agent receives Dockerfiles]
    F --> G[AI Migration Agent sends non-sensitive app data to Claude AI API]
    G --> H[Claude AI generates Qovery Terraform files]
    H --> I[AI Migration Agent receives Terraform files]
    I --> J[AI Migration Agent reintegrates sensitive data as Terraform secrets]
    J --> K[Validate Terraform manifest]
    K --> L{Is manifest valid?}
    L -->|Yes| M[AI Migration Agent generates output for user review]
    L -->|No| N[Auto-remediation process]
    N --> O[Claude AI fixes Terraform errors]
    O --> K
    M --> P[User reviews and uses output]
    P --> Q[End]

    subgraph "Data Sources"
        R[Heroku API]
        S[GitHub Examples]
    end

    subgraph "Security Measure"
        T[Sensitive data kept locally]
    end

    B -.-> R
    H -.-> S
    C -.-> T
    J -.-> T