ChatUp
ChatUp 是 ChatArch 的独立环境与工具安装 CLI。它承接原来 chattool setup 的职责，把常用开发环境、Agent CLI、工作区脚手架和本地服务安装整理成一级命令，例如 chattool setup workspace 对应 chatup workspace。
- 文档站：https://arch.gh.wzhecnu.cn/ChatUp/
- English README: README.en.md
- Source: https://github.com/ChatArch/ChatUp
按场景选择文档：
| 场景 | 文档 |
|---|---|
| 从空机器验证 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 |
理解 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 default ~/Playground
chatup uv 默认更新已有 ~/.bashrc、~/.zshrc 的自动激活块；使用 chatup uv --no-activate 可保持启动配置不变。不会创建缺失的 rc 文件，Windows 跳过此项。
常见安装命令：
chatup gitea --force
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
Chrome 与 iTerm2
chatup chrome --dry-run
chatup chrome # 按系统安装普通 Google Chrome
chatup iterm # 安装 iTerm2，仅限 macOS
chatup chrome --sudo --yes # Linux：允许提权并确认包安装
macOS 直接下载官方 DMG/ZIP 并校验开发者签名，无需 Homebrew；默认装到 /Applications，不可写时使用 ~/Applications。Windows 使用 WinGet Google.Chrome；Linux x86_64 使用官方 DEB/RPM 与 apt/dnf/yum/zypper。已安装时验证并复用，不改默认浏览器、终端或用户配置。自动化浏览器仍使用 chatup chrome-for-testing。详见安装约定。
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 |
| 桌面应用 | chrome、iterm（仅 macOS）、chatgpt（含 Codex） |
| 本地服务安装 | gitea、discourse、zulip、mysql、nginx、crs |
| Agent 工具链 | cc-connect、claude、codex、cursor-agent、opencode、hermes、lark-cli |
桌面应用使用系统原生应用目录；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。
1 maintainer
Metadata
1 maintainer
Release files for chatup 0.2.18
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| chatup-0.2.18.tar.gz | 208.4 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| chatup-0.2.18-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 422.7 kB
Release files / chatup-0.2.18.tar.gz
| Download URL | chatup-0.2.18.tar.gz |
|---|---|
| Size | 208.4 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
73f1baf2854aa6ac1e06d53178252d1160ccb1dd54199a94381284434fee4092
|
|
BLAKE2b-256 checksum How to use checksums |
4f27a13d2338621c43a6773007408b402f642e17756c21edce188e3d50258069
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
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 Sep 29, 2026.
Transparency logRelease files / chatup-0.2.18-py3-none-any.whl
| Download URL | chatup-0.2.18-py3-none-any.whl |
|---|---|
| Size | 214.3 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
2634180e39689c57a70fbe2626fbfc196ee498542c40148eab5299b3472c173f
|
|
BLAKE2b-256 checksum How to use checksums |
cf06ef209d66edf669252e3fec3db0340ee18cfc89860ddaecba5d7829f4dd1d
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
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 Sep 29, 2026.
Transparency log
