setup_secrets.md

# Setup Secrets on Hugging Face Spaces

After uploading these files to your HF Space, configure secrets:

## Required (at least one)

Go to: **Settings → Variables and secrets**

Add:

```
ANTHROPIC_API_KEY = sk-ant-...
```

OR

```
OPENAI_API_KEY = sk-...
```

OR

```
GOOGLE_API_KEY = AIza...
```

## Optional

```
HUGGINGFACE_API_KEY = hf_...
PRIMARY_MODEL_PROVIDER = anthropic
PRIMARY_MODEL = claude-3-5-sonnet-20241022
```

## Testing

After setting secrets:
1. Wait for Space to rebuild (~3-5 min)
2. Open your app
3. Create a test character
4. Verify AI generation works

## Troubleshooting

**Build fails:**
- Check requirements.txt syntax
- Verify all files uploaded

**App crashes:**
- Check Logs tab for errors
- Verify API keys in Secrets

**No AI generation:**
- Confirm at least one API key is set
- Check API key is valid
- Review error messages in Status box