README.md

---
title: Language Learning Partner
emoji: 💬
colorFrom: blue
colorTo: green
sdk: gradio
sdk_version: 5.39.0
app_file: app.py
pinned: false
license: mit
short_description: AI French conversation partner
---

# Language Learning Partner

AI French conversation partner

## Quick Setup

### Step 1: Configure API Key (Required)
1. Get your API key from https://openrouter.ai/keys
2. In Settings → Variables and secrets
3. Add secret: `API_KEY`
4. Paste your OpenRouter API key

### Step 2: Configure HuggingFace Token (Optional)
1. Get your token from https://huggingface.co/settings/tokens
2. In Settings → Variables and secrets
3. Add secret: `HF_TOKEN`
4. Paste your HuggingFace token (needs write permissions)
5. This enables automatic configuration updates


### Step 3: Set Access Code
1. In Settings → Variables and secrets
2. Add secret: `ACCESS_CODE`
3. Set your chosen password
4. Share with authorized users


### Step 3: Test Your Space
Your Space should now be running! Try the example prompts or ask your own questions.

## Configuration
- **Model**: google/gemma-3-27b-it
- **API Key Variable**: API_KEY
- **HF Token Variable**: HF_TOKEN (for auto-updates)
- **Access Control**: Enabled (ACCESS_CODE)

## Support
For help, visit the HuggingFace documentation or community forums.