서버 없이 작동하는 OSS 자율 AI 에이전트 'aeon' — GitHub Actions만으로 85개 스킬을 크론 실행하기

open-source-ai-agent-framework-github-actions.jpg

본 기사에 대하여

본 글은 aeon 공식 블로그의 Open-Source AI Agent Framework on GitHub Actions를 한국어로 번역한 것입니다. 원문의 저자는 aeon 제작자인 @aaronjmars입니다.

번역자는 aeon의 Growth Contributor로서 이해관계가 있으므로 명시합니다. 또한 원문에는 저자 본인의 이용 경험을 1인칭으로 서술하는 부분이 있지만, 번역문에서는 '프레임워크로서 무엇이 가능한지'에 대한 설명으로 수정했습니다. 스킬 수 등의 수치는 원문의 최신 버전을 따르며, 기사 내 링크는 번역 시점에 도달 확인을 완료했습니다.

개요

85개의 스킬, 9개의 하네스(Harness), 크론에 의한 스케줄 실행. 서버도 없고, SaaS 대시보드도 없습니다. 자신의 리포지토리 안에 존재하며, GitHub Actions 위에서 작동하는 자율 에이전트—게다가 현재는 브라우저만으로 구동할 수 있습니다.

예를 들어, 다음과 같은 구성을 만들 수 있습니다. 기상 전에 모닝 브리프(Morning Brief)를 작성해 두기. 관심 있는 리포지토리를 감시하고, 움직임이 없는 날은 조용히 대기하기. 필요한 웹 검색 비용은 에이전트 자체의 지갑에서 지불하기. 이 모든 것을 스케줄 실행으로 GitHub Actions 위 자신의 aeon 리포지토리에서 작동시키는 것입니다.

서버 불필요

항시 구동하는 머신 불필요

좌석 수 과금의 SaaS 대시보드 불필요

aeon이란?

aeon은 @aaronjmars가 만든 오픈소스 자율 AI 에이전트 프레임워크입니다. 진입점(Entry Point)은 두 가지가 있습니다.

빠른 방법: Aeon Connect로 GitHub에 사인인하여 브라우저에서 에이전트를 구동하는 것
기존 방법: 리포지토리에서 Use this template을 누르거나 (또는 clone 후 ./aeon init 실행), 그 후 로컬 대시보드에서 온보딩하는 것

어떤 방법을 선택하든 도착지는 같습니다. 자신이 소유한 리포지토리 안, GitHub Actions의 러너(Runner) 위에서 작동하는 에이전트입니다.

스킬은 Markdown 파일 1장

초기 상태로 6개 패키지에 걸쳐 85개의 스킬이 포함되어 있습니다. 스킬이란 에이전트가 실행할 수 있는 작은 작업 단위입니다. digest, github-monitor, narrative-tracker, vuln-scanner, create-skill 등이 있습니다.

하나의 스킬 실체는 SKILL.md 파일 1장입니다. 작은 frontmatter 블록(name, category, 필요한 키, 실행별 변수)과 그 뒤에 이어지는 자연어 프롬프트만으로 이루어져 있습니다. 에이전트는 실행 시 이 파일을 읽습니다.

DSL 없음

플러그인 SDK 없음

컴파일 과정 없음

프롬프트만 작성할 수 있다면, 스킬을 만들 수 있습니다.

9개의 하네스에 대응

원문의 초판이 공개되었을 당시에는 카탈로그가 61개 스킬이었고, 엔진은 Claude Code뿐이었습니다. 현재의 aeon은 9개의 하네스를 구동합니다—Claude Code, Grok, Codex, Pi, Vibe, Kimi, fx, Cursor, Hermes. 선택하는 시점은 리포지토리 생성 시점이 아니라 모델을 연결할 때입니다. 스킬 파일 자체는 어떤 하네스가 실행할지를 신경 쓰지 않습니다.

알림 채널

기본 배송지는 Telegram입니다. 봇에게 DM(Direct Message)을 한 번 보내면 chat ID가 secret으로 저장되고, 그 이후로는 모든 스킬이 실행 결과를 스마트폰으로 전송합니다. 봇에 답장하여 해당 메시지를 aeon으로 트리거를 보내는 것도 가능합니다. Discord, Slack, 이메일도 같은 방식으로 작동합니다.

