🚀 Engy: Your AI-Powered App Generator

🌟 Welcome to the Post-LLM Era of App Development

In a world transformed by Large Language Models, we'll never write anything from scratch again. Enter Engy, your AI companion that's revolutionizing the way we create web applications! 🤖💻✨ Whether you're a seasoned developer or a curious innovator, Engy empowers you to turn your ideas into fully-functional web apps with Python backends and HTML/JavaScript frontends - all without starting from a blank slate.

Say goodbye to the days of painstakingly coding every line. With Engy, it's like having a team of developers at your fingertips, ready to materialize your vision into reality. From simple tools to complex data analysis applications, Engy understands your intent and does the heavy lifting for you.

🛠️ Versatile App Generation

Engy can help you create a variety of applications, including (but not limited to):

📝 Productivity tools and task managers
🗂️ Data organization and management systems
🌐 Web scrapers and data collectors
📊 Simple data visualization tools

🚦 Quick Start Guide

🔧 Installation

Get started with:

pip install engy

🎉 Create Your App

Set up your project:

mkdir my_awesome_app && cd my_awesome_app

Describe your app idea:
```
echo "create a calculator" > input.txt
```

Add your API key:

echo "ANTHROPIC_API_KEY=your_super_secret_key" > .env

The default model is claude-3.5-sonnet. You can switch to any model, e.g. gpt-4 by adding the following to your .env file:

echo "MODEL=gpt-4" >> .env
echo "OPENAI_API_KEY=your_openai_api_key" >> .env

Let Engy work its magic:
```
engy
```

🏃‍♂️ Run Your New App

Engy provides a ready-to-go script:

bash run.sh

🌈 Enhance Your App with More Features

Describe your new feature:

echo "make the calculator support calculus and algebra" > feature.txt

Let Engy implement it:
```
engy feature
```

🎨 Fine-tune Your Backend and Frontend

Tweak your app's functionality or user interface:

engy backend
# Enter prompts to optimize your data handling or add new processing features

engy frontend
# Enter prompts to enhance your UI or add new interactive elements

🔧 Refactor Your App

To refactor your app's frontend and backend into modular files:

engy split

This command will reorganize your code structure for better maintainability and scalability.

🧬 Clone an Existing App

To create a new app based on an existing one:

mkdir my_app_2 && cd my_app_2
echo "new changes..." > input.txt
engy clone /path/to/my_app

🌟 Example Showcase

Engy comes with a wide range of example projects to help you get started and understand its capabilities. Here's a selection of examples organized by category:

🎨 Demo Applications

🛠️ Basic Tools

🚀 Advanced Examples

🛠️ Contribute

This repo is created and mainly maintained by two passionate engineers:

@renning22: ex-MLE at Pony.AI, ex-Googler
@mincomp: MLE at ScaleAI, ex-Meta, ex-Uber

They envision and practice that tedious low-level coding work can be replaced by AI.

Any contribution is welcomed! Create issue/PR and at us!

📜 License

Distributed under the MIT License. See LICENSE for more information.

🆘 Need Help with Your App?

If you're having trouble generating your app or encountering any issues, don't hesitate to reach out! Feel free to open an issue on our GitHub repository or contact us directly at renning22@gmail.com. We're very happy to pilot you and give help. We're here to help you bring your app ideas to life with Engy!

WinDB3ll/engy