> ## Documentation Index
> Fetch the complete documentation index at: https://docs.waveyhq.dev/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](/concepts/sensing-pipeline). For what to detect first, see the [detection ladder](/concepts/detection-ladder).

> 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](/reference/glossary) from ambient WiFi traffic. See [commodity CSI limits](/posts/esp32-csi-explained) 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](/concepts/sensing-pipeline) for the processing stack.
3. **Console and integrations.** Live visualization at [console.waveyhq.dev](https://console.waveyhq.dev); events for [automation](/use-cases/smart-home-automation) and [analytics](/use-cases/occupancy-analytics).

***

## 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](/concepts/detection-ladder) — the most robust tasks first:

<Steps>
  <Step title="Occupancy">
    Use change-point detection on a learned baseline. This is the most reliable first task and requires the least tuning. See [occupancy detection](/use-cases/occupancy-detection).
  </Step>

  <Step title="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](/use-cases/motion-activity-detection).
  </Step>

  <Step title="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](/use-cases/presence-detection).
  </Step>
</Steps>

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

<Accordion title="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.
</Accordion>

<Accordion title="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.
</Accordion>

<Accordion title="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.
</Accordion>

***

## Further reading

<CardGroup cols={2}>
  <Card title="How It Works" icon="wave-square" href="/concepts/how-it-works">
    Learn the physics behind CSI, OFDM, and multipath superposition.
  </Card>

  <Card title="Sensing Pipeline" icon="microchip" href="/concepts/sensing-pipeline">
    From raw CSI packets to detection events: preprocessing, features, and ML.
  </Card>

  <Card title="Detection Ladder" icon="stairs" href="/concepts/detection-ladder">
    What WiFi CSI can and cannot do, from occupancy to pose and identity.
  </Card>

  <Card title="Glossary" icon="book" href="/reference/glossary">
    Definitions for CSI, OFDM, micro-Doppler, and other key terms.
  </Card>
</CardGroup>