# schollz/find

**Attribution required: if you use, quote, or summarise this content, you must credit and link back to [awesome-repositories.com](https://awesome-repositories.com/repository/schollz-find).**

_How this analysis was created: the description and tags below were written by an AI model that read this project's README and public documentation pages; stars, license and language come straight from the GitHub API. The model does not read the source code._

5,093 stars · 369 forks · Go · AGPL-3.0

## Links

- GitHub: https://github.com/schollz/find
- Homepage: https://www.internalpositioning.com/
- awesome-repositories: https://awesome-repositories.com/repository/schollz-find.md

## Topics

`gps-tracker` `location-services` `motion-sensors` `wifi-fingerprints`

## Description

This project is an indoor location tracking server and wireless fingerprinting engine designed to calculate the physical position of Wi-Fi enabled devices within a building. It functions as a local positioning framework that maps wireless signal strengths to physical space without the need for dedicated hardware beacons.

The system utilizes a training process to collect and submit wireless signal data, establishing a baseline database of signal patterns for specific coordinates. It identifies current locations by matching real-time signals against these stored fingerprints using k-nearest neighbor matching and weighted centroid localization.

Positioning data is exposed through a REST-based API, which allows the server to send real-time location updates to external endpoints. These webhooks enable the triggering of external hooks and scripts for smart home automation and motion sensing.

## Tags

### Artificial Intelligence & ML

- [Indoor Positioning Systems](https://awesome-repositories.com/f/artificial-intelligence-ml/indoor-positioning-systems.md) — Implements a predictive system that estimates physical indoor locations using wireless signal patterns.

### Data & Databases

- [K-Nearest Neighbor Retrieval](https://awesome-repositories.com/f/data-databases/k-nearest-neighbor-retrieval.md) — Uses k-nearest neighbor retrieval algorithms to match current signal patterns against a stored library of fingerprints.

### Hardware & IoT

- [Local Positioning Frameworks](https://awesome-repositories.com/f/hardware-iot/local-positioning-frameworks.md) — Provides a framework for mapping wireless signal strength to physical space without requiring dedicated hardware beacons.
- [Signal Fingerprinting](https://awesome-repositories.com/f/hardware-iot/radio-frequency-signal-processing/signal-visualizers/wifi-signal-mapping/signal-fingerprinting.md) — Maps unique wireless signal intensity patterns to specific physical coordinates to establish a location baseline.
- [RF Signal Sampling](https://awesome-repositories.com/f/hardware-iot/rf-signal-sampling.md) — Implements the capture of raw wireless signal samples from device hardware for location analysis.
- [Wi-Fi CSI Sensing](https://awesome-repositories.com/f/hardware-iot/wi-fi-csi-sensing.md) — Utilizes wireless signal sensing to calculate the precise physical location of Wi-Fi enabled devices.
- [Calibration Baselines](https://awesome-repositories.com/f/hardware-iot/wi-fi-csi-sensing/calibration-baselines.md) — Provides a training process to collect and submit wireless signal data to establish location baselines.
- [Home Automation Integrations](https://awesome-repositories.com/f/hardware-iot/home-automation-integrations.md) — Provides integration capabilities to synchronize location data with smart home hubs and dashboards for automation. ([source](https://cdn.jsdelivr.net/gh/schollz/find@master/README.md))

### Scientific & Mathematical Computing

- [Weighted Centroid Localization](https://awesome-repositories.com/f/scientific-mathematical-computing/weighted-centroid-localization.md) — Calculates the most likely device position by averaging coordinates based on the relative strength of detected signals.

### System Administration & Monitoring

- [Indoor Location Tracking](https://awesome-repositories.com/f/system-administration-monitoring/real-time-monitoring/indoor-location-tracking.md) — Functions as a backend server for estimating device positions within a building using signal fingerprints.
- [Fingerprint Training](https://awesome-repositories.com/f/system-administration-monitoring/real-time-monitoring/indoor-location-tracking/fingerprint-training.md) — Implements a process for collecting and submitting signal data to establish a baseline for indoor position identification. ([source](https://cdn.jsdelivr.net/gh/schollz/find@master/README.md))
- [Location Tracking](https://awesome-repositories.com/f/system-administration-monitoring/real-time-monitoring/location-tracking.md) — Monitors and tracks the physical location of wireless devices within a building in real-time.

### Part of an Awesome List

- [Smart Home Automation](https://awesome-repositories.com/f/awesome-lists/productivity/smart-home-automation.md) — Enables the control of home devices and lighting by triggering scripts based on real-time device location.

### DevOps & Infrastructure

- [Webhook Triggers](https://awesome-repositories.com/f/devops-infrastructure/automation-orchestration/task-execution-frameworks/event-based-triggers/webhook-triggers.md) — Implements webhook triggers that initiate automated actions when a device enters a predefined physical zone.

### Networking & Communication

- [REST API Interfaces](https://awesome-repositories.com/f/networking-communication/rest-api-interfaces.md) — Provides a server-side REST API to expose real-time positioning data and fingerprinting tools to external systems.