You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Browse filesBrowse the repository at this point in the historyBrowse files
Joongheon Park
committed
docs: update README and issue templates for clarity and language support
- Translated README content to Korean, enhancing accessibility for Korean-speaking users.
- Updated key features and installation instructions in the README to reflect recent changes.
- Revised issue templates to specify "Act - AX Template" for clarity in feature requests and bug reports.
- Added additional context in issue templates to guide users in providing relevant information.
Act Operator is Proact0’s CLI for bootstrapping LangGraph-based “Act” blueprints with `cookiecutter`. The tool exposes `act new` to build an Act project and`act cast` to scaffold additional casts inside an existing blueprint.
3
+
Act Operator는 `cookiecutter`로 LangGraph 기반의 “Act - AX Template” 블루프린트를 신속히 부트스트랩하기 위한 Proact0의 CLI입니다. 이 도구는 Act 프로젝트를 생성하는`act new`와, 기존 블루프린트에 추가 캐스트를 스캐폴딩하는 `act cast` 명령을 제공합니다.
4
4
5
-
## Key Features
5
+
## 주요 기능
6
6
7
-
-Typer-powered CLI exposed as `act`
8
-
-`cookiecutter` rendering with slug/snake/title variants for Act and Cast names
9
-
-Safe directory checks to avoid overwriting non-empty folders
10
-
-Built-in command to add extra casts to an existing Act project
11
-
-Fully tested with `pytest`
7
+
-Typer로 구현된 CLI로 `act` 명령 제공
8
+
-Act/Cast 이름에 대해 slug/snake/title 변형을 지원하는 `cookiecutter` 렌더링
9
+
-비어 있지 않은 폴더를 덮어쓰지 않도록 하는 안전한 디렉터리 검사
10
+
-기존 Act 프로젝트에 추가 캐스트를 손쉽게 추가하는 내장 명령
11
+
-`pytest`로 충분히 검증된 테스트
12
12
13
-
## Installation
13
+
## 설치
14
14
15
15
```bash
16
16
uv add act-operator
17
17
```
18
18
19
-
Act Operator requires Python 3.12 or newer. The project ships with `pyproject.toml` so `uv` manages dependencies reproducibly.
19
+
Act Operator는 Python 3.12 이상을 요구합니다. 프로젝트에는 `pyproject.toml`이 포함되어 있어 `uv`가 의존성을 재현 가능하게 관리합니다.
20
20
21
-
## Usage
21
+
## 사용법
22
22
23
-
### Create a new Act project
23
+
### 새 Act 프로젝트 생성
24
24
25
25
```bash
26
26
uv run act new --path ./my-act --act-name "My Act" --cast-name "Main Cast"
27
27
```
28
28
29
-
You can omit any option to trigger interactive prompts. When `--path` points to a custom directory, the Act name defaults to that directory name.
29
+
어떤 옵션이든 생략하면 대화형 프롬프트가 표시됩니다. `--path`가 사용자 지정 디렉터리를 가리키는 경우, Act 이름은 기본적으로 해당 디렉터리 이름으로 설정됩니다.
30
30
31
-
### Add an additional cast
31
+
### 추가 캐스트 추가
32
32
33
33
```bash
34
34
uv run act cast --path ./my-act --cast-name "Sub Cast"
35
35
```
36
36
37
-
The command validates that `--path` is an Act project (presence of `pyproject.toml`, `langgraph.json`, `casts/base_node.py`, and `casts/base_graph.py`) before rendering the new cast.
37
+
새 캐스트를 렌더링하기 전에, 명령은 `--path`가 Act 프로젝트인지 검증합니다(`pyproject.toml`, `langgraph.json`, `casts/base_node.py`, `casts/base_graph.py`의 존재 확인).
38
38
39
-
### Resulting layout
39
+
### 생성 결과 구조
40
40
41
41
```
42
42
my-act/
@@ -60,7 +60,7 @@ my-act/
60
60
└── graph.py
61
61
```
62
62
63
-
## Development with uv
63
+
## uv로 개발하기
64
64
65
65
```bash
66
66
uv sync --dev
@@ -70,23 +70,23 @@ uv run act cast
70
70
uv build
71
71
```
72
72
73
-
-`uv sync --dev` installs runtime and test dependencies into a local virtualenv.
74
-
-`uv run pytest` executes the suite against the managed environment.
75
-
-`uv run act new ...` exercises the CLI exactly as users would experience it.
76
-
-`uv build` produces the wheel and sdist artifacts.
73
+
-`uv sync --dev`: 로컬 가상환경에 런타임/테스트 의존성 설치
74
+
-`uv run pytest`: 관리되는 환경에서 테스트 스위트 실행
75
+
-`uv run act new ...`: 실제 사용자 경험과 동일하게 CLI 동작 검증
76
+
-`uv build`: wheel과 sdist 아티팩트 생성
77
77
78
-
## Testing
78
+
## 테스트
79
79
80
80
```bash
81
81
uv run pytest
82
82
```
83
83
84
-
The suite ensures `act new` and `act cast` render the expected structure, validate directories, and surface clear error messages.
84
+
테스트 스위트는 `act new`와 `act cast`가 기대한 구조를 생성하는지, 디렉터리 검증이 정상 동작하는지, 오류 메시지가 명확한지를 보장합니다.
85
85
86
-
## Contributing
86
+
## 기여하기
87
87
88
-
-Read the guides: [CONTRIBUTING.md](CONTRIBUTING.md) (KR), [CONTRIBUTING_EN.md](CONTRIBUTING_EN.md) (EN)
Act Operator is Proact0’s CLI for bootstrapping LangGraph-based “Act - AX Template” blueprints with `cookiecutter`. The tool exposes `act new` to build an Act project and `act cast` to scaffold additional casts inside an existing blueprint.
4
+
5
+
## Key Features
6
+
7
+
- Typer-powered CLI exposed as `act`
8
+
-`cookiecutter` rendering with slug/snake/title variants for Act and Cast names
9
+
- Safe directory checks to avoid overwriting non-empty folders
10
+
- Built-in command to add extra casts to an existing Act project
11
+
- Fully tested with `pytest`
12
+
13
+
## Installation
14
+
15
+
```bash
16
+
uv add act-operator
17
+
```
18
+
19
+
Act Operator requires Python 3.12 or newer. The project ships with `pyproject.toml` so `uv` manages dependencies reproducibly.
20
+
21
+
## Usage
22
+
23
+
### Create a new Act project
24
+
25
+
```bash
26
+
uv run act new --path ./my-act --act-name "My Act" --cast-name "Main Cast"
27
+
```
28
+
29
+
You can omit any option to trigger interactive prompts. When `--path` points to a custom directory, the Act name defaults to that directory name.
30
+
31
+
### Add an additional cast
32
+
33
+
```bash
34
+
uv run act cast --path ./my-act --cast-name "Sub Cast"
35
+
```
36
+
37
+
The command validates that `--path` is an Act project (presence of `pyproject.toml`, `langgraph.json`, `casts/base_node.py`, and `casts/base_graph.py`) before rendering the new cast.
38
+
39
+
### Resulting layout
40
+
41
+
```
42
+
my-act/
43
+
├── pyproject.toml
44
+
├── README.md
45
+
├── langgraph.json
46
+
└── casts/
47
+
├── __init__.py
48
+
├── base_node.py
49
+
├── base_graph.py
50
+
└── main-cast/
51
+
├── modules/
52
+
│ ├── chains.py
53
+
│ ├── conditions.py
54
+
│ ├── models.py
55
+
│ ├── nodes.py
56
+
│ ├── prompts.py
57
+
│ ├── tools.py
58
+
│ └── utils.py
59
+
├── state.py
60
+
└── graph.py
61
+
```
62
+
63
+
## Development with uv
64
+
65
+
```bash
66
+
uv sync --dev
67
+
uv run pytest
68
+
uv run act new
69
+
uv run act cast
70
+
uv build
71
+
```
72
+
73
+
-`uv sync --dev` installs runtime and test dependencies into a local virtualenv.
74
+
-`uv run pytest` executes the suite against the managed environment.
75
+
-`uv run act new ...` exercises the CLI exactly as users would experience it.
76
+
-`uv build` produces the wheel and sdist artifacts.
77
+
78
+
## Testing
79
+
80
+
```bash
81
+
uv run pytest
82
+
```
83
+
84
+
The suite ensures `act new` and `act cast` render the expected structure, validate directories, and surface clear error messages.
85
+
86
+
## Contributing
87
+
88
+
- Read the guides: [CONTRIBUTING.md](CONTRIBUTING.md) (KR), [CONTRIBUTING_EN.md](CONTRIBUTING_EN.md) (EN)
0 commit comments