Metadata-Version: 2.4
Name: data-hub-watcher
Version: 0.2.1
Summary: File-watcher agent for lab instrument PCs that ingests data into Data Hub.
Author-email: Arcadia Science <swe@arcadiascience.com>
License-Expression: MIT
Project-URL: Homepage, https://github.com/Arcadia-Science/data-hub
Project-URL: Documentation, https://github.com/Arcadia-Science/data-hub/blob/production/docs/guides/installing-a-watcher.md
Project-URL: Repository, https://github.com/Arcadia-Science/data-hub
Project-URL: Issues, https://github.com/Arcadia-Science/data-hub/issues
Keywords: arcadia,data-hub,lab,instruments,watcher,uploader
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Science/Research
Classifier: Operating System :: Microsoft :: Windows
Classifier: Operating System :: POSIX :: Linux
Classifier: Operating System :: MacOS
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Scientific/Engineering
Classifier: Topic :: System :: Filesystems
Classifier: Topic :: System :: Monitoring
Requires-Python: >=3.12
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: click>=8.2.1
Requires-Dist: packaging>=24.0
Requires-Dist: pydantic>=2.11.9
Requires-Dist: pyyaml>=6.0
Requires-Dist: python-dotenv>=1.0
Requires-Dist: requests>=2.32.0
Requires-Dist: watchdog>=4.0.0
Provides-Extra: windows-service
Requires-Dist: pywin32; extra == "windows-service"
Dynamic: license-file

# data-hub-watcher

A file-watcher agent that runs on lab instrument PCs and uploads new files to the [Arcadia Science Data Hub](https://github.com/Arcadia-Science/data-hub). It groups files into runs, retries uploads, sends heartbeats, and can optionally run as a Windows service.

## Install

```sh
uv tool install data-hub-watcher
```

The CLI is published as the `data-hub-watcher` script. After installing, walk through the interactive setup wizard:

```sh
data-hub-watcher init
```

## Usage

```sh
data-hub-watcher watch          # start watching for files
data-hub-watcher self-update    # check for and apply package updates
data-hub-watcher service install  # Windows: install as a service
```

See [the operator guide](https://github.com/Arcadia-Science/data-hub/blob/main/docs/guides/installing-a-watcher.md) for the full setup walk-through, configuration reference, and troubleshooting.

## License

MIT — see the `LICENSE` file bundled with the wheel.