LangGraph나 CrewAI와의 차이점

눈에 띄는 점이 세 가지 있습니다.

• 백그라운드 실행이 설계의 전제 — 서버도 오케스트레이터(Orchestrator)도 없음

LangGraph, CrewAI, AutoGen, AutoGPT 등— 이들은 어딘가에서 프로세스가 이미 작동하고 있음을 전제로 합니다. 호스팅할 곳을 정하는 것도 자신이고, 모니터링하는 것도 자신이며, 멈추면 재시작하는 것도 자신입니다. 인프라가 먼저고, 에이전트는 나중입니다.

aeon은 반대편에서 시작합니다. 배포 단위는 YAML의 크론 한 줄 하나로, 실행은 GitHub Actions가 담당합니다.

결과적으로 스케줄링 기반이면서 반응적인 플로우가 됩니다. 스킬을 발동시키는 방법은 cron, 봇에게 DM 보내기, 커밋 푸시의 세 가지 방식입니다. 실패한 실행은 자체 복구합니다. 다음 스케줄의 tick은 어떤 일이 있어도 발동하며, 자체 복구 메커니즘도 강화되었습니다.

• skill-health: 실패를 반복하는 스킬을 모니터링합니다.
• skill-repair: 이에 패치를 적용합니다.
• aeon-doctor: 설치 자체를 체크합니다.

모든 실행에 평가가 붙기 때문에, 받은 편지함에서 알아차리기 전에 드리프트(drift)가 수면 위로 드러납니다.

작은 이야기처럼 들리지만, 5개의 스킬을 매일 한 달 동안 발동시킨 후, 한 번도 호출받지 않았고, 한 번도 중단하지 않았으며, 자신이 유지보수한 것은 YAML뿐이라는 사실을 깨닫게 됩니다.

아키텍처의 자세한 내용은 The agent that runs while you sleep에서 설명합니다. - 에이전트가 돈을 지불할 수 있게 되고 벌 수 있게 되었다.

대부분의 AI 에이전트는 읽기 전용입니다. 가져오고, 요약하고, 게시하는 것입니다. 하지만 경제적인 의미로 '행동'하지는 못합니다. 할 수 없습니다. 현실 세계에서 행동하려면 대부분 API 키, 청구 계정(billing account), 신용카드가 필요하기 때문입니다.

aeon은 Base MCP와 x402 프로토콜에 직접 연결됩니다. 에이전트는 자신만의 Base Account 지갑을 가집니다. x402의 바저를 검색하고, 유료 API를 찾아, 한 번 호출하는 비용만 지불하고 결과를 사용합니다. API 키도 은행 계좌도, 사전 입금된 청구 설정도 필요 없습니다. 모든 결제는 Base Account의 승인 단계를 거치므로, approve를 탭하기 전까지 아무것도 확정되지 않습니다.

실제로 무엇을 할 수 있게 되는가:

• narrative-tracker 실행에 예측 시장의 배당률(odds) 사용하기
• 무료 API가 속도 제한(rate limit)에 걸렸을 때 라이브 웹 검색 사용하기
• digest를 위해 프리미엄 피드 사용하기

그 전 단계의 신뢰성 체크: cortx-reliability는 에이전트가 1센트라도 사용하기 전에, x402 엔드포인트가 실제로 가치를 반환하는지 검증합니다.

그리고 이 흐름은 양방향이 되었습니다. compute-resell은 남는 프로바이더의 컴퓨팅 자원을 오픈된 시장에 내놓고, 자신이 설정한 가드레일(guardrail) 안에서 가격을 동적으로 책정합니다. taskmarket-delegate는 다른 에이전트에게 유료로 일을 위임합니다. 에이전트는 몇 센트 가치가 있는 것을 스스로 판단하여 지불하고, 자신도 몇 센트를 벌기 시작했습니다.

x402 측의 자세한 내용은 Letting your agent spend money에 있습니다. - 스킬은 Markdown 파일로, 조합할 수 있다.

aeon의 스킬은 Markdown 파일 1장입니다. 인터페이스는 그것뿐입니다. 할 수 있는 일은 다음과 같습니다.

