# 🚀 Engy: Your AI-Powered App Generator

## 🌟 Welcome to the Future of Rapid App Prototyping

Tired of starting from scratch every time you have a new app idea? Say hello to Engy, your versatile AI companion for creating a wide range of web applications! Whether you're building a simple tool or dreaming up a data analysis application, Engy's got your back. 🤖💻✨ It takes your ideas and transforms them into fully-functional web apps with Python backends and HTML/JavaScript frontends. It's like having a team of developers at your fingertips, ready to tackle any project you throw at them!


### 🛠️ 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:
```bash
pip install engy
```

### 🎉 Create Your App

1. Set up your project:
   ```bash
   mkdir my_awesome_app && cd my_awesome_app
   ```

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

3. Add your API key:
   ```bash
   echo "ANTHROPIC_API_KEY=your_super_secret_key" > .env
   ```

4. Let Engy work its magic:
   ```bash
   engy
   ```

### 🏃‍♂️ Run Your New App
Engy provides a ready-to-go script:
```bash
bash run.sh
```

### 🌈 Enhance Your App with More Features

1. Describe your new feature:
   ```bash
   echo "make the calculator support calculus and algebra" > feature.txt
   ```

2. Let Engy implement it:
   ```bash
   engy feature
   ```

### 🎨 Fine-tune Your Backend and Frontend
Tweak your app's functionality or user interface:

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

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

### 🧬 Clone an Existing App
To create a new app based on an existing one:

```bash
mkdir my_app_2 && cd my_app_2
echo "make change ..." > 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

- [Account Manager](examples/demo/account_manager)
- [PDF Merger](examples/demo/pdf_merger)
- [Web Scraper](examples/demo/scraper_1)


### 🛠️ Basic Tools

- [Airtable CRM](examples/basic_tools/airtable_crm_1)
- [Calculator](examples/basic_tools/calculator)
- [Daughter School Planner](examples/basic_tools/daughter_school)
- [Docker Containers Manager](examples/basic_tools/docker_containers)
- [Document Summary Agent](examples/basic_tools/doc_summary_agent)
- [Dota 2 Hero Agent](examples/basic_tools/dota2_hero_agent)
- [Email Summary Agent](examples/basic_tools/email_summary_agent)
- [Expense Tracker](examples/basic_tools/expense_tracker)
- [GCP Tool](examples/basic_tools/gcp_tool_1)
- [Invoice Creator (Version 1)](examples/basic_tools/invoice_creator)
- [Invoice Creator (Version 2)](examples/basic_tools/invoice_creator_2)
- [Kubernetes Pods Manager](examples/basic_tools/k8s_pods)
- [Trip Planner (Hawaii)](examples/basic_tools/plan_a_trip_hawaii)
- [Sales Revenue Dashboard](examples/basic_tools/sales_revenue_dashboard)
- [Text Diff Tool](examples/basic_tools/text_diff)
- [Video Format Converter](examples/basic_tools/video_format_converter)
- [Voice Note Taker](examples/basic_tools/voice_note_taker)
- [Web3 Explorer (Version 1)](examples/basic_tools/web3_explorer_1)
- [Web3 Explorer (Version 2)](examples/basic_tools/web3_explorer_2)
- [Weeks in Life Visualizer](examples/basic_tools/weeks_in_life)
- [Meal Planner (Version 1)](examples/basic_tools/what_to_eat)
- [Meal Planner (Version 2)](examples/basic_tools/what_to_eat_2)
- [YouTube Video Manager](examples/basic_tools/yt_videos)


### 🚀 Advanced Examples

- [Account Manager](examples/advance/account_manager)
- [Customer Insights Dashboard](examples/advance/customer_insights_dashboard)
- [Customer Experience Insights](examples/advance/cx_insights)
- [Edit Airtable](examples/advance/edit_airtable)
- [Edit Airtable with Dashboard](examples/advance/edit_airtable_dash)
- [Food Delivery Tracker](examples/advance/food_delivery_tracker)
- [Product Roadmap](examples/advance/product_roadmap)
- [SLA Dashboard](examples/advance/sla_dashboard)

## 🛠️ Contribute to the Magic

Want to enhance Engy's capabilities or add new features? We'd love your contributions! 🎉
Reach out to our wizard team:
- @renning22
- @mincomp

[Detailed contribution guidelines coming soon!]

## 📜 License

Distributed under the MIT License. See [LICENSE](LICENSE) for more information.


## 🆘 Need Help with Your App?

[We're preparing comprehensive documentation and support. Stay tuned!]
