에이전트오브젝트슈퍼바이저선언된 경로 위의 메시지

에이전트 하나는 모델, 프롬프트, 도구로 이뤄집니다.

모델: 다음 단계를 결정
프롬프트: 할 일을 지시
도구: 작업을 수행

에이전트 12개가 서로 하나하나 직접 연결되어 있습니다.

누가 누구와 대화하나: 에이전트마다 코드에 직접 작성
각자 어디서 실행되나: 시작한 곳 어디서든
하나가 실패하면: 재시작되지 않음

시작: 에이전트마다 별도 프로세스로
격리: 각자 전용 샌드박스 안에
라우팅: 메시지는 선언된 경로로만
재시작: 실패한 에이전트를 슈퍼바이저가

이벤트 (예시)

에이전트 10: 크래시됨
에이전트 10: 슈퍼바이저가 재시작
나머지 11개: 실행 중

이벤트 (예시)

message_routedtelegram → triage

message_routedtriage → research

invalid_routeresearch → telegram폐기됨

message_routedresearch → answer

오브젝트는 그래프 위의 일반 코드입니다. answer와 research의 모델 호출은 budget을 거칩니다.

에이전트: triage, research, answer: 모델 사용
오브젝트: telegram, cron, browser, budget: 일반 코드

패키지 · swarmidx (예시)

genlayerlabs/genswarms-telegram@0.6.6sha256:9f2c…검증됨

genlayerlabs/cron@0.2.8sha256:4be1…검증됨

genlayerlabs/browser@0.2.4sha256:51d3…검증됨

genlayerlabs/genswarms-llm-proxy@0.4.2sha256:c07a…검증됨

거부된 변경은 기록되지 않습니다. 멈춘 스웜은 자체 데이터베이스에서 복원됩니다. 시드부터 시작해 기록된 변경을 순서대로 적용합니다.

복원: 시드, 이어서 변경 1, 2, 3

통합 이벤트 스트림 (예시)

supportmessage_routedtriage → answer

observermessage_routedwatch → report

trading simrestart에이전트 3

codingoutput에이전트 2

AI 에이전트를 위한 운영체제.

AI 에이전트 수천 개를 조직 전체에 배포하고, 조율하고, 제어하세요.

문서 보기 GitHub에서 보기

라이선스: 오픈소스, MIT
버전: 0.2.0
런타임: Elixir / OTP

모델과 프롬프트만으로는 부족합니다.

에이전트 하나라면 간단합니다. 하지만 여러 에이전트가 함께 일하려면 실행할 곳, 누가 누구와 대화할지 정하는 규칙, 하나가 실패했을 때 복구할 방법이 필요합니다.

에이전트 하나는 모델, 프롬프트, 도구로 이뤄집니다.

모델: 다음 단계를 결정
프롬프트: 할 일을 지시
도구: 작업을 수행

에이전트 12개가 서로 하나하나 직접 연결되어 있습니다.

누가 누구와 대화하나: 에이전트마다 코드에 직접 작성
각자 어디서 실행되나: 시작한 곳 어디서든
하나가 실패하면: 재시작되지 않음

운영체제라고 생각해 보세요.

운영체제는 직접 만들지 않은 프로그램을 실행합니다. GenSwarms가 에이전트에게 하는 일이 바로 이것입니다. 에이전트를 시작하고, 격리하고, 메시지를 라우팅하고, 실패하면 재시작합니다.

시작: 에이전트마다 별도 프로세스로
격리: 각자 전용 샌드박스 안에
라우팅: 메시지는 선언된 경로로만
재시작: 실패한 에이전트를 슈퍼바이저가

모든 에이전트는 프로세스입니다.

각 에이전트는 전용 샌드박스 안에서, 전용 슈퍼바이저의 관리를 받으며 실행됩니다. 하나가 크래시되면 그 에이전트는 재시작되고, 나머지는 계속 일합니다. 역할, 모델, 실행 위치는 각각 따로 정합니다.

이벤트 (예시)

에이전트 10: 크래시됨
에이전트 10: 슈퍼바이저가 재시작
나머지 11개: 실행 중

에이전트는 선언된 경로로만 대화합니다.

그래프는 직접 그립니다. 모든 메시지는 이 그래프를 기준으로 검사되고, 벗어난 메시지는 폐기됩니다.

여기서부터 그림은 스웜 하나를 따라갑니다. Telegram에서 고객 문의에 답하는 지원팀입니다.

이벤트 (예시)

message_routedtelegram → triage

message_routedtriage → research

invalid_routeresearch → telegram폐기됨

message_routedresearch → answer

모든 일에 모델이 필요한 건 아닙니다.

오브젝트는 같은 그래프 위의 일반 코드입니다. Telegram 게이트웨이, 스케줄러, 모델 비용 예산이 그 예입니다. 매번 똑같이 동작합니다.

오브젝트는 그래프 위의 일반 코드입니다. answer와 research의 모델 호출은 budget을 거칩니다.

에이전트: triage, research, answer: 모델 사용
오브젝트: telegram, cron, browser, budget: 일반 코드

에이전트에게 필요한 건 설치해서 쓰세요.

Telegram, WhatsApp, 이메일 커넥터, 브라우저, 스케줄러. 모두 swarmidx 인덱스의 서명된 패키지이며, 로드되기 전에 검증됩니다.

패키지 · swarmidx (예시)

