███████╗██╗   ██╗██████╗ ███████╗███╗   ██╗███████╗  
██╔════╝██║   ██║██╔══██╗██╔════╝████╗  ██║██╔════╝  
█████╗  ██║   ██║██████╔╝█████╗  ██╔██╗ ██║█████╗    
██╔══╝  ██║   ██║██╔═══╝ ██╔══╝  ██║╚██╗██║██╔══╝    
██║     ╚██████╔╝██║     ███████╗██║ ╚████║███████╗  
╚═╝      ╚═════╝ ╚═╝     ╚══════╝╚═╝  ╚═══╝╚══════╝  

                ═══════════════════════
                SUR🅴N'S  C R E A T I O N S
                ═══════════════════════

---

(guessing that didnt work lmao)

🧠 About This Project

Suren’s Creations aka the old is out new is IN aka SUCORO. But actually - we are now Sucoro.com- pardon the interruption - is a collection of software projects, experiments, and tools by Suren Sahaydachny, spanning automation, AI, terminal enhancement, creative tech, and full-stack wizardry.

"If it doesn't exist, build it. If it exists, improve it." — Suren

---

📁 Repository Structure

.
├── src/                # Source code
├── assets/             # Images, logos, branding
├── .dotfiles/          # Terminal & dev environment configs
├── README.md           # You're reading it

---

⚙️ Get Started

To clone and set up this environment on a new machine:

git clone https://github.com/YOUR_USERNAME/dotfiles.git ~/.dotfiles
cd ~/.dotfiles
./install.sh
exec zsh

Requires: macOS or Linux, Homebrew, Zsh

---

🛠️ Development Setup

🛠️ Makefile Commands

A Makefile has been added to streamline common development tasks.

Available Commands • make install Installs the project dependencies using Poetry. • make dev Runs the application in development mode (equivalent to poetry run python main.py). • make clean Removes temporary files and virtual environments. • make test Runs all tests (if tests are defined).

Usage

From the project root, run:

make install # Install dependencies make dev # Run the app make test # Run tests make clean # Clean up

Make sure you have make and poetry installed on your system.

⸻

⚡ Features

• ⚙️ ZSH + Powerlevel10k dotfiles
• 💡 AI tooling & script ideas
• 🧰 Custom productivity CLI utilities
• 🎨 Original artwork & branding

---

🙌 Attribution

This project and artwork are created and maintained by:

Suren’s Creations
aka Suren Sahaydachny
✉️ suren@surenscreations.com
🌐 surenscreations.com

---

⭐ Show Your Support

If you found this repo useful, feel free to:

• 🌟 Star it
• 🍴 Fork it
• 🤝 Reach out and collaborate

---

"This is only the beginning." 🚀