freedom-intelligence/README.md

# freedom-intelligence

**The just in case open weights model lab**

Coulomb / NetKingdom lab for:

1. **Daily research briefs** on AI models, methods, harness, and tooling  
2. An **open-weight model reserve** on backup storage for possible local training or ops

Standing lenses: **A** frontier & price · **B** edge/local open · **C** homelab training · **D** agent harness & fleet

---

## Start here

| Doc | Role |
| --- | ---- |
| [`INTENT.md`](INTENT.md) | Why the lab exists (stable) |
| [`SCOPE.md`](SCOPE.md) | What is in/out of scope now |
| [`research/2026-07-24-baseline-field-survey.md`](research/2026-07-24-baseline-field-survey.md) | **Baseline field survey + model collection recommendations** |
| [`docs/daily-brief-playbook.md`](docs/daily-brief-playbook.md) | How to produce a daily brief |
| [`history/InitialExploration.md`](history/InitialExploration.md) | Founding conversation |
| [`briefs/`](briefs/) | Daily briefs + template |
| [`inventory/`](inventory/) | Model catalog & collection policy |
| [`workplans/`](workplans/) | Setup workplans (incl. activity-core) |
| [`activity-definitions/`](activity-definitions/) | Weekday brief schedule (enabled; completion = origin/main) |

---

## Workplans

| ID | Title | Status |
| -- | ----- | ------ |
| [FI-WP-0001](workplans/FI-WP-0001-lab-operating-foundation.md) | Lab operating foundation | done |
| [FI-WP-0002](workplans/FI-WP-0002-activity-core-daily-research.md) | Activity-core daily research rhythm | finished |
| [FI-WP-0003](workplans/FI-WP-0003-seed-open-weight-reserve.md) | Seed open-weight reserve | finished |
| [FI-WP-0004](workplans/FI-WP-0004-operational-loop-and-scaleway-reserve.md) | Durable loop + Scaleway reserve | **active** |

---

## Collection plan (bulk reserve)

**SoT:** Scaleway Object Storage `nl-ams` · bucket `railiance-fi-open-weight-reserve`  
**Gate:** **€15 / month** · R = One Zone IA · S = Glacier  
**Transfer:** diskless streaming on Railiance → Scaleway; [operations](docs/streaming-reserve.md)
**Policy:** store the **most capable open weights** even if unrunnable today  
(`docs/decisions/2026-09-13-scaleway-object-reserve.md`).

| Tier | Examples |
| ---- | -------- |
| **R — runnable spine** | Qwen3-8B, Llama-3.2-3B-Instruct, BGE-M3, R1-Distill-14B, nomic-embed |
| **S — strategic** | **DeepSeek-V4-Flash-0731** (first pull), Kimi K3, V3/R1 full, 70B-class |
| **W — optional** | Qwen3.8-27B, 14B/32B upgrades, reranker |

Plan detail: `research/2026-07-24-nas-strategic-collection-plan.md` · catalog: `inventory/catalog/`.

---

## Layout

```text
freedom-intelligence/
├── INTENT.md / SCOPE.md / README.md
├── activity-definitions/     # fi-daily-research-brief (enabled; origin publish required)
├── briefs/                   # daily deltas
├── research/                 # deep surveys (baseline lives here)
├── inventory/catalog/        # YAML candidates / collected
├── docs/                     # playbook, sources, storage, hardware
├── workplans/                # FI-WP-*
└── history/
```

---

## Quick ops

**New brief**

```bash
mkdir -p briefs/$(date +%Y/%m)
cp briefs/_template.md briefs/$(date +%Y/%m)/$(date +%Y-%m-%d).md
# follow docs/daily-brief-playbook.md
```

**Bulk reserve collection streams on Railiance directly to Scaleway.**
Never stage model weights in WSL. See [streaming operations](docs/streaming-reserve.md).

**Durability check** (hub events vs git files):

```bash
python3 scripts/verify_brief_durability.py --require-hub --allow-reconciled
```

---

Historical gaps remain visible; [audit and reconciliation contract](docs/brief-durability-audit.md).

## License

MIT — see [`LICENSE`](LICENSE). Model weights retain **upstream** licenses.