Show HN: Terminal Flower Garden

1 day ago 1

Beautiful CLI flower garden game - water flowers and watch them grow into stunning patterns!

Transform your terminal into a magical garden where you can nurture 5 different types of flowers, each growing into unique mathematical patterns and fractals.

Flower Garden Demo Python Version License

  • 5 Unique Flower Types: Each with distinct mathematical patterns

    • 🌹 Spiral Rose - Fibonacci spirals with blooming petals
    • 🌳 Fractal Tree - Recursive branching with leaves
    • 🌺 Mandala Bloom - Geometric circular patterns
    • 🌊 Wave Garden - Flowing sine wave patterns
    • Star Burst - Radiating star patterns
  • Growth System: 10 levels of growth for each flower

  • Persistent Save: Your garden state is automatically saved

  • Colorful Display: Beautiful terminal colors (with colorama)

  • Interactive Menu: Easy-to-use command interface

Install and run with a single command:

pip install flower-garden-cli flower-garden

Alternative command:

Method 1: pip install (Recommended)

# Install from PyPI (when published) pip install flower-garden-cli # Or install from GitHub pip install git+https://github.com/bdavidzhang/flower-garden-cli.git

Method 2: Local Development

# Clone the repository git clone https://github.com/bdavidzhang/flower-garden-cli.git cd flower-garden-cli # Install in development mode pip install -e . # Run the game flower-garden

Method 3: Direct from Source

# Download and run directly curl -O https://raw.githubusercontent.com/bdavidzhang/flower-garden-cli/main/flower_garden_cli/main.py python main.py
  1. Launch the game: Run flower-garden in your terminal
  2. Choose an action: Select from the numbered menu options
  3. Water flowers: Watch them grow from seeds to beautiful patterns
  4. Enjoy the patterns: Each growth level reveals more complexity
  5. Save automatically: Your progress is saved between sessions
  • 1-5: Water individual flower types
  • 6: View your entire garden
  • 7: Water all flowers at once
  • 8: Reset garden (start over)
  • 9: Quit game
🌹 Spiral Rose (Level 6) ⭐ Star burst (Level 4) · · ······· · ✿❀✿❀✿···· · · · ✿❀····✿···· · ✧ · ······❀✿··· ✧ ✧ ✧ ·······❀··· ✧✧✧ ······❀❀····· ···✧✧✧★✧✧✧··· ··········· ✧✧✧ ··········· ✧ ✧ ✧ ··········· · ✧ · ········· · · · ······· · · ·
flower-garden-cli/ ├── flower_garden_cli/ │ ├── __init__.py │ └── main.py ├── pyproject.toml ├── README.md ├── LICENSE └── tests/ └── test_main.py
# Clone and setup git clone https://github.com/bdavidzhang/flower-garden-cli.git cd flower-garden-cli # Create virtual environment python -m venv venv source venv/bin/activate # or `venv\Scripts\activate` on Windows # Install in development mode pip install -e ".[dev]" # Run tests pytest # Format code black flower_garden_cli/
  • Python: 3.7 or higher
  • Dependencies:
    • colorama (for colored terminal output)
  • Platform: Cross-platform (Windows, macOS, Linux)

MIT License - see LICENSE file for details.

Contributions welcome! Please feel free to submit a Pull Request.

  1. Fork the repository
  2. Create your feature branch (git checkout -b feature/AmazingFeature)
  3. Commit your changes (git commit -m 'Add some AmazingFeature')
  4. Push to the branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

If you enjoy this project, please give it a ⭐ on GitHub!

Issues? Please report them here.


Grow your digital garden, one flower at a time 🌱✨

Read Entire Article