Getting Started
What can I use for?
automates code modernization, including:- Language upgrades — Python 2 to 3, Java 8 to 21
- Language translations — Ada to C++, COBOL to Java
- Framework migrations — AngularJS to React, Express to FastAPI
- Architecture modernization — Refactoring to modern patterns
Does modify my original code?
No. Your original repository is never modified:- Organization repositories: creates a new repository for the migrated code
- Personal repositories: Changes go to a new branch (
{branch}-modelcode-ai)
What languages does support?
supports a wide range of languages including:- Python, Java, JavaScript, TypeScript
- C, C++, C#, Go, Rust
- Ada, COBOL, Kotlin, PHP
- And more
The Migration Process
How long does a migration take?
It depends on:- Repository size
- Complexity of the transformation
- How quickly you review and merge PRs
Can I stop a migration partway through?
Yes. Milestones are independent once merged. You can:- Stop after any milestone
- Continue later
- Choose not to proceed with remaining milestones
What if I don’t like the generated code?
Every milestone produces a Pull Request that you review before merging:- Make manual edits — Change anything in the PR
- Request regeneration — Close the PR and retry with edited milestone
- Create rules — Prevent the issue in future milestones
Why are milestones sequential?
Each milestone builds on the previous one. The code generated in Milestone 2 assumes Milestone 1’s changes exist. Running them in parallel would create a broken codebase.Security & Privacy
Is my code secure?
Yes:- Your code is accessed only to perform the migration
- We use secure, encrypted connections
- Code is not shared with third parties
- Contact us for enterprise security requirements
Can I use with private repositories?
Yes. When connecting GitHub, grant access to specific private repositories. only accesses repositories you explicitly authorize.Where does the migrated code go?
- For organization repos: A new repository in your organization
- For personal repos: A branch in your existing repository
Instructions & Rules
What’s the difference between Instructions and Rules?
| Instructions | Rules |
|---|---|
| Define the overall migration goal | Define coding standards and patterns |
| Set once at project start | Added anytime during migration |
| Describe what to migrate | Describe how to write code |
| Approved, then locked | Can be edited or deleted |
Can I change Instructions after approval?
No. Approved instructions are locked because they’re the foundation for all generated milestones. If you need different instructions:- Create rules to influence how milestones execute
- Edit individual milestones before generating their tasks
- For major changes, consider starting a new project
When should I create a Rule?
Create rules when you:- Know exactly what you want (coding conventions, library choices)
- See the same issue across multiple milestones
- Have company standards that must be followed
- Want to prevent specific patterns in generated code
Milestones
Can I edit a milestone after tasks are generated?
No. Once tasks are generated, the milestone is locked for that execution. To make changes:- Let the execution complete
- Review the PR
- Make manual edits to the PR, or
- Close the PR and edit the milestone for a fresh execution
What if a milestone fails?
- Check the error message
- Click Retry Execute
- If it keeps failing, review the milestone description for issues
- Contact support with the error details if needed
Can I skip a milestone?
No. Milestones must complete in order because each builds on the previous. You can, however, edit a milestone to effectively no-op it if needed.Technical
What happens to my tests?
can:- Migrate existing tests to the new framework
- Generate new tests for migrated code
What about dependencies?
handles dependency updates:- Identifies equivalent packages in the target ecosystem
- Updates import statements
- Generates new dependency configuration (package.json, requirements.txt, etc.)
Does handle database migrations?
For schema changes, can generate migration files (e.g., Alembic for Python). Specify database migration requirements in your instructions or rules.What about environment variables and config?
Configuration files are migrated based on your instructions. Specify any special handling needed in your modernization goal or rules.Billing & Accounts
Is there a free tier?
Contact sales@modelcode.ai for current pricing and trial options.Can multiple team members use one project?
Team features are available for enterprise accounts. Contact us for details.Getting Help
How do I contact support?
Email support@modelcode.ai with:- Your project name
- Description of the issue
- Any error messages
- Screenshots if helpful