agent-substrate/substrate

어떤 프로젝트인가요?

핵심 기능

• 01각 액터를 gVisor 또는 Cloud Hypervisor 마이크로VM 샌드박스에서 실행합니다.
• 02유휴 액터의 메모리와 파일 시스템을 스냅샷하고 요청에 따라 복원합니다.
• 03액터별 SPIFFE X.509 ID와 JWT를 발급합니다.
• 04이그레스 게이트웨이를 통해 자격 증명을 삽입해 샌드박스 코드가 자격 증명을 보유하지 않도록 합니다.
• 05기본적으로 네트워크를 차단하고 인그레스 트래픽을 atenet-router로 라우팅합니다.
• 06표준 Kubernetes에서 kubectl-ate CLI와 함께 실행됩니다.

활용 사례

• 세션 간에 파일 시스템 상태를 유지하는 상태 기반 코딩 에이전트를 대규모로 호스팅합니다.
• API 키를 노출하지 않고 LLM 에이전트의 신뢰할 수 없는 도구 실행을 처리합니다.
• 소수의 워커 파드를 대부분 유휴 상태인 다수의 MCP 서버나 에이전트에 할당해 초과 구독 방식으로 운영합니다.
• 하나의 Kubernetes 클러스터를 에이전트, 추론, 학습 워크로드가 함께 사용하도록 합니다.

빠른 시작

1. 1

   Go, kubectl, Docker를 설치합니다

2. 2

   kind 클러스터와 로컬 레지스트리를 만듭니다

   hack/create-kind-cluster.sh
3. 3

   Agent Substrate, PostgreSQL, rustfs를 설치한 다음 counter 데모를 설치합니다

   hack/install-ate-kind.sh --deploy-ate-system --credential-provider='{"name":"k8s.io"}'
4. 4

   counter actor를 만들고 router를 통해 HTTP 요청을 보냅니다

   kubectl ate create actor my-counter-1 -a ate-demo-counter --template counter

사용 전 알아둘 점

• !1.0 이전 버전으로, 하위 호환성이 보장되지 않습니다. API와 동작이 크게 변경될 수 있습니다.
• !Kubernetes 클러스터와 Go, kubectl, Docker가 필요합니다. 또한 약 1,000개가 넘는 sandbox를 실행하려면 Linux 호스트의 커널을 튜닝해야 합니다.
• !GKE 경로에는 Google Cloud 리소스와 IAM 설정이 필요합니다.
• !actor가 Secrets를 읽으려면 먼저 namespace 정책 권한을 수동으로 부여해야 합니다.

토픽

자주 묻는 질문

substrate은(는) 무엇인가요?

유휴 액터를 스냅샷해 소수의 워커로 다수의 AI 에이전트를 실행하는 Kubernetes 제로 트러스트 샌드박스 런타임 Agent Substrate는 표준 Kubernetes에서 신뢰할 수 없고 대부분 유휴 상태인 에이전트를 대규모로 실행하기 위한 런타임입니다. 각 액터는 자체 컴퓨팅, 네트워크, 스토리지를 갖춘 gVisor 또는 Cloud Hypervisor 마이크로VM 샌드박스에서 실행됩니다. 액터가 유휴 상태가 되면 메모리와 파일 시스템 상태를 메모리에서 스냅샷으로 저장하고, 요청이 들어오면 복원합니다. 이를 통해 다수의 액터가 소수의 웜 워커 파드를 함께 사용할 수 있습니다.

substrate은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

substrate은(는) Apache-2.0 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

substrate은(는) 아직 유지보수되고 있나요?

활발히 유지보수 중. substrate의 마지막 커밋은 2026년 10월 19일입니다.

substrate은(는) 어디에 사용할 수 있나요?

세션 간에 파일 시스템 상태를 유지하는 상태 기반 코딩 에이전트를 대규모로 호스팅합니다. API 키를 노출하지 않고 LLM 에이전트의 신뢰할 수 없는 도구 실행을 처리합니다. 소수의 워커 파드를 대부분 유휴 상태인 다수의 MCP 서버나 에이전트에 할당해 초과 구독 방식으로 운영합니다. 하나의 Kubernetes 클러스터를 에이전트, 추론, 학습 워크로드가 함께 사용하도록 합니다.

substrate는 어떻게 설치하나요?

Go, kubectl, Docker를 설치합니다 kind 클러스터와 로컬 레지스트리를 만듭니다: hack/create-kind-cluster.sh Agent Substrate, PostgreSQL, rustfs를 설치한 다음 counter 데모를 설치합니다: hack/install-ate-kind.sh --deploy-ate-system --credential-provider='{"name":"k8s.io"}' counter actor를 만들고 router를 통해 HTTP 요청을 보냅니다: kubectl ate create actor my-counter-1 -a ate-demo-counter --template counter

substrate은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/agent-substrate/substrate