Metadata-Version: 2.4
Name: fwauto
Version: 0.9.1
Summary: FWAuto - AI-powered firmware automation tool. Your firmware copilot.
Project-URL: Homepage, https://www.fwauto.ai
Author-email: Kent Chiu <kent.cwg@gmail.com>
Maintainer-email: Kent Chiu <kent.cwg@gmail.com>
License: MIT
License-File: LICENSE.TXT
Keywords: ai,embedded,firmware,stm32
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Software Development :: Build Tools
Classifier: Topic :: Software Development :: Embedded Systems
Requires-Python: <3.14,>=3.12
Requires-Dist: claude-agent-sdk
Requires-Dist: jinja2>=3.0.0
Requires-Dist: langchain-anthropic>=1.0.0a1
Requires-Dist: langchain>=1.0.0a5
Requires-Dist: langgraph>=1.0.0a3
Requires-Dist: langsmith>=0.1.0
Requires-Dist: prompt-toolkit>=3.0.0
Requires-Dist: pyserial>=3.5
Requires-Dist: requests>=2.28.0
Requires-Dist: tomli-w>=1.0.0
Requires-Dist: tomli>=2.0.1; python_version < '3.11'
Requires-Dist: typer>=0.12.0
Provides-Extra: dev
Requires-Dist: pyright>=1.1.391; extra == 'dev'
Requires-Dist: pytest>=7.0.0; extra == 'dev'
Requires-Dist: ruff>=0.8.4; extra == 'dev'
Description-Content-Type: text/markdown

# FWAuto

> **新用戶？** 請參考 [Quickstart Guide](docs/quickstart.md) 快速上手。

## Installation

### Install as Global Tool (Recommended)

使用 `uv tool install` 安裝，讓 fwauto 在任意目錄都可執行：

```bash
cd /path/to/fwauto
uv tool install --force --prerelease=allow --editable .
```

> [!NOTE] 安裝前記得先 `git pull` 確保程式是最新版的

安裝後，可在任意目錄執行：

```bash
cd /path/to/your/stm32-project/examples/實例 xxx
fwauto build        # 從當前目錄 .fwauto/
fwauto run          # Build + Deploy
fwauto init         # 初始化專案
```

解除安裝：

```bash
uv tool uninstall fwauto
```

### Development Mode

如果不想全域安裝，在開發目錄使用 `uv run`：

```bash
cd /path/to/fwauto
uv run fwauto build
uv run fwauto deploy
uv run fwauto run
uv run fwauto log "有任何 error 嗎?"
```

### Dual Version Install

同時安裝 Claude SDK 版本(`fwauto`) 和 Non Claude Code SDK (`fwauto2`)：

```bash
./dual.sh
```

安裝結果：

| 指令      | Branch              | 說明                         |
| --------- | ------------------- | ---------------------------- |
| `fwauto`  | main                | Claude SDK                   |
| `fwauto2` | fwauto-agent-sdk-v2 | 無 Claude Claude SDK(小煌版) |

此 script 使用 git worktree 維護兩個獨立源碼目錄，以 editable 模式安裝。重新執行即可更新。

安裝完成後會有兩個全域的指令 `fwauto` , `fwauto2` 依需要使用即可, 目前 Github 上面處理的 Issues 會以 fwauto 版為準
