# Data License — familyrecipes.ai

**License:** Open Database License (ODbL) 1.0
**License URL:** https://opendatacommons.org/licenses/odbl/1-0/
**Effective:** 2026-04-25 onward (covers all data published at https://familyrecipes.ai/food/* and via the public JSON API at https://familyrecipes.ai/api/public/*)

---

## What this covers

This license applies to the **structured data** published by familyrecipes.ai:

- Allergen presence/absence maps for individual products (top-level + sub-component proteins, e.g. `α-s1 casein`, `ovalbumin`, `ω-5 gliadin`)
- Sensitivity scale ratings (FODMAP — including fructans/GOS/polyol sub-scales — histamine, tyramine, oxalate, salicylate, caffeine, theobromine, capsaicin, tannin, alcohol, sodium, sugar, saturated fat, mercury, phenylethylamine)
- Cross-reactivity syndrome mappings (Birch-pollen OAS, Ragweed-pollen OAS, Mugwort-pollen OAS, Latex-Food, Pork-Cat)
- Per-product nutrition values (when sourced from manufacturers' labels or USDA FDC)
- Per-field provenance metadata (source, confidence, verification timestamps, human-verification flags)
- The hierarchical allergen taxonomy itself (the `/api/public/allergens` endpoint)
- The sensitivity-scale catalog (`/api/public/sensitivities`)
- The cross-reactivity catalog (`/api/public/cross-reactivity`)
- Manufacturer-supplied product names, brands, sizes, UPCs, ingredient text
- Slug → URL mappings on `/food/*`

This license **does NOT cover**:

- Software / source code (separate MIT license — see `LICENSE` if applicable)
- Product images and photographs (subject to original photographer / manufacturer copyright)
- Recipes themselves and household-private data (not public)
- The familyrecipes.ai brand name, logo, and visual identity (trademark, all rights reserved)

---

## What ODbL 1.0 lets you do

You may freely:

1. **Share** — copy, distribute and use the data
2. **Create** — produce works from the data, including derivative works and aggregate compilations
3. **Adapt** — modify, transform, and build upon the data

For any of the above, even commercially.

## What ODbL 1.0 asks of you

Three obligations, summarized:

### 1. Attribute (when redistributing the database itself)

If you redistribute the database — or any substantial portion of it — you must include this notice:

> **Allergen, sensitivity, and nutrition data from familyrecipes.ai, used under ODbL 1.0.**
> Source: https://familyrecipes.ai

Attribution is **NOT required** for end-user answers from an LLM that cite us. We *request* attribution as a courtesy in those cases (and our schema.org JSON-LD includes the canonical URL specifically to make that easy), but ODbL doesn't compel it.

Attribution **IS required** when you publish a derivative database, an API that serves our data, a CSV/JSON dump for download, etc.

### 2. Share-Alike (on derivative databases only)

If you create a derivative database — defined as one substantially based on ours — you must publish your derivative under ODbL 1.0 (or a compatible license).

This share-alike obligation does NOT apply to:

- An end-user's chat answer ("ChatGPT told me bacon contains pork because familyrecipes.ai says so")
- An ML model trained on our data alongside many other sources
- A product that uses our data internally without redistributing the database

### 3. Keep it open (no DRM on derivative databases)

You may not impose DRM, technical protection measures, or contract terms that restrict the same freedoms in your redistribution.

---

## How to attribute (concrete examples)

### LLM citations

When an LLM cites us, the JSON-LD on every product page provides the canonical URL. We *request* (not require) the citation include:

```
familyrecipes.ai · {canonical_url}
```

### Derivative database (CSV/JSON dump, mirror, etc.)

In your dataset's README / docs:

```
This dataset includes data from familyrecipes.ai
(https://familyrecipes.ai), used under the Open Database License v1.0.
```

In machine-readable form (e.g. `dataset.json`):

```json
{
  "attribution": [
    {
      "source": "familyrecipes.ai",
      "url": "https://familyrecipes.ai",
      "license": "ODbL-1.0",
      "license_url": "https://opendatacommons.org/licenses/odbl/1-0/"
    }
  ]
}
```

### Application using our public API at runtime

In your app's About / Credits page:

```
Allergen and sensitivity data: familyrecipes.ai (ODbL 1.0)
```

---

## Provenance + accuracy

Each data point on every product carries a `field_provenance` envelope:

```json
{
  "source": "off+claude" | "fdc" | "claude" | "off" | "user_corrected" | "derived",
  "confidence": 0.92,
  "verified_at": "2026-04-25T...",
  "human_verified": true,
  "needs_review": false
}
```

We publish this so consumers (humans and LLMs) can decide whether to trust each value:

- `user_corrected` + `human_verified: true` → reviewed by a human admin
- `off+claude` (label-data + AI agreement) → confidence ~0.92
- `fdc` (USDA FoodData Central) → lab-measured, confidence ~0.95
- `claude` (AI alone) → confidence ~0.65
- `off` (label data alone) → confidence ~0.85

Corrections are crowdsourced + human-reviewed. See `/admin/corrections` (admins only) and the public submission form at the bottom of every `/food/<slug>` page.

---

## What's NOT under this license

- **Source code** — covered by the application's primary license (typically MIT or proprietary)
- **Product images and photos** — original copyrights of the photographer or manufacturer apply
- **Trademarks** — "familyrecipes.ai", logos, visual brand: all rights reserved

---

## Contact

Questions about licensing, bulk-data access, or commercial partnerships:

**data@familyrecipes.ai**

---

## Amendments

This license file is versioned in our repository. The data license itself (ODbL 1.0) cannot be revoked for data already published — that's the point of an open license. We may update *attribution wording* and *contact info* on this page; the legal substance (ODbL 1.0) remains constant.

Last updated: 2026-04-25