engy


Nameengy JSON
Version 0.0.9 PyPI version JSON
download
home_pageNone
SummaryEngy is an AI-powered development tool that generates fully functional web applications from natural language, streamlining the process from idea to working prototype.
upload_time2024-11-04 21:17:25
maintainerNone
docs_urlNone
authorNone
requires_python>=3.7
licenseNone
keywords setuptools development
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            # 🚀 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:
```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
   ```

   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:
   ```bash
   echo "MODEL=gpt-4" >> .env
   echo "OPENAI_API_KEY=your_openai_api_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
```

### 🔧 Refactor Your App
To refactor your app's frontend and backend into modular files:

```bash
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:

```bash
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

- [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)
- [Calculator 2](examples/basic_tools/calculator_2)
- [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)
- [Landing Page finae.ai](examples/basic_tools/landing_page)
- [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

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](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!

            

Raw data

            {
    "_id": null,
    "home_page": null,
    "name": "engy",
    "maintainer": null,
    "docs_url": null,
    "requires_python": ">=3.7",
    "maintainer_email": "Ning Ren <renning22@gmail.com>",
    "keywords": "setuptools, development",
    "author": null,
    "author_email": "Ning Ren <renning22@gmail.com>",
    "download_url": "https://files.pythonhosted.org/packages/c3/c1/e35c3a4a4162561fad1a7b190764c30690dfa40337852ac722d4d37f1f69/engy-0.0.9.tar.gz",
    "platform": null,
    "description": "# \ud83d\ude80 Engy: Your AI-Powered App Generator\n\n## \ud83c\udf1f Welcome to the Post-LLM Era of App Development\n\nIn 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! \ud83e\udd16\ud83d\udcbb\u2728 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.\n\nSay 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.\n\n### \ud83d\udee0\ufe0f Versatile App Generation\nEngy can help you create a variety of applications, including (but not limited to):\n- \ud83d\udcdd Productivity tools and task managers\n- \ud83d\uddc2\ufe0f Data organization and management systems\n- \ud83c\udf10 Web scrapers and data collectors\n- \ud83d\udcca Simple data visualization tools\n\n\n## \ud83d\udea6 Quick Start Guide\n\n### \ud83d\udd27 Installation\nGet started with:\n```bash\npip install engy\n```\n\n### \ud83c\udf89 Create Your App\n\n1. Set up your project:\n   ```bash\n   mkdir my_awesome_app && cd my_awesome_app\n   ```\n\n2. Describe your app idea:\n   ```bash\n   echo \"create a calculator\" > input.txt\n   ```\n\n3. Add your API key:\n   ```bash\n   echo \"ANTHROPIC_API_KEY=your_super_secret_key\" > .env\n   ```\n\n   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:\n   ```bash\n   echo \"MODEL=gpt-4\" >> .env\n   echo \"OPENAI_API_KEY=your_openai_api_key\" >> .env\n   ```\n\n4. Let Engy work its magic:\n   ```bash\n   engy\n   ```\n\n### \ud83c\udfc3\u200d\u2642\ufe0f Run Your New App\nEngy provides a ready-to-go script:\n```bash\nbash run.sh\n```\n\n### \ud83c\udf08 Enhance Your App with More Features\n\n1. Describe your new feature:\n   ```bash\n   echo \"make the calculator support calculus and algebra\" > feature.txt\n   ```\n\n2. Let Engy implement it:\n   ```bash\n   engy feature\n   ```\n\n### \ud83c\udfa8 Fine-tune Your Backend and Frontend\nTweak your app's functionality or user interface:\n\n```bash\nengy backend\n# Enter prompts to optimize your data handling or add new processing features\n```\n\n```bash\nengy frontend\n# Enter prompts to enhance your UI or add new interactive elements\n```\n\n### \ud83d\udd27 Refactor Your App\nTo refactor your app's frontend and backend into modular files:\n\n```bash\nengy split\n```\n\nThis command will reorganize your code structure for better maintainability and scalability.\n\n### \ud83e\uddec Clone an Existing App\nTo create a new app based on an existing one:\n\n```bash\nmkdir my_app_2 && cd my_app_2\necho \"new changes...\" > input.txt\nengy clone /path/to/my_app\n```\n\n## \ud83c\udf1f Example Showcase\n\nEngy 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:\n\n\n### \ud83c\udfa8 Demo Applications\n\n- [Account Manager](examples/demo/account_manager)\n- [PDF Merger](examples/demo/pdf_merger)\n- [Web Scraper](examples/demo/scraper_1)\n\n\n### \ud83d\udee0\ufe0f Basic Tools\n\n- [Airtable CRM](examples/basic_tools/airtable_crm_1)\n- [Calculator](examples/basic_tools/calculator)\n- [Calculator 2](examples/basic_tools/calculator_2)\n- [Daughter School Planner](examples/basic_tools/daughter_school)\n- [Docker Containers Manager](examples/basic_tools/docker_containers)\n- [Document Summary Agent](examples/basic_tools/doc_summary_agent)\n- [Dota 2 Hero Agent](examples/basic_tools/dota2_hero_agent)\n- [Email Summary Agent](examples/basic_tools/email_summary_agent)\n- [Expense Tracker](examples/basic_tools/expense_tracker)\n- [GCP Tool](examples/basic_tools/gcp_tool_1)\n- [Invoice Creator (Version 1)](examples/basic_tools/invoice_creator)\n- [Invoice Creator (Version 2)](examples/basic_tools/invoice_creator_2)\n- [Kubernetes Pods Manager](examples/basic_tools/k8s_pods)\n- [Landing Page finae.ai](examples/basic_tools/landing_page)\n- [Trip Planner (Hawaii)](examples/basic_tools/plan_a_trip_hawaii)\n- [Sales Revenue Dashboard](examples/basic_tools/sales_revenue_dashboard)\n- [Text Diff Tool](examples/basic_tools/text_diff)\n- [Video Format Converter](examples/basic_tools/video_format_converter)\n- [Voice Note Taker](examples/basic_tools/voice_note_taker)\n- [Web3 Explorer (Version 1)](examples/basic_tools/web3_explorer_1)\n- [Web3 Explorer (Version 2)](examples/basic_tools/web3_explorer_2)\n- [Weeks in Life Visualizer](examples/basic_tools/weeks_in_life)\n- [Meal Planner (Version 1)](examples/basic_tools/what_to_eat)\n- [Meal Planner (Version 2)](examples/basic_tools/what_to_eat_2)\n- [YouTube Video Manager](examples/basic_tools/yt_videos)\n\n\n### \ud83d\ude80 Advanced Examples\n\n- [Account Manager](examples/advance/account_manager)\n- [Customer Insights Dashboard](examples/advance/customer_insights_dashboard)\n- [Customer Experience Insights](examples/advance/cx_insights)\n- [Edit Airtable](examples/advance/edit_airtable)\n- [Edit Airtable with Dashboard](examples/advance/edit_airtable_dash)\n- [Food Delivery Tracker](examples/advance/food_delivery_tracker)\n- [Product Roadmap](examples/advance/product_roadmap)\n- [SLA Dashboard](examples/advance/sla_dashboard)\n\n## \ud83d\udee0\ufe0f Contribute\n\nThis repo is created and mainly maintained by two passionate engineers:\n\n- @renning22: ex-MLE at Pony.AI, ex-Googler\n- @mincomp: MLE at ScaleAI, ex-Meta, ex-Uber\n\nThey envision and practice that tedious low-level coding work can be replaced by AI.\n\nAny contribution is welcomed! Create issue/PR and at us!\n\n## \ud83d\udcdc License\n\nDistributed under the MIT License. See [LICENSE](LICENSE) for more information.\n\n\n## \ud83c\udd98 Need Help with Your App?\n\nIf 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!\n",
    "bugtrack_url": null,
    "license": null,
    "summary": "Engy is an AI-powered development tool that generates fully functional web applications from natural language, streamlining the process from idea to working prototype.",
    "version": "0.0.9",
    "project_urls": {
        "Bug Reports": "https://github.com/renning22/engy/issues",
        "Funding": "https://github.com/renning22/engy",
        "Homepage": "https://github.com/renning22/engy",
        "Say Thanks!": "https://github.com/renning22/engy",
        "Source": "https://github.com/renning22/engy"
    },
    "split_keywords": [
        "setuptools",
        " development"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "157d76986e793feef80d9834ae20e10b576a703b6446d4fcfe2dafcb1bfa878c",
                "md5": "86b5f8ef00fc704c2ed3d35e646c6d84",
                "sha256": "8e29a59180ffd880864e0c1b96da59f9b57c8ba2af8bd2a2245135e3e1a2b8bc"
            },
            "downloads": -1,
            "filename": "engy-0.0.9-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "86b5f8ef00fc704c2ed3d35e646c6d84",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.7",
            "size": 21603,
            "upload_time": "2024-11-04T21:17:23",
            "upload_time_iso_8601": "2024-11-04T21:17:23.405003Z",
            "url": "https://files.pythonhosted.org/packages/15/7d/76986e793feef80d9834ae20e10b576a703b6446d4fcfe2dafcb1bfa878c/engy-0.0.9-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "c3c1e35c3a4a4162561fad1a7b190764c30690dfa40337852ac722d4d37f1f69",
                "md5": "9822325fdd0ed9a2531a73fab95e4790",
                "sha256": "b79c6106bf8310b84a79f851bd863e174153fd7759161c13384f49883aca7289"
            },
            "downloads": -1,
            "filename": "engy-0.0.9.tar.gz",
            "has_sig": false,
            "md5_digest": "9822325fdd0ed9a2531a73fab95e4790",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.7",
            "size": 22158,
            "upload_time": "2024-11-04T21:17:25",
            "upload_time_iso_8601": "2024-11-04T21:17:25.832991Z",
            "url": "https://files.pythonhosted.org/packages/c3/c1/e35c3a4a4162561fad1a7b190764c30690dfa40337852ac722d4d37f1f69/engy-0.0.9.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2024-11-04 21:17:25",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "renning22",
    "github_project": "engy",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": false,
    "lcname": "engy"
}
        
Elapsed time: 0.56752s