Metadata-Version: 2.4
Name: bwai-workshop-tools
Version: 0.1.1
Summary: Build with AI Workshop 通用環境設定 CLI 工具
Author-email: Simon Liu <simonliu.ai.product@gmail.com>
License: Apache-2.0
Project-URL: Homepage, https://github.com/simonliu-ai-product/buildwithai-workshop-autosetup-tool
Project-URL: Bug Tracker, https://github.com/simonliu-ai-product/buildwithai-workshop-autosetup-tool/issues
Keywords: google-cloud,workshop,setup,cli,gemini
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Topic :: Software Development :: Build Tools
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Operating System :: OS Independent
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: click>=8.0
Requires-Dist: rich>=13.0
Dynamic: license-file

# bwai-workshop-tools

A universal CLI tool for Google Cloud workshop environment setup. Define steps in a JSON file and run them all at once.

**Available in:** [繁體中文](README_ZHTW.md) | [日本語](README_JP.md) | [한국어](README_KO.md)

---

## Installation

From PyPI:

```bash
pip install bwai-workshop-tools
```

From Source (for developers):

```bash
git clone https://github.com/simonliu-ai-product/buildwithai-workshop-autosetup-tool.git
cd buildwithai-workshop-autosetup-tool
pip install -e .
```

## Commands

### `bwai-workshop setup` — Run setup steps

```bash
# Run all steps (interactive confirmation for each)
bwai-workshop setup --step path/to/config.json

# Run specific steps only (comma-separated IDs)
bwai-workshop setup --step path/to/config.json --only auth,enable-apis

# Preview steps without executing
bwai-workshop setup --step path/to/config.json --dry-run
```

### `bwai-workshop verify` — Verify setup completion

```bash
# Verify all steps
bwai-workshop verify --step path/to/config.json

# Verify specific steps only
bwai-workshop verify --step path/to/config.json --only auth,check-billing-credit
```

### `bwai-workshop language` — Manage display language

```bash
# List supported languages
bwai-workshop language list

# Set language
bwai-workshop language set en      # English
bwai-workshop language set zh-tw   # Traditional Chinese
bwai-workshop language set ja      # Japanese
bwai-workshop language set ko      # Korean

# Show current language
bwai-workshop language show
```

### `bwai-workshop steps list` — List step types

```bash
bwai-workshop steps list
```

---

## Supported Step Types

| type | Description |
| :--- | :--- |
| `gemini_cli_vertex_auth` | Configure Gemini CLI with Vertex AI authentication (ADC) |
| `gcloud_auth` | Google Cloud login and project setup |
| `gcloud_enable_apis` | Enable specified Google Cloud APIs |
| `gcp_billing_credit` | Check if GCP project has Workshop promotional credit |
| `python_venv` | Create Python virtual environment and install dependencies |
| `shell` | Execute custom shell command |

---

## Step File Format

```json
{
  "name": "My Setup Flow",
  "description": "Description text",
  "steps": [
    {
      "id": "my-step",
      "type": "shell",
      "description": "Run a custom command",
      "params": {
        "command": "echo hello"
      }
    }
  ]
}
```

## Examples

See the `examples/` folder for complete examples:

- `adk-gemini-agent.json` — Full setup flow for ADK Gemini Agent Workshop
