Forkybot AI: 최적화 및 보안 강화된 Bytebot

이것은 가상 데스크톱을 제어하여 복잡한 작업을 자동화하는 오픈소스 AI 에이전트인 Bytebot의 최적화 및 보안 강화 포크입니다.

원본 프로젝트는 아카이브되어 유지보수가 중단되었습니다. 이 포크는 아이디어를 구출하고, 현대화하며, 프로덕션 환경에 대비시켰으며, 소프트웨어 엔지니어링, 보안 및 문서화 모범 사례를 적용했습니다.

🎯 이 프로젝트는 무엇을 하나요?

자신만의 컴퓨터를 가진 가상 직원을 상상해 보세요. *"내 세 개의 공급업체 포털에서 이번 달 청구서를 다운로드하여 폴더에 정리해 줘"*와 같은 자연어 지시를 내리면, 에이전트가 브라우저를 열고 포털을 탐색하며 파일을 다운로드하여 정리합니다. 모든 것이 자율적으로 이루어지지만, 언제든지 당신이 통제권을 가져올 수 있습니다(Human-in-the-loop).

✨ 주요 개선 사항 (엔지니어링 단계)

이 포크는 단순한 복사본이 아닙니다. 다음 단계로 끌어올리기 위해 세 단계의 엔지니어링이 수행되었습니다:

단계 A: 보안 (CVE-2026-78250 패치)

무한 루프 완화: 서비스 거부(DoS) 및 통제되지 않은 API 비용을 방지하기 위해 구성 가능한 안전 한도(MAX_TASK_ITERATIONS 및 TASK_TIMEOUT_MS)를 구현했습니다.
Human-in-the-loop: 작업이 한도를 초과하더라도 실패하지 않습니다. NEEDS_HELP 상태로 전환되어 사람이 개입하여 재개할 수 있습니다.

단계 B: 최적화 (크기 85% 감소)

Debian Bookworm-slim으로 마이그레이션: glibc, VS Code 및 1Password와의 완전한 호환성을 유지하면서 불필요한 소프트웨어와 빌드 도구를 제거했습니다.
멀티 스테이지 빌드: 최종 이미지 크기를 ~7 GB에서 ~1.09 GB로 줄여 효율성을 높이고 공격 표면을 감소시켰습니다.
심층 정리: Thunderbird, xfce4-goodies 및 중복 편집기를 제거했습니다.

단계 C: 통합 검증 (스모크 테스트)

데스크톱, 에이전트, UI 및 데이터베이스의 동시 시작을 검증했습니다.
내부 통신(포트 9990의 VNC)과 외부 통신(포트 9992의 UI)을 확인했습니다.

📚 살아있는 문서 (Obsidian)

이 포크의 큰 기여 중 하나는 프로젝트 두뇌로, AI(그리고 사람)가 길을 잃지 않고 아키텍처를 탐색할 수 있는 컨텍스트 역할을 하는 Obsidian 보관소(vault/)입니다. 다음을 포함합니다:

각 변경의 이유를 설명하는 ADR(아키텍처 결정 기록).
에이전트, UI 및 가상 데스크톱을 위한 상세한 파일 맵.
이 프로젝트에서 AI 에이전트가 어떻게 작업해야 하는지 정의하는 작업 프로토콜(PROTOCOLO_TRABAJO.md 및 PROTOCOLO_OBSIDIAN.md).

🛠️ 사용된 기술

에이전트: NestJS (Node.js 20 Alpine)
가상 데스크톱: Debian Bookworm-slim, XFCE, Xvfb, TigerVNC
프론트엔드: Next.js 15, Tailwind CSS, noVNC
데이터베이스: PostgreSQL 16
인프라: Docker, Docker Compose, 멀티 스테이지 빌드

🚀 시작하기

# 저장소 복제
git clone https://github.com/TU_USUARIO/forkybot_AI.git
cd forkybot_AI

# 환경 변수 구성 (예: Gemini API Key)
echo "GEMINI_API_KEY=tu_clave_aqui" > docker/.env

# 스택 실행
docker-compose -f docker/docker-compose.yml up -d

# 인터페이스 접속
# 브라우저에서 http://localhost:9992 열기

forkybot_AI

인기