Metadata-Version: 2.4
Name: elastik
Version: 6.0.1
Summary: Pastebin with HMAC that accidentally became a web OS. pip install one ring.
Author: Ranger Chen
License-Expression: MIT
Project-URL: Homepage, https://github.com/rangersui/Elastik
Project-URL: Repository, https://github.com/rangersui/Elastik
Keywords: http,pastebin,local-first,ai,web-os,rust
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Operating System :: POSIX
Classifier: Operating System :: MacOS
Classifier: Operating System :: Microsoft :: Windows
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Rust
Classifier: Topic :: Internet :: WWW/HTTP
Requires-Python: >=3.10
Description-Content-Type: text/markdown

# elastik

Python SDK and launcher for the Phoenix `elastik-core`.

This package is intentionally thin:

- `elastik.start()` launches the bundled Rust core binary.
- `Elastik.put()` writes bytes over HTTP.
- `Elastik.get()` reads bytes over HTTP.
- `Elastik.head()` inspects HTTP metadata.
- `@elastik.listen(...)` reacts to `/listen/*` SSE events.

The package ships a platform-specific `elastik-core` binary in
`elastik/_bin/`. For the full project README, see:

<https://github.com/rangersui/Elastik>

## Install

```powershell
py -m pip install elastik
py -m elastik run --key dev-hmac-key --read-token read-token --token write-token --approve-token approve-token
```

`--key` is required. Token flags are optional capability gates:

- omit `--read-token` to keep reads public.
- omit `--token` to disable ordinary `PUT` and `POST`.
- omit `--approve-token` to disable `DELETE` and system writes.

## Source Checkout

```powershell
git clone https://github.com/rangersui/Elastik
cd Elastik
python -m pip install -e .\sdk
python -m elastik run --key dev-hmac-key --read-token read-token --token write-token --approve-token approve-token
```
