README.md

---
title: Ling Space
emoji: 🤖
colorFrom: blue
colorTo: green
sdk: gradio
sdk_version: 5.49.1
python_version: 3.13.7
app_file: app.py
pinned: false
secrets:
- OPENAI_API_KEY
- LING_API_TOKEN
---

# Ling Space

这是一个用于与 Ling 系列模型进行交互的 Gradio 应用。

## 功能

- **文本聊天**: 与 Ling 模型进行对话。
- **模型选择**: 在多个可用模型之间切换。
- **可配置性**: 通过配置文件轻松添加和管理模型。

## 密钥管理 (Secrets Management)

### 本地开发 (Local Development)

1.  **创建密钥文件**: 在 `ling-space` 目录下，创建一个名为 `.secrets` 的文件。
2.  **添加密钥**: 在 `.secrets` 文件中，以 `KEY="VALUE"` 的格式添加你的 API 密钥。例如：
    ```
    OPENAI_API_KEY="your_openai_api_key_here"
    LING_API_TOKEN="your_ling_api_token_here"
    ```
3.  **代码加载**: `model_handler.py` 使用 `python-dotenv` 库自动从 `.secrets` 文件加载这些环境变量。你可以在代码中通过 `os.environ.get("YOUR_KEY_NAME")` 来访问它们。

**注意**: `.secrets` 文件已被 `.gitignore` 忽略，确保你的密钥不会被意外提交。

### 生产环境 (Hugging Face Spaces)

1.  **设置 Secret**: 在你的 Hugging Face Space 的 "Settings" -> "Secrets and variables" 页面，添加你的 API 密钥作为 "Secret"。
2.  **声明 Secret**: 本 `README.md` 文件顶部的 `secrets` 字段已经声明了应用需要哪些密钥。Hugging Face 会在运行时将这些 Secrets 作为环境变量注入。
3.  **代码访问**: 你的代码无需修改，它会像在本地一样通过 `os.environ.get("YOUR_KEY_NAME")` 自动访问这些密钥。