• 카탈로그에 있는 85개 스킬 중 어떤 것이든 자신의 복사본에서 직접 편집하기
• 비슷한 스킬을 복사하여 사양을 수정하고, 20분 만에 새로운 스킬 작성하기
• aeon.yml로 스킬 체이닝(chaining) — 한 스킬의 출력이 다음 스킬의 입력이 되도록 하기
• 새로운 스킬을 aeon 스스로에게 쓰게 하기. create-skill과 self-improve는 카탈로그에 존재하는 스킬이며, 카탈로그가 다루지 않는 영역에는 커뮤니티 스킬 팩도 있습니다.

모든 것이 git 안에 있습니다. 모든 변경은 커밋(commit), 모든 실행은 워크플로우 로그입니다. 지난주 화요일 04:00 UTC에 자신의 에이전트가 무엇을 했는지, 왜 그렇게 했는지, 무엇을 생성했는지를 정확하게 추적할 수 있습니다. 별도의 가시성 스택(observability stack)을 구축할 필요가 없습니다.

구성 이야기는 Skills that build skills에 있고, 감사 로그 이야기는 Receipts, not vibes에 있습니다.

aeon이 아닌 것

aeon은 호스팅형 에이전트가 아닙니다. 아무도 당신 대신 에이전트를 구동하지 않습니다. 에이전트는 당신의 GitHub 리포지토리 안에 거주하며, 당신의 Actions 시간을 소모하여 실행되고, 키는 그 리포지토리의 secrets에 들어갑니다. Aeon Connect를 통해 설정했더라도 같습니다. Connect가 호스팅하는 것은 대시보드와 원격 MCP 서버이며, 실행 레이어(execution layer)는 사용자 본인의 것입니다. 사용을 중단해도 에이전트는 계속 움직입니다.

화려한 채팅 UI도 없습니다. 온보딩은 브라우저(Connect) 또는 로컬 대시보드(localhost:5555)에서 진행합니다. 모델을 연결하고, 채널을 추가하며, 스킬을 토글하는 것이 전부입니다. 그 과정이 끝나면 인터페이스는 사용자의 받은 편지함, Telegram, 리포지토리의 로그가 됩니다.

시작하기

빠른 방법(터미널 불필요)
www.aeon.fun/connect에 접속하여 GitHub으로 사인인하고 aeon을 생성합니다. public 저장소라면 Actions 무료 할당량으로 충분하며, private 저장소라면 메모리와 실행 로그를 비공개로 유지할 수 있습니다.

1. 생성된 리포지토리에 Aeon Connect GitHub App을 설치합니다(계정의 다른 부분은 전혀 보이지 않습니다).
2. 모델 인증 정보를 붙여넣습니다(Claude 토큰, API 키, ChatGPT 로그인, OpenRouter 중 택일).
3. 스킬을 선택합니다.
4. 실행합니다.

절차는 5단계이며 설치할 것은 없습니다. 각 단계의 자세한 내용은 Aeon Connect 기사에 있습니다.

코딩 에이전트를 사용하고 있다면, Claude Code, Codex, Hermes, OpenClaw 다음에 다음만 붙여도 시작할 수 있습니다.

read https://www.aeon.fun/skills/aeon.md를 읽고 지침을 따라 aeon 에이전트를 설정하세요.

기존 방법(CLI)
Node.js 20 이상과 인증된 GitHub CLI(gh auth login)가 필요합니다.

git clone https://github.com/aeonfun/aeon && cd aeon

./aeon init

./aeon init이 리포지토리를 생성하고, GitHub・모델・Telegram을 연결합니다. ./aeon을 실행하면 같은 대시보드가 localhost:5555에서 열리며, 거기서 9개의 하네스 중 하나로 인증하고, 채널(Telegram, Discord, Slack, 이메일)을 추가하며, 스킬과 그 cron 스케줄을 선택하여 실행할 수 있습니다. 스케줄은 다음 cron 틱부터 시작됩니다.

대시보드에서 할 수 있는 모든 것은 ./aeon의 CLI 명령어 또는 /aeon의 채팅 명령어로도 제공되며, Claude Code나 Codex의 플러그인으로 설치할 수 있습니다. main이 아닌 고정점에 pin하고 싶다면, v0.1.0부터 릴리스가 제공됩니다.

