# Projects — DOX

## Purpose

Three hackathon Gradio apps, each targeting specific badges and tracks.

## Ownership

- Each project owns its own app.py, modules, requirements, and HF Space
- Shared inference and aesthetic code lives in `shared/`

## Local Contracts

- Each project must be deployable as an independent HF Space
- Apps inherit cedar-copper aesthetic from `shared/cedar_copper_tokens.py`
- Inference via `shared/inference_client.py` — always-fallback pattern

## Work Guidance

- Iterate on live HF Spaces, not localhost
- Per-project model override env vars: `TINYBARD_MODEL`, `FOCUSFRIEND_MODEL`, `CRITTERCALM_MODEL`
- Per-project cooldown env vars: `TINYBARD_COOLDOWN_SECONDS`, etc.

## Verification

- Each app deploys to its HF Space without errors
- Cooldown system active per project
- Cedar-copper aesthetic renders correctly

## Child DOX Index

- `crittercalm/llms.txt` — Backyard AI pet calming app
- `focusfriend/llms.txt` — Focus and mindfulness companion
- `tinybard/llms.txt` — Interactive text adventure generator