생성/배포 시나리오

기본 추천

가장 무난한 시작점:

uv run llamon agent my-agent --template agent-general --yes
cd my-agent
uv run llamon run .

이 조합이면 아래가 바로 됩니다.

로컬 Docker 실행
llamon deploy 기반 SSH 원격 배포
prepare-offline 기반 오프라인 준비

생성 명령

uv run llamon agent my-agent --template agent-general --yes
uv run llamon flow my-flow --template flow-seq --yes

자주 쓰는 조합

1) 로컬 개발 중심

uv run llamon agent my-agent --template agent-general --yes
cd my-agent
uv run llamon run .

2) SSH 원격 배포까지 바로 사용

uv run llamon agent my-agent --template agent-general --yes
cd my-agent
uv run llamon deploy . --target ubuntu@<server>

3) 오프라인 배포까지 준비

uv run llamon agent my-agent --template agent-general --yes
cd my-agent
uv run llamon prepare-offline . --clean

4) 플로우 프로젝트로 시작

uv run llamon flow my-flow --template flow-seq --yes
cd my-flow
uv run llamon run .

프로파일 메모

기본 scaffold는 local-compose 자산을 포함하므로 llamon run, llamon deploy를 바로 사용할 수 있습니다.
GitLab 서버 배포 자산이 필요하면 --deploy-profile gitlab-server를 추가합니다.
Docker Compose 자산이 아예 필요 없으면 --no-docker를 사용합니다.

예:

uv run llamon agent my-agent \
  --template agent-general \
  --deploy-profile gitlab-server \
  --yes

어떤 조합을 고를까

로컬에서 바로 확인하려면: agent-general 또는 flow-seq + llamon run
서버에 바로 올리려면: 기본 scaffold + llamon deploy
폐쇄망 반입이 필요하면: 기본 scaffold + llamon prepare-offline --clean

SDK 패치 후 재배포

생성 후 SDK wheel을 교체했다면 아래 순서로 다시 맞추는 편이 안전합니다.

cd my-agent
./update_sdk_wheel.sh .
uv lock
uv run llamon prepare-offline . --clean
uv run llamon deploy . --target ubuntu@<server>

update_sdk_wheel.sh는 템플릿 프로젝트에 포함됩니다. ./update_sdk_wheel.sh . 는 새 llamon_agent-*.whl 파일이 현재 프로젝트 루트에 이미 있을 때 쓰는 형태입니다. wheel 파일이 다른 경로에 있으면 --wheel /path/to/<wheel>.whl 를 붙이세요.

여러 에이전트를 한 번에 갱신하려면 타겟 디렉토리를 나란히 넘깁니다 — ./update_sdk_wheel.sh . ../agent-b ../agent-c. wheel 갱신만 하고 uv lock / uv sync 는 건너뛰고 싶다면 --files-only 를 추가하세요.