Metadata-Version: 2.4
Name: fissionbox
Version: 0.3.3
Summary: Fission box is a Python library built by NormAI to help you interact with the FissionBox API.
Author-email: Mohammad Alshakoush <mo@normai.nl>, Mo Assaf <assaf@normai.nl>
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: pydantic>=2.11.7
Requires-Dist: requests>=2.32.4
Requires-Dist: tqdm>=4.67.1
Dynamic: license-file


# FissionBox SDK

Install with pip
```
pip install fissionbox
```

Run the CLI as follows
```bash
python -m fissionbox.cli.main
```

Temporary local auth flow notes are documented in `docs/local-auth.md`.

For now, the CLI local-auth defaults are:

```text
FISSIONBOX_AUTH_HOST=http://localhost:4242
FISSIONBOX_PLATFORM_HOST=http://localhost:8888
```

Published CLI installs should use the hosted API for platform requests:

```text
FISSIONBOX_PLATFORM_HOST=https://api.beta.platform.fissionbox.ai
FISSIONBOX_HOST=https://api.beta.fissionbox.ai
```

Document workflow commands
```bash
fissionbox auth login
fissionbox namespace use --namespace-id=ns-123

fissionbox document upload --path=./invoices
fissionbox document run --path=./invoice.pdf --schema-file=./schema.json
fissionbox document list
fissionbox document export-chunks --id=art-123 --output=./chunks.ndjson
```

Processed document runs now persist their converter responses server-side in platform, keyed by the saved document run ID. Follow-up platform operations can reuse that stored result instead of sending the full payload back through the client.

Service account tokens for automation
```bash
export FISSIONBOX_PLATFORM_HOST=https://api.beta.platform.fissionbox.ai
export FISSIONBOX_HOST=https://api.beta.fissionbox.ai
export FISSIONBOX_PLATFORM_USER_TOKEN=<user-access-token>

fissionbox account create-service-account --name=document-bot
fissionbox account list-service-accounts
fissionbox account issue-token --service-account-id=acc-123 --max-age=2592000
```
