> ## Documentation Index
> Fetch the complete documentation index at: https://docs.heywavey.tech/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Started with Wavey WiFi CSI Sensing

> Deploy ESP32 nodes, run the Python pipeline, and understand Wavey's three-layer architecture for occupancy, motion, and presence sensing.

Wavey is an open-source WiFi CSI sensing system. This page covers the deployment architecture, what you need before you begin, and how to pick your first detection task. For signal processing detail, see the [sensing pipeline](https://docs.heywavey.tech/concepts/sensing-pipeline.md). For what to detect first, see the [detection ladder](https://docs.heywavey.tech/concepts/detection-ladder.md).

> Setup steps live in the [GitHub repository](https://github.com/waveyhq) — they change as the project matures.

## Three-layer architecture

Wavey is organized into three layers: capture, analysis, and action.

```text theme={null}
[ ESP32 CSI nodes ]  ->  [ Python pipeline ]  ->  [ console / automations ]
   capture CSI            preprocess + features       visualize + emit events
```

1. **Sensing nodes (ESP32).** Capture [CSI](https://docs.heywavey.tech/reference/glossary.md) from ambient WiFi traffic. See [commodity CSI limits](https://docs.heywavey.tech/posts/esp32-csi-explained.md) for hardware constraints.
2. **Analysis pipeline (Python).** Outlier rejection, amplitude features (primary on ESP32), phase sanitization for micro-motion, baseline learning, inference. See the [sensing pipeline](https://docs.heywavey.tech/concepts/sensing-pipeline.md) for the processing stack.
3. **Console and integrations.** Live visualization at [console.waveyhq.dev](https://console.waveyhq.dev); events for [automation](https://docs.heywavey.tech/use-cases/smart-home-automation.md) and [analytics](https://docs.heywavey.tech/use-cases/occupancy-analytics.md).

***

## Before you begin

* One or more CSI-capable ESP32 modules (any ESP32 family chip)
* A WiFi environment with traffic the nodes can sniff
* A host machine for the Python stack

***

## Pick your first detection task

Start at the bottom of the [detection ladder](https://docs.heywavey.tech/concepts/detection-ladder.md) — the most robust tasks first:

**1. Occupancy**

Use change-point detection on a learned baseline. This is the most reliable first task and requires the least tuning. See [occupancy detection](https://docs.heywavey.tech/use-cases/occupancy-detection.md).

**2. Motion**

Use variance and spectral features to detect movement intensity. This adds a small amount of preprocessing but remains robust across rooms. See [motion & activity detection](https://docs.heywavey.tech/use-cases/motion-activity-detection.md).

**3. Presence**

Use micro-Doppler in the respiration band to confirm a still person is present. This needs clean phase, close range, and a quiet environment. See [presence detection](https://docs.heywavey.tech/use-cases/presence-detection.md).

Each level adds preprocessing requirements and tuning complexity. Get occupancy working before attempting activity recognition. Every deployment needs its own empty-room baseline — cross-site transfer without per-site calibration remains an open problem on commodity hardware.

***

## Follow development

* **Code:** [github.com/waveyhq](https://github.com/waveyhq)
* **Console:** [console.waveyhq.dev](https://console.waveyhq.dev)
* **Community:** [Discord](https://discord.gg/sxh9r9UTtW)
* **Contact:** [mail@waveyhq.dev](mailto:mail@waveyhq.dev)

***

## Frequently Asked Questions

> **Is Wavey ready to install today?**
>
> Wavey is in active development. This page covers architecture; github.com/waveyhq has current setup steps and release status.

> **What will I need?**
>
> CSI-capable ESP32 nodes, a WiFi environment, and a host running the Python pipeline. Start with one node; add more for coverage.

> **How can I contribute?**
>
> Star the GitHub repo, join Discord, or email [mail@waveyhq.dev](mailto:mail@waveyhq.dev). Firmware, pipeline, integrations, and docs all welcome.

***

## Further reading

> **[How It Works](https://docs.heywavey.tech/concepts/how-it-works.md)**
>
> Learn the physics behind CSI, OFDM, and multipath superposition.

> **[Sensing Pipeline](https://docs.heywavey.tech/concepts/sensing-pipeline.md)**
>
> From raw CSI packets to detection events: preprocessing, features, and ML.

> **[Detection Ladder](https://docs.heywavey.tech/concepts/detection-ladder.md)**
>
> What WiFi CSI can and cannot do, from occupancy to pose and identity.

> **[Glossary](https://docs.heywavey.tech/reference/glossary.md)**
>
> Definitions for CSI, OFDM, micro-Doppler, and other key terms.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.