# Hugging Face publication: two ready-to-upload artifacts

## Model repository

Intended ID: `ayjays132/PhillNet-Recall`. This is a custom-library memory-policy
checkpoint, not an AutoModelForCausalLM checkpoint or a hosted text-generation API.
The model card deliberately omits a misleading text-generation pipeline tag.

The source ZIP is the complete model repository. Extract it and enter the
`PhillNet-Recall` directory. A dry run needs no token and makes no network request:

```bash
python scripts/verify_release.py
python scripts/publish_hf.py
```

Authenticate **locally**, not in a chat message, then create a new private repo:

```bash
python -m pip install '.[hub]'
hf auth login
python scripts/publish_hf.py --publish
```

To create it publicly, explicitly pass `--public --publish`. The script refuses
existing repositories and does not change their visibility. It checks the logged-in
personal namespace, manifest paths, file hashes and sizes, then uploads only those
files. Live SQLite stores, credentials and unlisted files are not uploaded.

If a repository already exists, this script stops. Review its existing files,
visibility and revision before using a separately authorized Hub update process.
No automatic overwrite, history purge, or account permission change is performed.

## Public synthetic demo Space

Extract `PhillNet-Recall-Space-1.2.0.zip` beside the model directory. It contains a
Dockerfile, Space metadata, the installable wheel, the UI and its server, plus a
manifest. The app executes four fixed synthetic demonstrations. It accepts no
personal memory input and creates a fresh in-memory database for each request.

```bash
python scripts/publish_hf.py --target space --space-dir ../PhillNet-Recall-Space
python scripts/publish_hf.py --target space --space-dir ../PhillNet-Recall-Space --public --publish
```

Intended Space ID: `ayjays132/PhillNet-Recall-Demo`. The default visibility remains
private unless explicitly changed on creation. Creating a model repo does not
create a running service; the Docker Space is a separate artifact. Neither repo
was published by this release build. The Docker image and live Hub rendering were
not tested. The app's actual Python routes and all four demonstrations were tested.

## Loading the published policy

Install the supplied wheel and Hugging Face Hub support first. After publication:

```python
from phillnet_recall import RecallMemory, RecallPolicy
policy = RecallPolicy.from_pretrained(
    'ayjays132/PhillNet-Recall', revision='YOUR_REVIEWED_COMMIT_SHA')
memory = RecallMemory('local.sqlite3', policy=policy, tenant='me')
```

Remote downloads contain data files only; remote Python and native libraries are
not executed. `trust_remote_code=True` is neither needed nor used. Remote download
execution was not verified here. Local `save_pretrained` / `from_pretrained` are
tested. A repository name is not a substitute for pinning and reviewing a revision.

## Post-upload verification

Confirm card images render, compare the repository commit to the uploader receipt,
download the data at that commit into a clean environment, and rerun the local
installation and example. Keep live memory databases out of the model repository.
Use authenticated private storage for production memory. The demo is synthetic,
not a multi-user memory-hosting product or a Hugging Face endorsement.

Official references: https://huggingface.co/docs/hub/model-cards ;
https://huggingface.co/docs/huggingface_hub/guides/upload ;
https://huggingface.co/docs/hub/spaces-sdks-docker . Reviewed 2026-11-11.