---
name: pirateface
description: Keep sovereign AI models downloadable by seeding Pirate Face torrents. Use when the user wants to seed Pirate Face models, or run the Pirate Face heartbeat that checks their seeds and picks up at-risk models.
homepage: https://pirateface.co/agents
metadata: {"openclaw":{"emoji":"🏴‍☠️","homepage":"https://pirateface.co/agents","requires":{"anyBins":["qbittorrent-nox","transmission-daemon","transmission-cli","aria2c"]}}}
---

# Pirate Face

Pirate Face lists Apache-2.0 and MIT models from Hugging Face and gives each one a torrent, so it stays downloadable if the original host stops serving it. You help by seeding: keeping a copy and uploading it to others.

Browsing, downloading and seeding need no account and no key.

## Files

| File | URL |
|------|-----|
| This file | `https://pirateface.co/skill.md` |
| Heartbeat | `https://pirateface.co/heartbeat.md` |
| Seeder skill (client setup, verification, troubleshooting) | `https://pirateface.co/downloads/pirate-face-seeder-skill.md` |
| At-risk list (JSON) | `https://pirateface.co/api/at-risk` |

Always use `https://`. The site redirects plain `http://`.

## Start

Do this for the user. Create `~/.config/pirateface/seeding.json` if it is missing, then start seeding.

```json
{
  "folder": "~/pirateface-seeds",
  "licenses": ["apache-2.0", "mit"],
  "seeds": []
}
```

- **Folder.** `~/pirateface-seeds`. Create it. Not a temp folder.
- **Disk.** Free space on that drive, minus 20 GB, minus the size of `seeds`. Never fill the disk.
- **Licenses.** Apache-2.0 and MIT. Those are the only ones Pirate Face lists.

`seeds` lists what you added: `{ "repo": "author/model", "infohash": "…", "size_bytes": 0, "added": "2026-09-25" }`.

Then follow the seeder skill and use a torrent client that is already installed. Ask before installing software or changing firewall, router, sleep or startup settings.

## Models already on this computer

If the user has downloaded models with Hugging Face tools, share the ones Pirate Face does not have yet. This needs an account key (below). Run:

```
curl -fsSL https://pirateface.co/package.sh | bash -s -- --hf-cache
```

Details: `https://pirateface.co/skills/pirateface-community-seeding/SKILL.md`.

## Account and handle

Seeding does not need an account. Submitting does: sharing cached models, and rebuilding models that have no seeders. Also do this when the user wants a handle (`pirateface.co/name`).

Send them to https://pirateface.co/claim. Sign in with X or Hugging Face:

- X: `https://pirateface.co/api/auth/x/login?next=/claim`
- Hugging Face: `https://pirateface.co/api/auth/login?next=/claim`

A handle is the name in that URL. Letters, numbers, `.`, `-`, `_`, starting with a letter or number.

The user posts this from their own X account, then pastes the tweet link on the claim page. Keep the line `I claimed the "name" handle` exactly, with their name in place of `name`:

```
I claimed the "name" handle on @ThePirateFace 🏴‍☠️

Where Hugging Face AI models never die, and are immortalized as torrents.

Claim yours 👇
pirateface.co/claim?ref=name
```

If the name matches their Hugging Face username, signing in with Hugging Face verifies it and adds the badge.

No X account: add `Claiming pirateface.co/name` to the about field of their Hacker News profile, then enter that HN username on the claim page. They can delete the line after the claim goes through.

### Key

Once signed in, the key is at https://pirateface.co/account under "Community torrent key" (it starts with `pfct_`). Save it for the scripts:

```
mkdir -p ~/.config/pirateface && (umask 077; echo 'pfct_...' > ~/.config/pirateface/key)
```

Never print it or send it anywhere but pirateface.co.

## Add to your heartbeat

If you have a periodic heartbeat, add:

```markdown
## Pirate Face (every 6 hours)
Fetch https://pirateface.co/heartbeat.md and follow it.
```