rightis-js
Use this before your code generates a real person's face, voice or persona. Image, video and voice models, face swap, voice cloning, AI avatars and chat personas of real people or registered characters: ask Rightis first, on the server, before the generation call.
Rightis is a public registry of identity rights. People and rights holders register a likeness and say which AI uses they allow, want to approve, or refuse. This repository is the JavaScript SDK and CLI.
| Package | Path | What it is |
|---|---|---|
@rightis/sdk | packages/sdk | Typed client: rights checks, licences, usage, webhook verification |
rightis | packages/cli | npx rightis: check from the terminal, log in, get a sandbox key |
30-second quickstart
npm install @rightis/sdk
npx rightis check BR-XXXX-XXXX-XXXX --use "instagram ad" --asset face --public
import { Rightis } from '@rightis/sdk';
const rightis = new Rightis(); // server only; reads RIGHTIS_SECRET_KEY, keyless without it
const result = await rightis.rights.check({
rights_id: 'BR-XXXX-XXXX-XXXX',
use_type: 'instagram ad',
ai_methods: ['image_generation'],
asset_types: ['face'],
territory: ['US'],
});
console.log(result.decision, result.next_action.type, result.next_action.url);
Read next_action, not just decision:
decision | next_action.type | Meaning |
|---|---|---|
allowed | request_license | Pre-approved scopes. Not free use: the licence request is approved without the holder reviewing it if the fee clears their floor. Still request it. |
requires_approval | request_license | The holder decides each request. |
unspecified | request_license | The holder has said nothing. Not a yes. |
denied | stop | Refused. Do not generate. |
null | not_registered | Not in the registry. Not cleared. |
null | describe_use | Registered, but no use was described. Add use_type, ai_methods, asset_types. |
A failed lookup is not "not registered": on any RightisError, do not generate. The SDK
deliberately ships no boolean that turns a decision into "go ahead".
Only have a name? rightis.rights.search('name') returns listed registrations with their
Rights ID. No match is not clearance.
For AI coding assistants
- Claude Code skill:
skills/rightis/SKILL.md. Copy it to.claude/skills/rightis/SKILL.mdin your project (or~/.claude/skills/rightis/). - Cursor rule:
.cursor/rules/rightis.mdc. Copy it to.cursor/rules/in your project. - Codex and other agents:
AGENTS.md, including a snippet to paste into your ownAGENTS.mdorCLAUDE.md. - Keyless MCP server:
https://rightis.org/api/public-mcp/mcp(rights_lookup,rights_search,registry_info).
Links
- Developers: https://rightis.org/en/developers
- Guide, generating real people: https://rightis.org/en/developers/guides/real-person-likeness
- SDK reference:
packages/sdk/README.md - CLI reference:
packages/cli/README.md
Sandbox
npx rightis login # browser sign-in (OAuth with PKCE)
npx rightis init # sandbox key into .env.local, plus an example file
npx rightis people # the sandbox sample people
npx rightis check BR-SANDBOX-... --use "social media ad" --asset face
node --env-file=.env.local rightis-example.mjs # the same check from code
Develop
pnpm install
pnpm -r build
pnpm -r test
pnpm -r typecheck
Node 20 or later. Point the SDK and CLI at a local server with
RIGHTIS_API_URL=http://localhost:3000 (or --base-url).
Publish with pnpm publish --access public from packages/sdk, then packages/cli.
Not npm publish: the CLI's workspace:^ dependency is rewritten only by pnpm.
License
MIT, The Backers Inc.