跳到主要内容

Space 使用指南

AtomGit Space 是一个强大的在线应用部署和分享平台，让您能够轻松地将 AI 模型转化为可交互的 Web 应用。本指南将帮助您了解如何创建和管理 Space。

Space 创建​

创建新的 Space​

  1. 登录您的 AtomGit 账号
  2. 点击右上角"+" > "新建 Space"
  3. 填写基本信息：
    • space ID
    • Space 名称
    • Space 描述
    • license
  4. 选择 Space SDK 类型：
    • Gradio
    • Static
  5. 配置硬件资源：
    • CPU
    • 内存
    • GPU（如需要）
  6. 选择镜像版本
  7. 设置可见性
  8. 点击"创建"完成

Space 配置文件​

创建 space-config.yaml 文件定义 Space 配置：

space-name: my-awesome-app
version: 1.0.0
sdk: gradio
python_version: "3.9"
requirements:
  - gradio>=3.50.0
  - torch>=2.0.0
resources:
  cpu: 1
  memory: 2GB
  gpu: null

Space 搜索​

快速搜索​

  1. 在搜索框输入关键词
  2. 按照space类别筛选：
    • 生成创作
    • 对话系统
    • 文本处理
    • 多模态
    • 图像处理
    • 语音技术
    • 数据分析
    • 智能学习
    • 智能自动化

Space 激活​

通过 Web 界面​

  1. 进入 Space 详情页
  2. 点击"激活"按钮
  3. 选择部署配置：
    • 实例类型
    • 自动缩放设置
    • 环境变量

Space 使用​

开发模式​

import gradio as gr

def greet(name):
    return f"Hello {name}!"

demo = gr.Interface(fn=greet, inputs="text", outputs="text")

# 本地开发
demo.launch()

# 部署到 Space
demo.deploy()

Docker 部署​

FROM python:3.9-slim

WORKDIR /app
COPY . .
RUN pip install -r requirements.txt

EXPOSE 7860
CMD ["python", "app.py"]

环境变量配置​

# 设置环境变量
export MODEL_PATH=/path/to/model
export API_KEY=your-api-key

# 使用环境变量
import os
model_path = os.getenv("MODEL_PATH")

最佳实践​

  1. 应用开发

    • 使用响应式设计
    • 添加错误处理
    • 优化加载性能
    • 提供用户指南

  2. 资源管理

    • 合理配置资源
    • 使用缓存机制
    • 监控资源使用
    • 自动缩放设置

  3. 安全性

    • 输入验证
    • 访问控制
    • 数据加密
    • 日志记录

  4. 维护更新

    • 版本控制
    • 自动化测试
    • 监控告警
    • 定期更新依赖

常见问题​

Q: Space 支持哪些编程语言？

A: 主要支持 Python，同时通过 Docker 可以支持其他语言。

Q: 如何处理 Space 的性能问题？

A: 可以通过优化代码、使用缓存、调整资源配置等方式提升性能。

Q: 如何实现 Space 的自动更新？

A: 可以配置 GitHub Actions 或使用 AtomGit CI/CD 实现自动部署。

Q: Space 的访问限制是什么？

A: 免费账户有每月访问量和计算资源的限制，具体限制请查看价格页面。