physicalai-runtime-working-with-config
Works with physicalai.config (Config recipes, export_config, jsonargparse, YAML). Use when editing src/physicalai/config, class_path YAML, runtime or policy construction, or docs under docs/how-to/config and docs/explanation/configuration.md. Runtime owns this module; Studio imports it from physicalai.
소스 정보
- 저장소
- openvinotoolkit/physicalai
- 최근 소스 활동
- 2026년 8월 20일 04:16
- 감지된 SKILL.md 언어
- 영어
- 스타
- 27
- 포크
- 22
설치 방법
기본적으로 소스를 먼저 확인하는 Prompt가 선택됩니다. 직접 명령으로 전환하거나 로컬 사본을 다운로드할 수도 있습니다.
소스 파일 검토
설치 여부를 결정하기 전에 SKILL.md와 SkillsMP에 표시된 보조 파일을 읽어 보세요.
SKILL.md 표시 중
SKILL.md
소스 지침 · 읽기 전용 미리보기- name
- physicalai-runtime-working-with-config
- description
- Works with physicalai.config (Config recipes, export_config, jsonargparse, YAML). Use when editing src/physicalai/config, class_path YAML, runtime or policy construction, or docs under docs/how-to/config and docs/explanation/configuration.md. Runtime owns this module; Studio imports it from physicalai.
- license
- Apache-2.0
# Working with `physicalai.config`
Runtime owns `src/physicalai/config/`. Physical AI Studio should import this
package from `physicalai`, not copy it under `library/`.
## Workflow
1. **Pick the API**
- Portable YAML recipes (robots, cameras, exported components): `Config` and
`@export_config`.
- Known Python types (trainers, dataclass configs, CLI models): jsonargparse
(`ArgumentParser`, `add_class_arguments`, `parse_object`, `instantiate`).
2. **Author a recipe** — `class_path` + `init_args`; nest recipes only for
trusted local config. See `docs/how-to/config/instantiate-components.md`.
- Done when: dict/YAML passes validation without `ConfigError`.
3. **Export live objects** — `@export_config`, then `Config.from_instance(obj)`
and `Config.save()`. Only trusted local sources.
- Done when: saved YAML reloads with `instantiate()` in tests.
4. **Typed construction** — use jsonargparse in the owning package (runtime CLI,
inference, and so on). Avoid new generic loaders under `physicalai.config`.
5. **Document and test** — update `docs/explanation/configuration.md` or
`docs/how-to/config/`; extend `tests/unit/config/`.
## Validation loop
```bash
uv run pytest tests/unit/config/ -q
prek run ruff-check --all-files
```
## Required checks
- Deeply nested config hits `_MAX_CONFIG_DEPTH` and raises `ConfigError`.
- `class_path` comes only from trusted local config (`docs/development/security.md`).
- Studio imports `Config` from runtime, not a duplicate tree in the library.
## References
- `docs/explanation/configuration.md`
- `docs/how-to/config/instantiate-components.md`
- `tests/unit/config/`
GitHub에서 보기