Skip to content

Latest commit

 

History

History
238 lines (173 loc) · 8.56 KB

File metadata and controls

238 lines (173 loc) · 8.56 KB

Cover


Навігація


🔎 Про проєкт

DigitalGarden — це проєкт для генерації цифрових рослин за допомогою агентів що малюють кола. Окрім генерування власних рослин за геномом ви, також, можете схрещувати раніше згенеровані рослини декількома способами, після чого зберігати їх та ділитися своїми результатами.


🚀 Як запустити?

Залежності

  • 🐍 python >= 3.11: мова програмування
  • 🖼️ Pillow >= 10.3.0: використовується для малювання рослин
  • 🪴 plant_generator: використовується для генерації рослин
  • 🛠️ tools: допоміжні інструменти

Перш за все клонуйте код проєкту та перейдіть в теку з кодом:

$ git clone https://github.com/codemorphist/DigitalGarden.git --depth 1
$ cd DigitalGarden

Дійте далі відповідно до того яку операційну систему та менеджер пакетів ви використовуєте

Poetry

Проєкт використовує менеджер пакетів та залежностей Poetry, тому якщо ви хочете швидко запустити код (незалежно від того, яку операційну систему ви використовуєте) можете встановити Poetry і виконати наступні команди:

Встановіть залежності:

$ poetry install

Запустіть проєкт:

$ poetry run python app

Windows

pip

Створіть нове віртуальне середовище та встановіть залежності:

$ python -m venv venv
$ .\venv\Scripts\activate
$ pip install -r requirements.txt

Запустіть проєкт:

$ python app

conda

Якщо ви використовуєте conda створіть віртуальне середовище та активуйте його:

$ conda env create -f environment.yml
$ conda activate digitalgarden

Запустіть проєкт:

$ python app

Linux / MacOS

pip

Якщо ви використовуєте pip

Створіть нове віртуальне середовище та встановіть залежності:

$ python -m venv venv
$ source venv/bin/activate
$ pip install -r requirements.txt

Запустіть проєкт:

$ python app

conda

Якщо ви використовуєте conda створіть віртуальне середовище та активуйте його:

$ conda env create -f environment.yml
$ conda activate digitalgarden

Запустіть проєкт:

$ python app

🔥 Як використовувати?

В цій секції ви можете знайти детальну інформацію як генерувати рослини, схрещувати та зберігати їх в окремі файли.

Generate Plant

Generate Plant

Generate Plant

  1. Канвас, тут буде відображатися згенерована рослина
  2. Прогрес бар, показує на скільки згенерована рослина в поточний момент
  3. Таблиця з геномом
  4. Кнопка імпортування, імпортує геном у файл
  5. Кнопка для генерації випадкового геному
  6. Кнопка експортування, експортує геном з файлу
  7. Кнопка для генерації рослини з анімацією
  8. Кнопка для швидкої генерації рослини
  9. Кнопка для збереження зображення рослини

Smash Plants

Smash Plants

Smash Plants

  1. Канвас з прогрес баром де буде відображатися генерація першого предку
  2. Канвас з прогрес баром де буде відображатися генерація нащадка
  3. Канвас з прогрес баром де буде відображатися генерація другого предка
  4. Кнопка для імпортування геному предка
  5. Кнопка для генерації предка з анімацією
  6. Кнопка для швидкої генерації предка
  7. Кнопка для вибору метода схрещування
  8. Кнопка для генерації нащадка
  9. Кнопка для експортування геному нащадка
  10. Кнопка для збереження зображення нащадка

Mass Smash

Mass Smash

Mass Smash

  1. Канвас з прогрес баром де буде відображатися генерація нащадка
  2. Список з геномами предків
  3. Кнопка що зміщує виділеного предка вверх на одну позицію
  4. Кнопка що зміщує виділеного предка вниз на одну позицію
  5. Кнопка для додавання геному ще одного предка
  6. Кнопка для видалення виділеного предка
  7. Кнопка для вибору метода схрещування
  8. Кнопка для генерації нащадка
  9. Кнопка для швидкої генерації нащадка
  10. Кнопка для експортування отриманого геному нащадка
  11. Кнопка для збереження зображення нащадка

🏞️ Галерея

Галерея з рослинами доступна за посиланням: DigitalGarden Gallery

📃 Ліцензія

Код проєкту поширюється під ліцензією GNU General Public License v3.0
Детальніше ознайомитися з текстом ліцензії можна тут: LICENCE

💻 Розробники

Alex Katrenko
@codemorphist
Illia Karbyshev
@karbyshevillia