Deploy from GitHub Actions 863023faed1504d258dc4bbe3153d7092146e495

.env.example

@@ -0,0 +1,49 @@
+# Grok2API environment example
+#
+# 用法：
+# 1. 复制为 .env 后按需修改
+# 2. 启动期 / 部署期变量放这里
+# 3. 常规运行时配置优先改 ${DATA_DIR}/config.toml
+
+
+# ==================== 基础运行 ====================
+TZ=Asia/Shanghai
+LOG_LEVEL=INFO
+# 写入本地文件日志
+LOG_FILE_ENABLED=true
+# 账号目录增量同步间隔（秒）
+ACCOUNT_SYNC_INTERVAL=30
+
+
+# ==================== Web 服务 / Docker Compose ====================
+SERVER_HOST=0.0.0.0
+SERVER_PORT=8000
+SERVER_WORKERS=1
+
+# Docker Compose 宿主机映射端口
+HOST_PORT=8000
+
+
+# ==================== 账号存储（启动期） ====================
+# 可选：local | redis | mysql | postgresql
+ACCOUNT_STORAGE=local
+
+# redis: Redis DSN（ACCOUNT_STORAGE=redis 时必填）
+# ACCOUNT_REDIS_URL=redis://:password@host:6379/0
+
+# mysql: SQLAlchemy DSN
+# ACCOUNT_MYSQL_URL=mysql+aiomysql://user:password@127.0.0.1:3306/grok2api
+
+# postgresql: SQLAlchemy DSN
+# ACCOUNT_POSTGRESQL_URL=postgresql+asyncpg://user:password@127.0.0.1:5432/grok2api
+
+# SQL 连接池（mysql / postgresql 模式，以下均为默认值，无需改动即可生效）
+# ACCOUNT_SQL_POOL_SIZE=5
+# ACCOUNT_SQL_MAX_OVERFLOW=10
+# ACCOUNT_SQL_POOL_TIMEOUT=30
+# ACCOUNT_SQL_POOL_RECYCLE=1800
+
+
+# ==================== 可选：本地数据 / 日志目录 ====================
+DATA_DIR=./data
+LOG_DIR=./logs

Dockerfile

@@ -0,0 +1,44 @@
+FROM python:3.13-slim
+
+ENV PYTHONDONTWRITEBYTECODE=1 \
+    PYTHONUNBUFFERED=1 \
+    TZ=Asia/Shanghai \
+    VIRTUAL_ENV=/app/.venv \
+    PATH=/app/.venv/bin:/root/.local/bin:$PATH \
+    SERVER_HOST=0.0.0.0 \
+    SERVER_PORT=7860 \
+    SERVER_WORKERS=1 \
+    DATA_DIR=/data \
+    LOG_DIR=/data/logs
+
+WORKDIR /app
+
+EXPOSE 7860
+
+RUN apt-get update \
+    && apt-get install -y --no-install-recommends \
+        build-essential \
+        curl \
+        ca-certificates \
+        git \
+        libffi-dev \
+        libssl-dev \
+    && rm -rf /var/lib/apt/lists/*
+
+COPY --from=ghcr.io/astral-sh/uv:0.6.17 /uv /uvx /bin/
+
+RUN git clone --depth 1 https://github.com/chenyme/grok2api.git /tmp/src \
+    && cp /tmp/src/pyproject.toml /app/pyproject.toml \
+    && cp /tmp/src/uv.lock /app/uv.lock \
+    && uv sync --frozen --no-dev --no-install-project \
+    && cp -r /tmp/src/app /app/app \
+    && cp /tmp/src/config.defaults.toml /app/config.defaults.toml \
+    && rm -rf /tmp/src
+
+COPY start.sh /app/start.sh
+
+RUN chmod +x /app/start.sh \
+    && mkdir -p /data /data/logs
+
+ENTRYPOINT ["/app/start.sh"]
+CMD ["granian", "--interface", "asgi", "--host", "0.0.0.0", "--port", "7860", "--workers", "1", "app.main:app"]

README.md

@@ -0,0 +1,36 @@
+---
+title: Grok2Api
+emoji: 🚀
+colorFrom: indigo
+colorTo: blue
+sdk: docker
+app_port: 7860
+pinned: false
+---
+
+# Grok2Api on Hugging Face Spaces
+
+This Space runs the Grok2Api FastAPI service in Docker mode.
+
+## Runtime Notes
+
+- Persistent data is stored in the mounted bucket at `/data`
+- Runtime environment file: `/data/.env`
+- Runtime config file: `/data/config.toml`
+- Logs directory: `/data/logs`
+- Service port: `7860`
+
+## Runtime Variables
+
+Runtime variables are expected to come from `/data/.env` in the mounted bucket.
+
+Optional HF Space variables only used as fallback:
+
+- `SPACE_HOST`
+- `SPACE_ID`
+
+## Build Mode
+
+This deployment does not pull a prebuilt image.
+
+The GitHub workflow only syncs the local `huggingface` directory to the Hugging Face Space repository root. During Docker build, the Space clones the latest upstream source from `https://github.com/chenyme/grok2api` and builds from that source.

start.sh

@@ -0,0 +1,34 @@
+#!/usr/bin/env sh
+set -eu
+
+DATA_DIR="${DATA_DIR:-/data}"
+LOG_DIR="${LOG_DIR:-/data/logs}"
+ENV_FILE="$DATA_DIR/.env"
+CONFIG_FILE="$DATA_DIR/config.toml"
+DEFAULT_CONFIG="/app/config.defaults.toml"
+
+mkdir -p "$DATA_DIR" "$LOG_DIR"
+
+if [ -f "$ENV_FILE" ]; then
+  set -a
+  . "$ENV_FILE"
+  set +a
+fi
+
+if [ ! -f "$CONFIG_FILE" ]; then
+  cp "$DEFAULT_CONFIG" "$CONFIG_FILE"
+  echo "Initialized runtime config at $CONFIG_FILE"
+fi
+
+SPACE_HOST="${SPACE_HOST:-}"
+SPACE_ID="${SPACE_ID:-}"
+
+if [ -n "$SPACE_HOST" ]; then
+  sed -i "s|^app_url = .*|app_url = \"https://$SPACE_HOST\"|" "$CONFIG_FILE"
+elif [ -n "$SPACE_ID" ]; then
+  sed -i "s|^app_url = .*|app_url = \"https://${SPACE_ID}.hf.space\"|" "$CONFIG_FILE"
+fi
+
+chmod 600 "$CONFIG_FILE" || true
+
+exec "$@"