빠른 시작

로컬 스택에서 Station 을 만들고 리눅스 기기(virtual Device)를 띄운 뒤, 그 안에서 파이썬 한 줄을 실행해요. 필요한 것은 Docker 와 Node 22 이상이에요.

1. 로컬 스택 띄우기

endue-os 제품 레포에서:

local/up.sh          # 처음엔 에이전트 이미지 빌드까지 (수 분)

주소	무엇
http://127.0.0.1:8900	api-gateway — API 가 닿는 곳
http://127.0.0.1:5173	prototype-web 데스크톱 (같은 오리진에서 /api·/idp 를 넘겨 줘요)

2. 토큰 받기

로컬 스택에는 가짜 신원 공급자가 있어요. 아무 이름으로 토큰을 받아요. 운영에서는 endue 계정의 토큰이에요 (인증과 신원).

export OS=http://127.0.0.1:5173
export TOKEN=$(curl -s -X POST "$OS/idp/token?sub=alice&ttl=3600" | jq -r .access_token)

3. Station 만들기

export STN=$(curl -s -X POST $OS/api/v1/stations \
  -H "Authorization: Bearer $TOKEN" -H 'Content-Type: application/json' \
  -d '{"name":"lab"}' | jq -r .data.station_id)

Station 에는 OS 가 하나 함께 생겨요. 처음에는 running 이에요. project_id 를 주지 않았으니 가장 오래된 내 프로젝트에 들어가요 — 프로젝트가 없으면 “기본 프로젝트” 가 생겨요. 명령·컴퓨트가 쓰는 크레딧은 프로젝트가 아니라 내 계정의 지갑에서 나가요. 새 계정의 지갑에는 가입 크레딧이 들어 있어요.

4. 리눅스 기기 띄우기

export DEV=$(curl -s -X POST $OS/api/v1/stations/$STN/devices \
  -H "Authorization: Bearer $TOKEN" -H 'Content-Type: application/json' \
  -d '{"type":"virtual","kind":"linux","name":"box","size":"small"}' | jq -r .data.device.device_id)

type: virtual 이면 OS 가 VM·Storage·에이전트를 함께 만들고 Dock 1단 끝에 기기로 붙여요. 에이전트가 붙으면 compute_status 가 running 이 돼요.

curl -s $OS/api/v1/devices/$DEV -H "Authorization: Bearer $TOKEN" | jq '.data | {type, compute_status, online}'
# { "type": "virtual", "compute_status": "running", "online": true }

5. 그 안에서 실행하기

curl -s -X POST $OS/api/v1/devices/$DEV/commands \
  -H "Authorization: Bearer $TOKEN" -H 'Content-Type: application/json' \
  -d '{"command":"run_program","input":{"program":"python3","args":["-c","print(6*7)"]}}' \
  | jq '.data | {status, stdout: .output.stdout}'
# { "status": "succeeded", "stdout": "42\n" }

linux 에이전트는 셸 없이 허용된 프로그램(git·node·python3 …)만 격리 안에서 실행해요. 목록 밖이면 capability_denied 예요. 쓸 수 있는 도구는 GET /devices/{id}/tools 로 봐요.

6. 정리하기

curl -s -X POST $OS/api/v1/devices/$DEV/stop -H "Authorization: Bearer $TOKEN" > /dev/null
curl -s -X DELETE $OS/api/v1/devices/$DEV -H "Authorization: Bearer $TOKEN" -o /dev/null -w '%{http_code}\n'   # 204

기기를 지우면 VM·Storage·에이전트·Dock 항목·저장한 앱이 함께 없어져요. 되돌릴 수 없어요. 멈춰 두기만 하면 Storage 는 남고 컴퓨트 크레딧은 더 쓰지 않아요.

다음

• 같은 흐름을 코드로: 샘플 — AI 코딩 에이전트에 붙여 넣을 프롬프트도 함께 있어요.
• 화면으로: http://127.0.0.1:5173 에 같은 이름으로 로그인하면 방금 만든 Station 이 데스크톱으로 보여요.