EpicStaff/EpicStaff

Source-available, self-hosted platform for building AI agent flows - visual editor over a Django backend.

EpicStaff – 자체 호스팅 AI 에이전트 오케스트레이션 플랫폼

개요 – EpicStaff는 팀이 멀티 에이전트 AI 워크플로우를 설계, 실행, 감사할 수 있는 소스 이용 가능한 웹 애플리케이션입니다. 시각적 노드 기반 편집기가 Django 백엔드 위에 있으며, 각 노드에는 사용자 정의 Python 코드, LLM/임베더 호출, 내장 벡터 저장소에 대한 RAG, 또는 MCP 프로토콜을 통한 통합이 포함될 수 있습니다. 전체 스택이 자체 서버에서 Docker(또는 Podman)로 실행되므로 운영 팀은 워크플로우에 대한 완전한 소유권, 보안 및 감사 가능성을 유지할 수 있습니다.

중요성 – 현재 대부분의 LLM 에이전트는 엔지니어만 읽거나 수정할 수 있는 스크립트로 코딩되어 있습니다. EpicStaff는 통합을 구축하는 엔지니어와 프로세스를 소유, 검사, 제어해야 하는 운영/감사 담당자 간의 격차를 해소합니다. 에이전트가 내리는 모든 결정은 세션 원장에 기록되며, 코드를 재배포하지 않고도 UI에서 검토하거나 편집할 수 있습니다.

빠른 시작 (3단계 요약)

  1. Git 및 Docker(또는 Podman)를 설치합니다.
  2. 리포지토리를 클론하고 예시 환경 파일을 복사합니다:
    git clone https://github.com/EpicStaff/EpicStaff.git && cd EpicStaff/src
cp .env.example .env
  3. Docker Compose 스택을 실행합니다(README의 스크립트가 비밀 키를 생성하고 필요한 볼륨과 네트워크를 만듭니다):
    docker compose up --build
    그런 다음 브라우저에서 http://localhost를 열어 시각적 워크플로우 빌더를 시작합니다.

핵심 기술 기능 (AI 엔지니어용)

기능 설명
노드 기반 UI 드래그 앤 드롭 그래프 편집기; 각 노드에 사용자 정의 Python, LLM 호출 또는 RAG 로직을 포함할 수 있습니다.
LLM 및 임베더 공급자 OpenAI, Anthropic 또는 자체 호스팅 모델 간 전환; 호환되는 추론 엔드포인트를 플러그인할 수 있습니다.
검색 증강 생성 (RAG) UI에서 직접 문서를 업로드하고 벡터 인덱스(Naive 또는 GraphRAG)를 구축; 에이전트는 실행 중에 쿼리할 수 있습니다.
사용자 정의 Python 도구 임의의 Python 함수를 작성하여 모든 에이전트 노드에서 호출 가능한 도구로 사용할 수 있습니다.
영구 에이전트 메모리 단기 창 컨텍스트와 장기 상태를 PostgreSQL(pgvector) 및 Redis에 저장하고 세션 간에 공유합니다.
웹훅 및 API 트리거 HTTP POST를 통해 플로우를 시작하여 CRM, 티켓 시스템 등과 통합할 수 있습니다.
프로덕션 지원 영구성 사용자/조직 변수에 대한 상태 관리가 내장되어 있으며 모든 결정이 세션 원장에 기록됩니다.
Django 백엔드 그래프를 실행하고 에이전트별 권한을 적용하며 감사 추적을 제공하는 강력하고 저지연 Python 서버입니다.

비즈니스 중심 이점

  • 시각적 워크플로우 빌더를 통해 비기술적인 운영 직원이 코드를 건드리지 않고 자동화를 만들고 수정할 수 있습니다.
  • 엔터프라이즈 보안 – 역할 기반 액세스 제어 및 에이전트별 권한을 제공합니다.
  • 감사 가능성 – 에이전트의 모든 결정이 저장되며 검사하거나 롤백할 수 있습니다.
  • 멀티 에이전트 협업 – 여러 에이전트가 협력하여 부서 전체를 자동화하는 "디지털 크루"를 구축할 수 있습니다.
  • 확장 가능한 Python 도구는 내부 API와의 무한한 통합 가능성을 제공합니다.
  • 음성 및 웹 스크래핑 기능을 통해 핸즈프리 데이터 수집과 콘텐츠 생성이 가능합니다.