genlayerlabs/genswarms-telegram@0.6.6sha256:9f2c…검증됨

genlayerlabs/cron@0.2.8sha256:4be1…검증됨

genlayerlabs/browser@0.2.4sha256:51d3…검증됨

genlayerlabs/genswarms-llm-proxy@0.4.2sha256:c07a…검증됨

스웜은 문서입니다.

스웜의 정의는 데이터이고, 모든 변경은 기록됩니다. 잘못된 변경은 실행되기 전에 거부되고, 멈춘 스웜은 자체 데이터베이스에서 복원됩니다.

거부된 변경은 기록되지 않습니다. 멈춘 스웜은 자체 데이터베이스에서 복원됩니다. 시드부터 시작해 기록된 변경을 순서대로 적용합니다.

복원: 시드, 이어서 변경 1, 2, 3

조직의 모든 에이전트를, 하나의 제어 계층에서.

모든 메시지, 크래시, 재시작을 실시간으로 확인하세요. API나 CLI로 제어하거나, 코딩 에이전트에게 맡기세요.

지능은 모델이. 일은 에이전트가. 조직 운영은 GenSwarms가.

통합 이벤트 스트림 (예시)

supportmessage_routedtriage → answer

observermessage_routedwatch → report

trading simrestart에이전트 3

codingoutput에이전트 2

작동 방식.

운영체제의 구성 요소별로, GenSwarms에서는 무엇이 그 역할을 하는지.

프로세스: 에이전트마다 슈퍼바이저가 관리하는 OTP 프로세스. 역할, 모델, 백엔드는 따로 설정.
격리: 에이전트별 bwrap, Docker 또는 Apple container.
네트워크: 격리된 에이전트는 자기 모델 엔드포인트에만 접근.
메시지: 선언된 경로로만, 홉마다 검사.
서비스: 오브젝트: 같은 그래프 위의 결정적 코드.
드라이버: Local, Tmux, Docker, Apple container, SSH, Bwrap, Mock.
패키지: gsp와 swarmidx: 서명, 콘텐츠 주소 지정, 로컬 머신에서 검증.
상태: 시드와 변경 로그. 잘못된 변경은 거부. 데이터베이스에서 복원.
제어: REST, WebSocket, CLI, 코딩 에이전트용 스킬 파일.
이벤트: 모든 메시지, 크래시, 재시작을 실시간으로.

LangGraph, CrewAI, AutoGen과 무엇이 다른가요?

프레임워크는 사용자 코드 안에서 에이전트를 구성합니다. GenSwarms는 각 에이전트를 슈퍼바이저가 관리하는 별도 프로세스로 실행합니다.

GenSwarms와 LangGraph, CrewAI, AutoGen 비교
질문	genswarms	LangGraph	CrewAI	AutoGen
무엇인가	각 에이전트를 슈퍼바이저가 관리하는 프로세스로 실행하는 런타임	상태를 가진 에이전트를 위한 오케스트레이션 프레임워크이자 런타임. LangSmith Deployment에서 호스팅	에이전트 크루와 플로우를 위한 오픈소스 프레임워크. AMP로 배포	멀티 에이전트 프레임워크, 현재 유지보수 모드. 후속은 Microsoft Agent Framework
실행 위치	각자 슈퍼바이저가 관리하는 별도 프로세스에서: 로컬, 샌드박스, 컨테이너 또는 SSH	사용자의 Python 또는 JS 프로세스 안, 혹은 LangSmith Deployment 서버	사용자의 Python 프로세스 안, 혹은 CrewAI AMP 관리형 인프라	사용자의 프로세스 안, 혹은 실험 단계인 분산 런타임으로 여러 워커에 걸쳐
크래시의 영향 범위	크래시가 난 그 에이전트. 슈퍼바이저가 재시작	해당 실행(run). 체크포인트로 재개할 수 있고, 노드는 재시도 가능	해당 실행(run). 에이전트는 오류 시 재시도하고, 플로우는 상태를 저장해 재개 가능	사용자 코드가 처리. 팀 상태는 저장했다가 다시 불러오기 가능

각 프로젝트의 공식 문서 기준, 2026년 9월.

보장하는 것, 아직 보장하지 않는 것.

현재 0.2.0에 포함된 것과 알려진 한계.

보장하는 것

크래시가 나면 스웜이 아니라 에이전트 하나만 재시작.
메시지는 선언된 경로로만 이동.
잘못된 설정과 변경은 실행 전에 거부.
패키지는 서명된 로그를 기준으로 검증.

아직 보장하지 않는 것

운영자 토큰은 하나뿐, 사용자별 역할은 없음.
최소 한 번 전달, 정확히 한 번은 아님.
비용 예산은 코어가 아닌 패키지로 제공.
패키지를 업데이트하면 에이전트가 재시작됨. 실행 중 교체는 아직 없음.
스웜당 에이전트 기본 100개 (설정 가능).

팀 하나로 시작하세요. 에이전트 수천 개까지 확장하세요.

현재 채팅 어시스턴트, 코딩 에이전트, 트레이딩 시뮬레이션, 다른 스웜을 모니터링하는 스웜에 쓰이고 있습니다.

문서 보기 GitHub에서 보기

또는 에이전트에게 이렇게 요청하세요:

다음 문서를 읽고 스웜을 설정해 주세요: https://genswarms.com/skill.md