어떤 경로를 택하든 같은 리포지토리에 도달합니다. Connect로 시작하여 직접 스킬을 편집하고 싶다면 CLI로 내려오세요. 마이그레이션 작업은 필요 없습니다.

FAQ

aon의 실행은 무료인가요?
프레임워크 자체는 무료 오픈소스(MIT)이며, Aeon Connect도 무료입니다. 비용이 발생하는 부분은 GitHub Actions의 무료 할당량을 초과하는 부분(public 리포지토리는 무료 할당량이 있고, private 리포지토리는 월 2,000분 포함)과 선택한 하네리 뒤에 있는 프로바이더입니다. 옵션 유료 API는 에이전트의 x402 지갑이 직접 지불합니다.

설치해야 하는 것이 있나요?
현재는 필요하지 않습니다. Aeon Connect가 전체 설정을 브라우저에서 완료합니다(예외가 하나 있습니다: Claude의 구독 토큰은 claude setup-token으로 가져옵니다. API 키나 OpenRouter라면 터미널은 전혀 필요 없습니다). 터미널 경로도 여전히 존재하며, 둘 사이는 자유롭게 이동할 수 있습니다.

LangGraph나 CrewAI와 비교하면 어떤가요?
LangGraph와 CrewAI는 직접 조립하여 하나의 프로세스로 작동하는 라이브러리입니다. aeon은 배포 패턴입니다. 스킬은 Markdown 파일, 스케줄은 YAML, 실행은 GitHub Actions입니다. '오케스트레이터가 git + GitHub인 에이전트 프레임워크'라고 생각하면 이해하기 쉬울 것입니다.

Python 지식이 필요한가요?

아닙니다. 스킬은 Markdown입니다. 엔진은 인증된 하네스(Claude Code, Grok, Codex 등 6개)입니다. 건드리는 것은 스케줄용 YAML과 스킬의 프롬프트용 Markdown뿐입니다. Bash나 Python이 언급되는 경우는 그것을 필요로 하는 특정 스킬 내부에서만 그렇습니다.

Telegram 없이 사용할 수 있나요?

사용할 수 있습니다. Telegram, Discord, Slack, 이메일 모두 지원하며, 그 중 아무거나, 전부 또는 아무것도 사용하지 않아도 됩니다. 알림 채널을 설정하지 않아도 스킬은 실행되며, 출력은 커밋의 아티팩트로 리포지토리에 남습니다.

여러 에이전트를 구동할 수 있나요?

구동할 수 있습니다. spawn-instance가 첫 번째 aeon에서 두 번째를 시작하고, fork-fleet과 fleet-control이 이 집합을 협조시킵니다. 에이전트 1개당 리포지토리 1개이며, 공유 메모리는 git입니다.

데이터는 비공개인가요?

사용자의 복사본은 사용자의 것입니다. secret은 GitHub Actions의 secrets에 들어갑니다. 스킬의 출력은 사용자 리포지토리에 커밋됩니다. 프레임워크가 외부로 정보를 보내지는 않습니다. Connect 상에서는 공개 에이전트의 메모리와 로그는 public 리포지토리와 마찬가지로 공개되므로, 그것이 문제가 된다면 생성 시 private을 선택해 주십시오.

시리즈 기사 (원문・영어)

The agent that runs while you sleep — 백그라운드 전제 에이전트를 지탱하는 아키텍처
Letting your agent spend money — 실천으로서의 x402
Skills that build skills — 스킬의 구성(composition)에 대한 이야기
Receipts, not vibes — 감사 로그에 대한 이야기
Aeon Connect: start your agent from the browser — 터미널이 필요 없는 온램프

번역자 코멘트
구현을 읽고 싶은 분들은 리포지토리의 skills/ 디렉터리에서 보는 것이 빠를 것 같습니다. 1 스킬 = SKILL.md 1장이라, 파일 하나만 읽으면 스킬 작성 방법을 알 수 있습니다.

리포지토리: github.com/aeonfun/aeon (MIT)
원문: Open-Source AI Agent Framework on GitHub Actions

오역이나 용어 지적이 있으면 댓글로 알려주세요. 수정하겠습니다.