EpicStaff를 최대한 활용하기

  1. UI에서 에이전트를 정의하고 적절한 LLM 공급자와 필요한 사용자 정의 Python 도구를 연결합니다.
  2. 지식 컬렉션을 생성(문서 업로드 및 인덱싱)하여 RAG 강화 응답을 원하는 경우 대비합니다.
  3. 내부 시스템에 연결 – MCP 또는 직접 Python 호출을 사용; 플랫폼은 실행을 샌드박싱하고 설정한 권한을 적용합니다.
  4. 배포 – Docker 스택을 온프레미스 서버 또는 프라이빗 클라우드에 배포합니다. 제공된 cosign 검증 워크플로우를 사용하여 이미지가 진짜인지 확인합니다.
  5. 모니터링 및 감사 – 내장된 플로우 메시지와 세션 원장을 통해 수행합니다. 필요시 수동 검토를 위해 어떤 단계든 일시 중지할 수 있습니다.

커뮤니티 및 기여

EpicStaff는 풀 리퀘스트, 이슈 보고 및 새로운 도구 기여를 환영합니다. 이 프로젝트는 Foblex 커뮤니티의 오픈소스 f‑flow 라이브러리를 기반으로 하며, 리포지토리에는 자세한 기여 지침(CONTRIBUTING.md)이 포함되어 있습니다. 별 및 포크는 일반적인 GitHub 배지를 통해 추적됩니다.

요약 – EpicStaff는 멀티 에이전트 AI 워크플로우를 구축, 실행 및 감사하기 위한 자체 호스팅, Django 백엔드 기반 시각적 플랫폼을 제공합니다. 드래그 앤 드롭 오케스트레이션, 영구 메모리, RAG 및 사용자 정의 Python 도구를 결합하여 엔터프라이즈급 보안과 완전한 감사 가능성을 제공합니다.

관련

  • 프로젝트
    vstorm-co/full-stack-ai-agent-template

    AI 에이전트 런타임, RAG 파이프라인, 인증, 청구, 관찰성, Docker/K8s 배포 도구가 내장된 프로덕션 준비된 FastAPI + Next.js 웹앱을 생성하는 CLI 생성기입니다.

  • 프로젝트
    JJJJSTIYYYY/Apix

    APIX는 완전한 풀스택 오픈소스 AI 에이전트 협업 플랫폼입니다. 리더 에이전트가 복잡한 작업을 분해하고 병렬로 여러 하위 에이전트를 조율할 수 있으며, Docker 사전 환경을 통한 안전한 코드 실행, 워크스페이스 기반 메모리 시스템, 여러 LLM 제공자(OpenAI, DeepSeek, Ollama 등) 지원을 제공합니다. 데스크톱 앱(Electron/Vue)과 모듈식 Python 백엔드 서비스를 제공하며, RAG를 위한 선택적 Milvus 벡터 DB도 지원합니다. 현재 버전은 2.2.2이지만, 대규모 3.0 재작성이 진행 중입니다.

  • 프로젝트
    lintsinghua/DeepAudit

    DeepAudit는 코드를 분석하고 PoC 공격 스크립트를 생성 및 사전 실행하며 전문 보고서를 출력하는 오픈소스 다중 에이전트 AI 보안 감사 도구입니다. Docker를 통해 실행되며, 로컬 LLM을 지원하고 거짓 양성률을 줄이며 취약점을 자동으로 검증하는 것을 목표로 합니다.

  • 프로젝트
    ModelEngine-Group/app-platform

    AppPlatform은 AI 애플리케이션(챗봇, RAG 파이프라인, 에이전트)을 시각적으로 설계, 실행 및 공유할 수 있는 Docker 기반 로우코드 플랫폼입니다. Java 플러그인 백엔드(FIT + Waterflow)와 React + ELSA 프론트엔드를 결합하여 여러 LLM을 지원하며, 재사용 가능한 앱 템플릿을 저장할 수 있습니다. 빠른 시작: .env를 복사하고 docker/deploy.sh를 실행한 후 http://localhost:8001을 엽니다.

  • 프로젝트
    event-catalog/eventcatalog

    EventCatalog는 소프트웨어 아키텍처 전용 오픈소스 웹 기반 문서 플랫폼입니다. 팀은 도메인, 서비스, 메시지, 스키마를 기록할 수 있으며, AI 기반 자연어 검색, 검색 가능한 스키마 탐색기, 흐름 시각화, 버전 관리, OAuth2 및 RBAC와 같은 기업 기능을 제공합니다. 단일 `npx` 명령어로 설치 후 `http://localhost:3000` 에서 로컬로 실행할 수 있습니다. 여러 npm 패키지(핵심 UI, SDK, CLI 스크래퍼, 시각화 도구)로 배포됩니다.