awlevin/typesafe-computer-use

选用指南

AI 根据 README 整理 · 2026/10/14 14:11:10

使用方式

通过命令行使用，例如运行 `uv run clicker "目标描述"` 进行试运行，或添加 `--act` 参数执行实际操作。

查看 README 依据

Privacy & Security. Without the first, captures are wallpaper. Without the second, synthetic clicks are silently dropped, and `--act` refuses to start. ## First run ``` uv run clicker "open the Playground" # dry run: one step, prints what it would do uv run clicker "open the Playground" --act # drives the machine, up to 100 steps uv run clicker "log in" --act --steps 20 --delay 3 # longer and slower uv run clicker "log in" --act --handoffs 0 # the classifier alone: its first stop ends the run

部署要求

需要 macOS 14 或更高版本，Python 3.12 或更高版本，以及 uv 包管理器。需要 TypeSafe API 密钥，并授予终端屏幕录制和辅助功能权限。

查看 README 依据

[how a step works](docs/how-a-step-works.md). Every piece of reasoning the frontier model does for free has to be rebuilt here as deterministic state. ## Install macOS 14 or newer, Python 3.12 or newer, [uv](https://docs.astral.sh/uv/). Windows 10 and 11 are experimental; see [Windows](docs/windows.md). ``` git clone https://github.com/awlevin/typesafe-computer-use cd typesafe-computer-use uv sync cp .env.example .env # fill in the keys ``` | variable | required | purpose | |---|---|---| | `TYPESAFE_API_KEY` | yes | every decision |

| `ANTHROPIC_API_KEY` | no | `type_text`, writer-proposed URLs, and the final answer | | `CLICKER_EMAIL` | no | enables the `type_email` action | | `CLICKER_BROWSER` | no | defaults to `Google Chrome` | `.env` lives at the repo root and is read by every entry point (`clicker`, `clicker-inspect`). To run the writer on another model or endpoint (LM Studio, Ollama, any OpenAI-compatible server), see [writer endpoints](docs/writer-endpoints.md). Grant your terminal **Screen Recording** and **Accessibility** in System Settings >

已知限制

项目处于 Beta 阶段，正在积极开发中，可能存在粗糙之处，设置和行为可能在 0.x 版本间变化。

查看 README 依据

clicker "go to techcrunch and take me to the checkout page for the cheapest tickets to their next upcoming event" --act ``` > **Beta.** This is under heavy development. Expect rough edges, and expect settings and > behavior to change between 0.x [releases](https://github.com/awlevin/typesafe-computer-use/releases). > It drives your real mouse and keyboard, so start with a dry run. ## Why a classifier Frontier-model computer use is capable and expensive: every step ships a screenshot and waits several seconds for a plan. Most steps do not need a plan. They need one choice