declare-ai

Declare AI 🔬

An open standard for AI content disclosure.

A universal “nutrition label” for the web — showing how AI contributed to any piece of content, in a single glance. Free, open source, and community governed.

What is this?

As AI becomes embedded in the production of virtually all digital content, audiences, researchers, educators, and regulators have no standardized way to understand the provenance of what they read, watch, or hear.

Declare AI solves this with:

A lightweight declare-ai.json schema any creator or platform can publish alongside their content
An embeddable JS widget — a draggable pie chart icon that expands into a full disclosure card
A browser extension that auto-detects declarations on any page
A self-declaration portal where creators can generate and host their JSON file
A community forum for disputes, corrections, and governance

Think Creative Commons licensing, but for AI contribution transparency.

Live Demo

👉 View the interactive developer briefing

The declare-ai.json Schema

Drop this file alongside any piece of content, or link to it from a <meta> tag:

{
  "$schema": "https://declare-ai.org/schema/v1.json",
  "version": "1.0.0",
  "content_title": "My Article Title",
  "content_url": "https://example.com/my-article",
  "content_type": "article",
  "declared_by": "Author Name",
  "declared_at": "2025-09-14T10:30:00Z",
  "declaration_method": "self-declared",
  "contributions": [
    {
      "type": "writing",
      "pct": 55,
      "tool": "Claude 3.7 Sonnet",
      "provider": "Anthropic",
      "role": "First draft and editing",
      "human_hours": 1.5
    },
    {
      "type": "human",
      "pct": 45,
      "role": "Research, fact-checking, final edit",
      "human_hours": 3.0
    }
  ],
  "contributors": [
    { "name": "Author Name", "role": "Author" }
  ],
  "license": "CC-BY-4.0"
}

Contribution types: writing · code · visual · audio · research · editing · human

Full schema reference is in /schema.

Add the Declare AI disclosure widget to any webpage with one line:

<script src="https://cdn.declare-ai.org/widget/v1.js" data-declaration="/declare-ai.json"></script>

A small interactive pie chart icon appears on the page. Visitors can click it to see the full AI contribution breakdown — collapsible, draggable, zero dependencies, ~8kb.

Repository Structure

declare-ai/
├── schema/          # JSON Schema definition and validator
├── widget/          # Embeddable JS widget (vanilla, zero deps)
├── extension/       # Browser extension (Chrome/Firefox/Safari)
├── api/             # Backend REST API (Node.js + Fastify)
├── site/            # declare-ai.org website (Next.js)
├── docs/            # Documentation and RFC archive
└── declare-ai-devteam.html   # Interactive prototype demo

Project Status

Component	Status
Schema v1.0 draft	✅ Ready for RFC feedback
Widget prototype	✅ Interactive demo live
Schema validator	🔲 Help wanted
REST API	🔲 Help wanted
Browser extension	🔲 Help wanted
Declaration portal	🔲 Help wanted
Discourse forum	🔲 Help wanted

Contributing

This project is in its earliest stage — the best time to have real influence over the direction of an open standard.

Good first contributions:

Review the schema draft and open an Issue with feedback
Build the JSON schema validator
Port the widget prototype to a proper NPM package
Write documentation

To get started:

Read the interactive briefing to understand the full vision
Browse open Issues for tasks tagged good first issue
Join the discussion in GitHub Discussions
Open a PR — all contributors credited in CONTRIBUTORS.md

Please read CONTRIBUTING.md before submitting your first PR.

Use Cases

🏫 Education — Academic integrity, student work disclosure, AI-assisted textbooks
🔬 Research & Science — Journal submissions, preprint provenance, data attribution
📰 Journalism — News article transparency, editorial policy compliance
🎨 Art & Creative — Artist process disclosure, authorship conversations
⚖️ Legal & Regulatory — EU AI Act compliance layer, platform policy tool
💊 Medicine — Health content trust scoring, clinical content provenance

Roadmap

Phase	Target	Milestone
0	✅ Now	Schema draft, interactive demo, dev briefing
1	Weeks 1–6	Schema validator, declaration form, NPM widget
2	Weeks 6–14	REST API, CDN hosting, browser extension MVP
3	Months 4–6	Accounts, dispute system, community forum
4	Months 6–12	Scoring engine, CMS plugins, Firefox/Safari ext
5	Year 2+	W3C proposal, platform partnerships

License

MIT — free to use, embed, fork, and redistribute without restriction.

This standard is designed to be universally adoptable. No lock-in, no fees, no tracking.

Acknowledgements

Conceived and originated by BetterToBest, gifted to the internet as an open standard.
Built with the assistance of Claude (Anthropic).

If this project matters to you — star it, share it, or open an issue. That’s how open standards begin.

This site is open source. Improve this page.