What is Morphaius

MorphAIus is an intelligent application generator that utilizes AI to create complete, functional applications based on user descriptions. It employs the OpenRouter API to access various AI models and provides a modern Flask web interface for interaction.

Use cases

Use cases for MorphAIus include generating prototypes for startups, creating educational tools for coding classes, developing personal projects quickly, and assisting developers in generating boilerplate code.

How to use

To use MorphAIus, clone the repository, set up your environment, and configure your OpenRouter API key. You can run the application using either Pipenv or pip, and access it through your web browser at http://localhost:5000.

Key features

Key features of MorphAIus include AI-powered code generation, a modern responsive web interface, multi-technology support (static sites, web apps, REST APIs), MCP integration for enhanced generation, built-in frameworks like Bootstrap and Tailwind CSS, and automatic code validation.

Where to use

MorphAIus can be used in various fields such as web development, application prototyping, educational purposes, and any scenario where rapid application development is required.

🚀 MorphAIus - AI Application Generator

MorphAIus is an intelligent application generator that uses AI to create complete, functional applications based on your descriptions. It leverages the OpenRouter API to access multiple AI models (GPT-4, Claude, Llama, etc.) and generates applications with a modern Flask web interface.

✨ Features

• AI-powered code generation: Describe your app, get complete working code
• Modern web interface: Responsive dashboard with real-time preview
• Multi-technology support: Static sites, web apps, REST APIs, and more
• MCP integration: Enhanced generation with web search and documentation tools
• Built-in frameworks: Bootstrap, Tailwind CSS, Material Design support
• Code validation: Automatic verification and error correction

📋 Prerequisites

• Python 3.8+
• Node.js 16+ and npm - Required for RepoMix codebase analysis
  • Download from Node.js official website
  • Verify installation: node --version and npm --version
• RepoMix (required for codebase analysis)
  • Install globally: npm install -g repomix
  • Verify installation: repomix --help
• OpenRouter API Key - Get one at OpenRouter
• Git (optional, for cloning)

🛠️ Installation

0. Install RepoMix (required for codebase analysis)

Before running the project, make sure RepoMix is installed globally:

npm install -g repomix

You can verify the installation with:

repomix --help

Option 1: Using Pipenv (Recommended)

1. Clone and setup:

   git clone https://github.com/Pedal0/MorphAIus.git
   cd MorphAIus
   pip install pipenv  # If you don't have pipenv
   pipenv install
   

2. Configure API key:
   Create a .env file:

   OPENROUTER_API_KEY=your_openrouter_api_key
   

Option 2: Using pip

1. Clone and setup:

   git clone https://github.com/Pedal0/MorphAIus.git
   cd MorphAIus
   python -m venv venv
   
   # Windows
   venv\Scripts\activate
   # Linux/macOS
   source venv/bin/activate
   
   pip install -r requirements.txt
   

2. Configure API key:
   Create a .env file:

   OPENROUTER_API_KEY=your_openrouter_api_key
   

🚀 Usage

With Pipenv

pipenv shell
python run.py

With pip

# Activate virtual environment first (if using)
# Windows: venv\Scripts\activate
# Linux/macOS: source venv/bin/activate

python run.py

Access the app: Open http://localhost:5000 in your browser

📖 How it Works

1. Describe your app: Use the web interface to describe what you want to build
2. Configure options: Choose UI framework, project type, and other settings
3. AI generation: The system generates complete, working code
4. Preview & download: Review your app and download the generated files

🔧 Technologies Used

• Backend: Flask, OpenRouter API, MCP (Model Context Protocol)
• Frontend: Bootstrap 5, JavaScript ES6+, Font Awesome
• AI Models: GPT-4, Claude, Llama (via OpenRouter)
• Tools: Web search, documentation lookup, code validation

🎯 Supported Application Types

MorphAIus can generate various types of applications:

• Static Websites: Portfolios, landing pages, business sites, blogs
• Web Applications: CRUD apps, dashboards, e-commerce, social platforms
• APIs & Services: REST APIs, microservices, authentication systems
• Templates: Responsive designs with modern UI frameworks

💡 Example Prompts

Portfolio Website

Create a modern portfolio website for a web developer with:
- Homepage with intro and photo
- Projects section with interactive gallery
- About page with skills and experience
- Contact form
- Responsive design

Task Management App

Build a task management application with:
- User authentication
- Create, edit, delete tasks
- Categories and priorities
- Due dates and notifications
- Modern Trello-like interface

🔧 Troubleshooting

API Key Error:

• Check your OpenRouter API key in the .env file
• Ensure the key is valid and active

Dependency Issues:

# With Pipenv
pipenv install flask openai python-dotenv

# With pip
pip install flask openai python-dotenv

Port Already in Use:

• Default port is 5000, modify in run.py if needed

Generation Problems:

• Check internet connection
• Try simpler prompts first
• Check logs in logs/app_flask.log

📦 Building Executable (Optional)

Create a standalone executable:

pipenv install pyinstaller
pipenv shell
pyinstaller launcher.spec

The executable will be in dist/MorphAIus.exe

📄 License

This project is licensed under the GNU General Public License v3.0 - see the LICENSE file for details.

🤝 Contributing

Contributions are welcome! Feel free to:

• Report bugs
• Suggest new features

🔗 Useful Links

• OpenRouter - AI API Platform
• Flask Documentation - Web Framework
• Bootstrap 5 - CSS Framework
• Model Context Protocol - MCP Protocol

⭐ Don’t forget to star the project if you find it useful!