damiannogueiras / ainodes-engine

aiNodes Engine

aiNodes is a simple and easy-to-use Python-based AI image / motion picture generator node engine.

A desktop ai centered node engine with a live execution chain, python code editor node, and plug-in support, officially supported by Deforum. We are thankful for many great functions adapted from ComfyUI, and various open-source projects, that make this framework possible to exist.

Please consider becoming a patron if you like this project. There are no benefits or restrictions, but it helps the process greatly. Updates are frequent, and the more time I can spare on the project, the greater things can be implemented. Thank you for being here!

📚 Table of Contents

• Introduction
• Installation / Running the App
• Contributing
• Features
• License

🚀 Introduction

• Full modularity - download node packs on runtime
• RIFE (Real-Time Intermediate Flow Estimation) support
• FILM interpolation integration
• Coloured background drop
• Easy node creation with IDE annotations

🔧 Install / Running the App

To get started with aiNodes, follow the steps below:

Requirements:

1. Python 3.10 (https://www.python.org/ftp/python/3.10.0/python-3.10.0-amd64.exe)
2. Git (https://github.com/git-for-windows/git/releases/download/v2.40.1.windows.1/Git-2.40.1-64-bit.exe)
3. nVidia GPU with CUDA and drivers installed

Windows:

1. Download the 1 Click Installer from the releases on the right menu and run it in a folder of your choice
2. It will create a virtual environment, and install all dependencies, to start next time, you can use the shortcut on your Desktop.

Linux:

git clone https://github.com/XmYx/ainodes-engine
cd ainodes-engine
pip install virtualenv
python -m virtualenv nodes_env -p=3.10
source nodes_env/bin/activate
pip install -r requirements.txt
cd custom_nodes
git clone https://github.com/XmYx/ainodes_engine_base_nodes
cd ainodes_engine_base_nodes
pip install -r requirements.txt
cd ..
git clone https://github.com/XmYx/ainodes_engine_deforum_nodes
cd ainodes_engine_deforum_nodes
pip install -r requirements.txt

MacOs:

git clone https://github.com/XmYx/ainodes-engine
cd ainodes-engine
pip install virtualenv
python -m virtualenv nodes_env -p=3.10
source nodes_env/bin/activate
pip install -r requirements.txt
cd custom_nodes
git clone https://github.com/XmYx/ainodes_engine_base_nodes
cd ainodes_engine_base_nodes
pip install torch torchvision
pip install -r requirements_mac.txt

launch with:

source nodes_env/bin/activate
python main.py

Once the app is up and running, you can start check the File - Example Graphs option to start creating, and you can also access your model folders from the File menu.

🤝 Contributing

Contributions to the Ainodes Engine are welcome and appreciated. If you find any bugs or issues with the app, please feel free to open an issue or submit a pull request.

🙌 Features

aiNodes is an open source desktop ai based image / motion generator, editor suite designed to be flexible, and with an Unreal-like execution chain. It natively supports:

1. Deforum
2. Stable Diffusion 1.5 / 2.0 / 2.1
3. Upscalers
4. Kandinsky
5. ControlNet
6. LORAs
7. Ti Embeddings
8. Hypernetworks
9. Background Separation
10. Human matting / masking
11. Compositing
12. Drag and Drop (from discord too)
13. Subgraphs
14. Graph saving as metadata in the image file
15. Graph loading from image metadata

This project came to life thanks to many great backend functions borrowed from ComfyUI, and adapted to work in this unique, live, controllable manner with a strict user declared execution chain, leading to data values possible to be iterated at different points in time in your pipeline.

💖 Support the project

This project is made possible thanks to the wonderful open-source community. If you appreciate the work put into this project and would like to contribute to its continued development and maintenance, please consider becoming a patron.

Your support is greatly appreciated!

📄 License

This project is licensed under the L-GPL License. See the LICENSE file for details.