# Getting Started

Welcome to airsspy! This section will help you get up and running with airsspy quickly.

## What you'll learn

::::{grid} 1 1 2 2
:gutter: 3

:::{grid-item-card} Installation
:link: installation
:link-type: doc

Learn how to install airsspy and its dependencies, including the AIRSS buildcell executable.
:::

:::{grid-item-card} Quickstart Tutorial
:link: quickstart
:link-type: doc

Follow a complete example to perform your first random structure search.
:::
::::

## Prerequisites

Before you begin, you should have:

- Python 3.8 or later
- Basic familiarity with Python programming
- Basic understanding of atomic structures (helpful but not required)
- The AIRSS buildcell executable installed (see [Installation](installation.md))

## Learning Path

We recommend following this order:

1. **[Installation](installation.md)** - Set up airsspy and AIRSS on your system
2. **[Quickstart Tutorial](quickstart.md)** - Complete your first structure search
3. **[How-To Guides](../how-to/index.md)** - Learn specific tasks and techniques
4. **[Explanations](../explanation/index.md)** - Understand AIRSS concepts in depth

## Need Help?

- Check the [API Reference](../reference/index.md) for detailed class and function documentation
- Visit the [GitHub repository](https://github.com/zhubonan/airsspy) to report issues or ask questions
- Read the [AIRSS documentation](http://www.mtg.msm.cam.ac.uk/Codes/AIRSS) for background on the AIRSS package