# How Many Individuals Can WiFi DensePose Track Simultaneously?

> Discover how many individuals WiFi DensePose can track simultaneously. Learn the limits and capabilities of this advanced pose estimation technology.

- Repository: [rUv/wifi-densepose](https://github.com/ruvnet/wifi-densepose)
- Tags: deep-dive
- Published: 2026-02-19

---

**WiFi DensePose can track up to 10 individuals simultaneously**, a limit defined in both the project's configuration files and official documentation.

WiFi DensePose is an open-source system that estimates human body poses using WiFi signals instead of cameras. Understanding the system's multi-person tracking capacity is essential for deployment planning in real-world scenarios ranging from smart homes to occupancy monitoring systems.

## The 10-Person Tracking Limit

The repository explicitly caps simultaneous person detection at 10 individuals through two authoritative sources: the high-level feature documentation and the runtime configuration parameters.

### Documentation in README.md

According to the **Key Features** section in [`README.md`](https://github.com/ruvnet/wifi-densepose/blob/main/README.md) at line 18, the system advertises: *"Multi-Person Tracking: Simultaneous tracking of up to 10 individuals"*. This establishes the documented capacity limit that users can expect from standard deployments.

### Configuration Parameter in settings.py

The enforceable limit is hardcoded in the default configuration at [`v1/src/config/settings.py`](https://github.com/ruvnet/wifi-densepose/blob/main/v1/src/config/settings.py) on line 94. The parameter `pose_max_persons` is initialized to `10`, which governs how many person instances the pose estimation pipeline will process per frame:

```python

# From v1/src/config/settings.py

pose_max_persons = 10  # Maximum number of persons to track simultaneously

```

## How the Limit Is Enforced in Code

When initializing the WiFi DensePose system, the default constructor loads the configuration value of `10` for maximum person tracking. The following example demonstrates how the system operates within this constraint:

```python
from wifi_densepose import WiFiDensePose

# Initialize the system with default settings (max 10 persons)

system = WiFiDensePose()

# Start pose estimation

system.start()

# Retrieve the latest poses (will contain at most 10 persons)

poses = system.get_latest_poses()
print(f"Detected {len(poses)} persons (max 10)")

```

If the WiFi sensing area contains more than 10 individuals, the system processes only the first 10 detections based on the confidence scores or detection order, effectively ignoring additional persons beyond the configured threshold.

## Modifying the Tracking Capacity

While the default limit is 10, the `pose_max_persons` parameter in [`v1/src/config/settings.py`](https://github.com/ruvnet/wifi-densepose/blob/main/v1/src/config/settings.py) can be adjusted to accommodate different deployment requirements. However, increasing this value may impact real-time performance and computational resource consumption, as the pose estimation neural network must process additional person instances per inference cycle.

## Summary

- WiFi DensePose supports **simultaneous tracking of up to 10 individuals** by default.
- The limit is documented in [`README.md`](https://github.com/ruvnet/wifi-densepose/blob/main/README.md) and enforced via the `pose_max_persons` parameter in [`v1/src/config/settings.py`](https://github.com/ruvnet/wifi-densepose/blob/main/v1/src/config/settings.py).
- The system initializes with this constraint automatically when using the standard `WiFiDensePose()` constructor.
- Modifying the limit requires changing the configuration file, though higher values may affect processing performance.

## Frequently Asked Questions

### What is the maximum number of people WiFi DensePose can track at once?

WiFi DensePose can track a maximum of **10 people simultaneously** under default configuration settings. This limit applies to the number of individual pose estimations the system will generate from WiFi signal data in a single frame.

### Where is the person limit configured in WiFi DensePose?

The person limit is configured in the file [`v1/src/config/settings.py`](https://github.com/ruvnet/wifi-densepose/blob/main/v1/src/config/settings.py) at line 94, where the variable `pose_max_persons` is set to `10`. This configuration file controls runtime parameters for the pose estimation pipeline.

### Can I increase the tracking limit beyond 10 people?

Yes, you can increase the limit by modifying the `pose_max_persons` value in [`v1/src/config/settings.py`](https://github.com/ruvnet/wifi-densepose/blob/main/v1/src/config/settings.py). However, tracking more than 10 individuals may require additional computational resources and could potentially reduce the real-time performance of the WiFi-based pose estimation system.

### Does tracking more people affect WiFi DensePose performance?

Yes, tracking additional people impacts performance because the system must process more complex signal reflections and compute separate pose estimations for each individual. The computational load scales with the number of tracked persons, which is why the default limit of 10 helps maintain real-time processing speeds on standard hardware.