---
hide:
  - toc
---

# Getting Started

New to PyFreeform? Start here. In three short pages you'll go from installation to creating beautiful generative art.

<div class="grid cards" markdown>

-   **Installation**

    ---

    Install PyFreeform and verify everything works with a quick test.

    [Install now](01-installation.md)

-   **Your First Artwork**

    ---

    Create art from an image or from scratch — two paths, one powerful library.

    [Start creating](02-your-first-artwork.md)

-   **How PyFreeform Works**

    ---

    Understand the Scene → Grid → Cell → Entity mental model.

    [Learn the concepts](03-how-it-works.md)

</div>
