Metadata-Version: 2.4
Name: decionis-presence
Version: 0.2.0
Summary: Official Python SDK and CLI for the Presence verification API
Author: Decionis AB
License-Expression: Apache-2.0
Project-URL: Documentation, https://presence.decionis.com/developers/quickstart
Project-URL: Repository, https://github.com/decionis/Presence
Project-URL: Issues, https://github.com/decionis/Presence/issues
Keywords: presence,verification,identity,sdk
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Typing :: Typed
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Dynamic: license-file

# Human Presence Verification for Python

**Presence SDK** — verify human presence before consequential actions execute.

> Applications send intent and context.
> Presence verifies the person.
> Decionis decides whether execution proceeds.

## Install

```sh
python -m pip install decionis-presence
```

```sh
export PRESENCE_API_KEY='presence_sk_…'
```

## Thirty seconds to a verdict

```python
import os
import uuid
from presence_sdk import Client

presence = Client(os.environ["PRESENCE_API_KEY"])
result = presence.run_sandbox_scenario("allow", f"quickstart-{uuid.uuid4().hex}")
print(result["policy_verdict"])
```

The fixture is signed with `evidence_class: sandbox_fixture` and always runs in Shadow
Mode. Tenant credentials belong on trusted servers only.

## What happens

```text
Application

↓

Intent + Context

↓

Presence

↓

Biometrics

↓

Liveness

↓

Presence Record

↓

Decionis Verdict

↓

Continue
```

Every Presence Check produces a signed **Presence Record** — portable evidence of who
approved what, where, when, and on which device.

## Quickstart

```text
Install

↓

Configure

↓

Send Intent

↓

Receive Presence Result

↓

Verify Signature

↓

Done
```

Five minutes: [docs/quickstart.md](docs/quickstart.md).

## Supported scenarios

```text
Wire Transfer

Treasury

Password Reset

Executive Meeting

Vendor Change

AI Approval
```

## Examples

| Example                       | What it proves                                        |
| ----------------------------- | ----------------------------------------------------- |
| [simple](examples/simple)     | Your first Presence Check.                            |
| [banking](examples/banking)   | A wire transfer with a verified Presence Record.      |
| [zoom](examples/zoom)         | An executive meeting instruction held for review.     |
| [treasury](examples/treasury) | A treasury wire read through Shadow Mode enforcement. |

## Documentation

- [Installation](docs/installation.md)
- [Quickstart](docs/quickstart.md)
- [Concepts](docs/concepts.md)
- [Presence Checks](docs/presence-check.md)
- [Shadow Mode](docs/shadow-mode.md)
- [API Reference](docs/api.md)
- [Troubleshooting](docs/troubleshooting.md)

Product documentation lives at [presence.decionis.com](https://presence.decionis.com).

## Support

- [GitHub Issues](https://github.com/decionis/Presence/issues)
- [presence.decionis.com](https://presence.decionis.com)

## License

Apache-2.0. Use of the hosted Presence service is governed separately.
