# Env Helper

> Resolves shared ecosystem environment constants (HuggingFace credentials, dataset repo IDs, project root path) for any plugin without depending on internal shared libraries.

- Skill: `richfrem/env-helper-3` (Agent Skill)
- Install (CLI): `npx skillmds@latest add richfrem/env-helper-3`
- Raw SKILL.md: https://api.skillmd.com/api/skills/richfrem/env-helper-3/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: richfrem (https://skillmd.com/u/richfrem)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/richfrem/env-helper-3

---


# env-helper Skill

## Purpose
Provides a single, zero-dependency Python helper (`env_helper.py`) that any plugin can call to safely resolve ecosystem constants.

## Usage

```bash
# Resolve a single key
python3 plugins/env-helper/scripts/env_helper.py --key HF_TOKEN

# Dump all known constants as JSON
python3 plugins/env-helper/scripts/env_helper.py --all

# Get the full HuggingFace upload config block
python3 plugins/env-helper/scripts/env_helper.py --hf-config
```

## Importing in Python
```python
import sys
sys.path.insert(0, "plugins/env-helper/scripts")
from env_helper import resolve, resolve_hf_config

token = resolve("HF_TOKEN")
hf_config = resolve_hf_config()
```

## Resolution Order
1. `os.environ` (process environment)
2. `.env` file at project root (walked up from script location)
3. Built-in defaults (e.g. `HF_DATASET_REPO=YouRepoDataSetName`)

## Known Constants
| Key | Description | Default |
|:---|:---|:---|
| `HF_TOKEN` | HuggingFace API token | *(required)* |
| `HF_USERNAME` | HuggingFace username | *(required)* |
| `HF_DATASET_REPO` | Dataset repo name | `YouRepoDataSetName` |
| `HF_LINEAGE_FOLDER` | Remote lineage folder name | `lineage` |
| `HF_SOUL_TRACES_FILE` | Remote JSONL traces path | `data/soul_traces.jsonl` |