Skip to main content

ChatUp

ChatUp 是 ChatArch 的独立环境与工具安装 CLI。它承接原来 chattool setup 的职责,把常用开发环境、Agent CLI、工作区脚手架和本地服务安装整理成一级命令,例如 chattool setup workspace 对应 chatup workspace。

按场景选择文档:

场景 文档
从空机器验证 ChatUp、Python runtime 和 workspace docs/quickstart.md
阅读完整顶层 CLI 树和独立 CFT/ChromeDriver/Playwright contract docs/cli-tree.md
查看命令分组、参数边界和服务默认路径 docs/commands.md
校对哪些 ChatArch setup 流程已经有一等命令 docs/capability-map.md
预览或配置 Linux X11 Computer Use 执行端 docs/computer-use.md
理解 chatup workspace 创建的目录和项目记录约定 docs/workspace.md
安装 ChatTea-compatible Gitea、Discourse/Zulip 社区服务配置、ChatData-compatible MySQL、user-level NGINX 和 CRS docs/commands.md

快速开始

chatup --help
chatup --version
chatup --tree
chatup --tree-brief
chatup doctor
chatup uv
chatup chrome-for-testing install --channel stable -I
chatup playwright install 1.61.1 -I
chatup workspace ~/Playground

chatup uv 默认更新已有 ~/.bashrc、~/.zshrc 的自动激活块;使用 chatup uv --no-activate 可保持启动配置不变。不会创建缺失的 rc 文件,Windows 跳过此项。

Linux Debian/Ubuntu x86_64 X11 执行端可运行 chatup computer-use 只读预览;明确使用 chatup computer-use --sudo 才应用。支持显式选择同用户桌面并复用普通 Chrome 默认 profile,生成独立 MCP/Chrome/terminal/status 入口。它不修改 Agent 配置,也不修复 Hermes 按话题 SSH 绑定的默认截图路由。详见 Computer Use。

常见安装命令:

chatup gitea --force
chatup glance --dry-run
chatup glance
chatup discourse -e discourse-prod --hostname discourse.public.wzhecnu.cn
chatup zulip -e zulip-prod --external-host zulip.public.wzhecnu.cn --port 3095
chatup mysql
chatup nginx
chatup nginx proxy-pass ./gitea-local.conf --set SERVER_NAME=gitea.local.example.invalid --set PROXY_PASS=http://127.0.0.1:3000
chatup crs --install-dir ~/.chatarch/crs/local --port 12392 --redis-port 6379

macOS 常用应用

chatup macos                       # 勾选安装,Apple Silicon 默认全选四项
chatup macos --app snipaste         # 只安装 Snipaste
chatup macos --app blender          # 安装 Blender 5.2.2 LTS(Apple Silicon)
chatup macos -I                    # 不询问,安装当前机器支持的全部选项
chatup macos --dry-run             # 只预览安装计划

仅限 macOS。Apple Silicon 默认勾选 Snipaste、iTerm2、Chrome、Blender;Intel 保持前三项。终端中用空格切换勾选,回车安装;取消全部勾选则直接退出。可重复传入 --app snipaste|iterm|chrome|blender 选择多个应用。直接使用官方安装包,无需 Homebrew,已有应用验证后复用。详见macOS 安装入口。

全命令复选入口

chatup all                                        # 当前系统支持的命令复选框;默认不勾选
chatup all --list                                 # 只读列出可选命令
chatup all --only uv --only chrome --dry-run -I  # 只预览选中的命令
chatup all --only 'playwright install' -i        # 命令组的子命令,按原命令补参数

chatup all 从注册的 CLI 命令树列出当前系统支持的所有命令,包括基础环境、桌面应用、Agent、工作区、本地服务及浏览器管理子命令;不再局限于 uv/Node.js/桌面。无交互时必须用 --only 显式选择;--dry-run 只显示会执行的命令。选择后沿用原命令的参数、权限与确认规则;需要额外必填参数或删除确认的命令不会由 all 自动补齐。详见命令参考。

UU 远程

chatup uuremote --dry-run
chatup uuremote --sudo  # 仅首次安装需要;官方 pkg 会注册服务并启动客户端

支持 macOS 11+(Apple Silicon/Intel),固定官方 4.46.0 包并校验 SHA-256、Apple 安装包签名与公证;已有受信应用直接验证并复用。安装不会替你登录、授予屏幕录制/辅助功能权限或启用远程被控。详见命令参考。

Remotion 视频项目

chatup remotion ./my-video --dry-run -I
chatup remotion ./my-video -I
cd my-video
npm run studio

需要已有 Node.js >=18.12 和 npm >=9。创建带锁文件的 Remotion 4.0.530 项目,检测本机 Chrome 并输出渲染命令;不覆盖已有无关目录,也不替换 Node 或下载浏览器。项目放在指定目录,已有 Blender/Chrome 可通过 chatup macos --app blender --app chrome 验证或安装。详见Remotion 安装约定。

Chrome、Snipaste 与 iTerm2

chatup chrome --dry-run
chatup chrome             # 按系统安装普通 Google Chrome
chatup snipaste           # 在 macOS 或 Windows 安装 Snipaste
chatup iterm              # 安装 iTerm2,仅限 macOS
chatup chrome --sudo --yes # Linux:允许提权并确认包安装

