# Pryv.io

> Pryv.io is an open-source middleware for managing personal and health data.
> Each user owns an account (a per-user data vault); apps get scoped access
> tokens with granular, per-stream permissions. Data is stored as typed
> events organized in a tree of streams. The reference open-source server is
> open-pryv.io; the JavaScript client library is the `pryv` npm package.

If you are an AI agent: fetch /llms-full.txt — the dense single-page
technical reference — before driving the API or the client library.

## Core

- [llms-full.txt](https://pryv.github.io/llms-full.txt): single-page agent-readable technical reference (read this first)
- [API reference](https://pryv.github.io/reference/): canonical REST/WebSocket reference
- [Getting started](https://pryv.github.io/getting-started/): first API calls, step by step
- [Concepts](https://pryv.github.io/concepts/): accounts, streams, events, accesses, permissions
- [Data in Pryv](https://pryv.github.io/data-in-pryv/): data model deep-dive
- [Event types](https://pryv.github.io/event-types/): the curated type catalogue (machine-readable: https://pryv.github.io/event-types/flat.json)

## Client library

- [lib-js on GitHub](https://github.com/pryv/lib-js): the `pryv` npm package — JS library for Node + browser apps
- [pryv on npm](https://www.npmjs.com/package/pryv): install with `npm install pryv`

## Server

- [open-pryv.io](https://github.com/pryv/open-pryv.io): open-source server — single Node.js binary, Docker image `pryvio/open-pryv.io`; has its own AGENTS.md
- [Setup guides](https://pryv.github.io/customer-resources/): operator-facing install, backup, SSL, MFA, multi-core topology

## Optional

- [API reference (admin)](https://pryv.github.io/reference-admin/): platform administration API
- [API reference (system)](https://pryv.github.io/reference-system/): system-level API for platform operators
- [Guides](https://pryv.github.io/guides/): app guidelines, audit logs, consent, data modelling, webhooks
- [FAQ — API](https://pryv.github.io/faq-api/) and [FAQ — infrastructure](https://pryv.github.io/faq-infra/)
- [Functional specifications](https://pryv.github.io/functional-specifications/)

## Feedback

- [GitHub issues](https://github.com/pryv/open-pryv.io/issues): single tracker for all agent-related feedback (docs, API behavior, client library)