coderfleet 0.1.0__tar.gz

coderfleet-0.1.0/.github/workflows/publish.yml

@@ -0,0 +1,50 @@
+name: Publish to PyPI
+
+on:
+  release:
+    types: [published]
+
+permissions:
+  contents: read
+
+jobs:
+  publish:
+    name: Build and publish
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/p/coderfleet
+    permissions:
+      contents: read
+      id-token: write
+
+    steps:
+      - name: Check out repository
+        uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Verify release tag matches package version
+        run: |
+          python - <<'PY'
+          import os
+          import tomllib
+          from pathlib import Path
+
+          tag = os.environ["GITHUB_REF_NAME"]
+          version = tomllib.loads(Path("pyproject.toml").read_text())["project"]["version"]
+          expected = f"v{version}"
+          if tag not in {version, expected}:
+              raise SystemExit(f"Release tag {tag!r} does not match package version {version!r} or {expected!r}")
+          PY
+
+      - name: Build distributions
+        run: |
+          python -m pip install --upgrade build
+          python -m build
+
+      - name: Publish distributions to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1

coderfleet-0.1.0/.gitignore

@@ -0,0 +1,55 @@
+# ── 自动生成的编排文件（由 coderfleet apply 生成）──────────
+docker-compose.yml
+
+# ── 账号认证数据（敏感凭据，绝对不能入库）────────────────
+accounts/
+
+# ── 任务执行记录与日志 ────────────────────────────────────
+tasks/*.json
+tasks/*.log
+!tasks/.gitkeep
+
+# ── 容器任务临时文件（I/O 解耦写入项目目录）──────────────
+.coderfleet-tasks/
+.*-tasks/
+
+# ── 任务链会话记录 ────────────────────────────────────────
+conversations/*.json
+!conversations/.gitkeep
+
+# ── Python ────────────────────────────────────────────────
+__pycache__/
+*.pyc
+*.pyo
+*.egg-info/
+.venv/
+venv/
+
+# ── macOS ─────────────────────────────────────────────────
+.DS_Store
+
+# ── IDE / 编辑器 ──────────────────────────────────────────
+.idea/
+.vscode/
+*.swp
+*.swo
+*~
+
+accounts.conf
+config.conf
+projects.conf
+
+.claude/settings.local.json
+
+.agent
+# ── 视频等大体积媒体文件 ───────────────────────────────
+*.mp4
+
+.claude/worktrees
+
+core
+
+.coderfleet-uploads
+.*-uploads
+
+server.log

coderfleet-0.1.0/CLAUDE.md

@@ -0,0 +1,73 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## What this project is
+
+CoderFleet runs multiple Claude Code / Codex CLI accounts in isolated Docker containers on a single host, pooling quota across accounts. Each account gets its own container with independent auth, proxied through a gost relay so all outbound traffic flows through the host proxy.
+
+## Key commands
+
+```bash
+# Container lifecycle
+coderfleet build              # Build the shared Docker image (first time ~5–10 min)
+coderfleet apply              # Regenerate docker-compose.yml and restart all containers
+coderfleet up / down / restart
+
+# Account & project management (edits accounts.conf / projects.conf then requires apply)
+coderfleet account add <name> TYPE=claude|codex [--auth login|env] [--proxy relay|off]
+coderfleet project add <name> <account> <host-path>
+coderfleet login <account>    # Interactive OAuth; starts a temp container if needed
+
+# Scheduler server (required for task commands and Web UI)
+coderfleet server             # Starts FastAPI on :8765; Web UI at http://localhost:8765
+
+# Task submission (requires server running)
+coderfleet task run "<prompt>" --project <name> [--auto] [--conversation <id>] [--new-chain <name>]
+coderfleet task list
+coderfleet task logs <id> [-f]
+```
+
+Run the Python test suite with `uv run --with pytest pytest -q`.
+
+## Architecture
+
+### Two modes of operation
+
+1. **Interactive** — `coderfleet enter <project>` drops into a container shell; user runs `claude` or `codex` directly.
+2. **Scheduled** — `coderfleet server` runs the FastAPI scheduler; tasks are submitted via CLI or Web UI and executed non-interactively inside containers.
+
+### Component map
+
+| Component | Role |
+|-----------|------|
+| `coderfleet/cli.py` | Click entry point for all host-side operations. |
+| `coderfleet/server/main.py` | FastAPI app. Defines all REST endpoints and WebSocket terminal handler. |
+| `coderfleet/server/scheduler.py` | Core task queue. Resolves account/project, spawns async tasks inside containers via `docker exec`, tracks state. |
+| `coderfleet/server/models.py` | Pydantic models: `Task`, `Conversation`, `Account`, `Project` and their HTTP request/response shapes. |
+| `coderfleet/server/docker_mgr.py` | Docker API wrapper (container status, exec). |
+| `coderfleet/server/terminal.py` | WebSocket ↔ `docker exec -it` bridge for the in-browser terminal. |
+| `coderfleet/server/static/` | Single-page Web UI (vanilla JS, no build step). JS is split into `chat.js`, `projects.js`, `tasks.js`, `accounts.js`, `nav.js`, `state.js`, `utils.js`. |
+
+### Data storage (all under workspace root)
+
+- `config.conf`, `accounts.conf`, `projects.conf` — authoritative config files; `docker-compose.yml` is **generated** from these, never edit it manually.
+- `accounts/<name>/` — per-account CLI auth data mounted into containers.
+- `tasks/*.json` — task state records.
+- `tasks/*.log` — task execution logs.
+- `conversations/*.json` — conversation (task chain) records.
+
+### Task / Conversation model
+
+A **Task** is a single `claude`/`codex` invocation inside a container. A **Conversation** is a named chain of tasks that share context via `--resume {native_session_id}`. Tasks store `project` (path) and `project_name` (config name) — both are needed because multiple projects can share the same path, and sidebar grouping uses `project_name` for disambiguation.
+
+### Network isolation
+
+Containers join an `internal: true` Docker network; they cannot reach the public internet directly. All traffic is forced through a `coderfleet-proxy-relay` container running gost, which forwards to the host proxy (Clash/v2ray). `PROXY=off` accounts skip the relay and connect to the default bridge.
+
+### Frontend conventions
+
+- Global mutable state lives in `state.js` (e.g. `activeConversationId`, `chatNewSessionProject`, `projectsCache`).
+- `conversationBelongsToProject` and `taskBelongsToProject` (in `projects.js`) are used everywhere for sidebar grouping — if `project_name` is present, it takes precedence over path matching.
+- SSE (`EventSource`) is used for real-time log streaming; WebSocket for the terminal.
+- New chat sessions are always started from a per-project "+" button, so `chatNewSessionProject` is pre-set before the empty chat state renders.

coderfleet-0.1.0/Dockerfile

@@ -0,0 +1,92 @@
+# ============================================================
+#  CoderFleet — 统一工作容器镜像
+#  包含：Python 3.12 / Node.js 20 / Codex CLI / Claude Code
+#  平台：linux/amd64（Apple Silicon 通过 Docker 模拟运行）
+# ============================================================
+
+FROM --platform=linux/amd64 ubuntu:24.04
+
+# 避免交互式安装询问
+ENV DEBIAN_FRONTEND=noninteractive
+ENV TZ=Asia/Shanghai
+
+# ── 基础系统工具 ──────────────────────────────────────────
+RUN apt-get update && apt-get install -y --no-install-recommends \
+    # 网络工具
+    curl wget ca-certificates netcat-openbsd \
+    # 开发基础
+    git build-essential pkg-config \
+    # Python 依赖
+    libssl-dev libffi-dev zlib1g-dev libbz2-dev \
+    libreadline-dev libsqlite3-dev liblzma-dev \
+    # 系统工具
+    bash-completion less vim nano \
+    && apt-get clean && rm -rf /var/lib/apt/lists/*
+
+# ── Node.js 20 (via NodeSource) ───────────────────────────
+RUN curl -fsSL https://deb.nodesource.com/setup_20.x | bash - \
+    && apt-get install -y nodejs \
+    && apt-get clean && rm -rf /var/lib/apt/lists/*
+
+# 验证 Node 版本并安装常用全局包
+RUN node --version && npm --version \
+    && npm install -g npm@latest
+
+# ── Python 3.12 (via deadsnakes PPA) ─────────────────────
+RUN apt-get update && apt-get install -y --no-install-recommends \
+    software-properties-common \
+    && add-apt-repository ppa:deadsnakes/ppa \
+    && apt-get update && apt-get install -y --no-install-recommends \
+    python3.12 python3.12-dev python3.12-venv python3-pip \
+    && apt-get clean && rm -rf /var/lib/apt/lists/*
+
+# 设置 python3.12 为默认 python3
+RUN update-alternatives --install /usr/bin/python3 python3 /usr/bin/python3.12 1 \
+    && update-alternatives --install /usr/bin/python  python  /usr/bin/python3.12 1
+
+# 安装常用 Python 工具
+# Ubuntu 24.04 实行 PEP 668，系统 Python 需加 --break-system-packages
+RUN pip3 install --no-cache-dir --break-system-packages \
+    uv ruff black mypy pexpect
+
+# ── Codex CLI ─────────────────────────────────────────────
+RUN npm install -g @openai/codex
+
+# ── Claude Code CLI ───────────────────────────────────────
+RUN npm install -g @anthropic-ai/claude-code
+
+# ── Rust 1.93.0 ───────────────────────────────────────────
+ENV RUSTUP_HOME=/usr/local/rustup \
+    CARGO_HOME=/usr/local/cargo \
+    PATH=/usr/local/cargo/bin:$PATH \
+    RUSTUP_DIST_SERVER=https://rsproxy.cn \
+    RUSTUP_UPDATE_ROOT=https://rsproxy.cn/rustup
+RUN curl --proto '=https' --tlsv1.2 -sSf https://rsproxy.cn/rustup-init.sh | sh -s -- -y --no-modify-path --default-toolchain 1.93.0 \
+    && chmod -R a+w $RUSTUP_HOME $CARGO_HOME \
+    && rustc --version
+
+# ── 创建非特权用户 byclaw ─────────────────────────────────
+RUN groupadd -r byclaw && useradd -r -g byclaw -m -s /bin/bash byclaw
+
+# ── 工作目录和环境变量 ────────────────────────────────────
+RUN mkdir -p /workspace && chown byclaw:byclaw /workspace
+WORKDIR /workspace
+
+# 这两个目录由 CoderFleet 按账号挂载，容器内路径固定
+# Codex 认证：/home/byclaw/.codex   由 CODEX_HOME 控制
+# Claude 认证：/home/byclaw/.claude  由 CLAUDE_CONFIG_DIR 控制
+ENV CODEX_HOME=/home/byclaw/.codex
+ENV CLAUDE_CONFIG_DIR=/home/byclaw/.claude
+
+# ── 启动脚本 ──────────────────────────────────────────────
+COPY entrypoint.sh /entrypoint.sh
+RUN chmod +x /entrypoint.sh
+
+COPY scripts/coderfleet_usage_status.py /usr/local/bin/coderfleet-usage-status
+RUN chmod +x /usr/local/bin/coderfleet-usage-status
+
+# ── 切换为非特权用户 ──────────────────────────────────────
+USER byclaw
+
+ENTRYPOINT ["/entrypoint.sh"]
+CMD ["sleep", "infinity"]