macOS 直接下载官方 DMG/ZIP 并校验开发者签名,无需 Homebrew;默认装到 /Applications,不可写时使用 ~/Applications。Windows 使用 WinGet 精确包 Google.Chrome.EXE(当前用户安装)和 liule.Snipaste,需以 --yes 接受首次协议,Chrome 还会验证已安装程序的 Google 签名、产品身份和版本;Linux x86_64 支持 Chrome 的官方 DEB/RPM 与 apt/dnf/yum/zypper。已安装时验证并复用,不改默认浏览器、终端或用户配置。自动化浏览器仍使用 chatup chrome-for-testing。详见安装约定。

微信输入法

chatup wetype --dry-run
chatup wetype

安装官方签名的 macOS 微信输入法,验证并复用已有安装,并提示首次启用方式。默认按住 Fn 说话,Fn+空格开始连续输入;在「微信输入法设置 → 语音输入」中自定义。详见微信输入法约定。

豆包电脑版

chatup doubao --dry-run
chatup doubao

在 macOS 12+ 的 Apple Silicon 或 Intel Mac 安装官方豆包 2.34.6,校验开发者签名与公证,无需 Homebrew。验证并复用已有安装;不自动启动、登录、授权或加入 chatup macos 默认集合。详见豆包安装约定。

ChatGPT / Codex 桌面应用

chatup chatgpt --dry-run
chatup chatgpt
chatup chatgpt --yes  # Windows 首次安装时接受 Store 协议

安装包含 Codex 的新版官方 ChatGPT 桌面应用。macOS 需要 Homebrew,Windows 需要 WinGet;Linux preview 暂按官方说明手动安装。现有 chatup codex 仍安装/配置 Codex CLI。不会自动启动、登录或升级已有应用;完整约定。

chatup codex、chatup hermes 未配置模型时默认使用 gpt-5.6-terra;用户指定的模型和已有配置仍优先。

当前能力

能力组 命令
基础运行环境 doctor、uv、nodejs、docker、zsh、chrome-for-testing、chromedriver、playwright、frp
工作区脚手架 workspace
全命令入口与桌面应用 all(按系统筛选完整 CLI 树)、macos(Snipaste/iTerm2/Chrome/Blender 多选)、chrome、snipaste(macOS/Windows)、iterm / wetype / doubao / uuremote(仅 macOS)、chatgpt(含 Codex)
Linux X11 Computer Use computer-use(默认只读预览,--sudo 应用)
视频项目 remotion
本地服务安装 gitea、glance、discourse、zulip、mysql、nginx、crs
Agent 工具链 cc-connect、claude、codex、cursor-agent、opencode、hermes、lark-cli

chatup glance 裸命令安装 ChatArch/glance 最新稳定维护版到有效 ChatArch home 下的 glance。当前仅支持 Linux amd64;严格验证归档、SHA256SUMS、BUILDINFO.txt、source SHA 和原始二进制版本,复用 ChatGlance portable API 初始化 loopback 配置。它不启动服务、不建立公网入口、不写密码;重复运行保留配置和数据,版本变更请使用 chatglance runtime update。

桌面应用使用系统原生应用目录;ChatArch 自管安装项默认目录收敛到 ~/.chatarch/...,例如 ~/.chatarch/chrome-for-testing、~/.chatarch/chromedriver、~/.chatarch/playwright、~/.chatarch/chattea、~/.chatarch/discourse、~/.chatarch/zulip、~/.chatarch/chatdata、~/.chatarch/nginx 和 ~/.chatarch/crs/local。cursor-agent 额外注册 ChatEnv CursorAgent profile,discourse/zulip 注册管理员凭据 profile,并支持 -e/--env 从 env 文件或 profile 快速配置;显式选择 profile 时不会混入进程环境中的其他账号凭据。CLI 树由 ChatStyle 的注册表渲染。更完整的能力边界见 docs/capability-map.md。

开发

python -m pytest -q
python -m build
python -m twine check dist/*
mkdocs build --strict
chatup --version
chatup --tree
chatup --tree-brief

更多使用说明见文档站的 快速开始、命令参考 和 CLI 能力地图。

发布

发布由 tag 驱动。vX.Y.Z tag 必须与 src/chatup/__init__.py::__version__ 一致;发布 workflow 会通过 PyPI Trusted Publishing/OIDC 构建并发布到 PyPI。

Metadata

Release files for chatup 0.2.27

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for chatup 0.2.27
File Size Uploaded Provenance Actions
chatup-0.2.27.tar.gz 300.4 kB With provenance Details for chatup-0.2.27.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for chatup 0.2.27
File Interpreter ABI Platform Actions
chatup-0.2.27-py3-none-any.whl Python 3 none any Details for chatup-0.2.27-py3-none-any.whl

Total release size: 586.6 kB

Release files / chatup-0.2.27.tar.gz

Download URL chatup-0.2.27.tar.gz
Size 300.4 kB
Tags Source
SHA-256 checksum
How to use checksums
af4c5c11726eb6d1678131e85d4d082782168c97038d69c198c86650ea5cac47
BLAKE2b-256 checksum
How to use checksums
e65a4c5408a9e2027f8ba86f6f1e3776f366b4abaa95745477ce720745764d57
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 10, 2026.

Transparency log

Release files / chatup-0.2.27-py3-none-any.whl

Download URL chatup-0.2.27-py3-none-any.whl
Size 286.2 kB
Tags Python 3
SHA-256 checksum
How to use checksums
b45837a0800faaf462bdc1d71ecd1e4f746b7276a7ebad36d48f395edc1da6f4
BLAKE2b-256 checksum
How to use checksums
44f50591964edd39a2a5c69b59a8464954657fa7925656b3360943a0fb97b6a6
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 10, 2026.

Transparency log

Security for chatup 0.2.27

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for chatup-0.2.27.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 10, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.2.27 This release

2 release files Full provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page