Repolode
crewAIInc

crewAIInc/crewAI

역할 기반 자율 AI 에이전트(Crews)와 이벤트 기반 워크플로(Flows)를 오케스트레이션하는 오픈 소스 Python 프레임워크입니다.

스타
59,907
포크
8,806
열린 이슈
762
마지막 커밋
16시간 전

어떤 프로젝트인가요?

CrewAI는 멀티 에이전트 시스템을 구축하기 위한 Python 프레임워크입니다. 각 에이전트에는 역할, 목표, 배경 정보가 정의되어 있으며 도구, 메모리, 지식 소스를 활용할 수 있습니다. 에이전트는 Crews로 그룹화되어 태스크를 나눠 수행하며, 순차적으로 실행하거나 계층형 관리자 프로세스에 따라 실행할 수 있습니다.

Flows는 프레임워크에서 결정론적 워크플로를 담당합니다. 공유 상태, 조건 분기, @start, @listen, @router 같은 데코레이터를 통한 라우팅, or_ 및 and_ 논리 연산자를 지원하는 이벤트 기반 워크플로입니다. Flow는 단일 LLM을 호출하거나, Crew를 단계 중 하나로 실행하거나, 두 방식을 하나의 파이프라인에 결합할 수 있습니다.

프로젝트는 JSON 파일(agents/*.jsonc 및 crew.jsonc)이나 Python 클래스로 설정할 수 있으며, crewai CLI를 통해 프로젝트를 생성하고 설치 및 실행할 수 있습니다. Python 3.10 이상 3.14 미만이 필요하고, OpenAI 및 Ollama 같은 로컬 모델 연결을 지원하며 MCP와 A2A도 지원합니다.

핵심 기능

  • 01목표, 배경 정보, 도구, 메모리를 갖춘 역할 기반 에이전트가 Crews 안에서 협업합니다.
  • 02공유 상태, 조건 분기, 라우팅 데코레이터를 지원하는 이벤트 기반 Flows입니다.
  • 03태스크 조정을 위한 순차 및 계층형 프로세스 모드를 제공합니다.
  • 04crewai CLI로 프로젝트 생성, 설치, 실행을 지원합니다.
  • 05OpenAI 및 Ollama, LM Studio 같은 로컬 모델에 연결할 수 있습니다.
  • 06에이전트 통합을 위한 MCP 및 A2A를 지원합니다.

활용 사례

  • 전문 에이전트를 활용해 여러 단계로 진행되는 조사와 보고서 작성을 자동화합니다.
  • LLM 호출과 결정론적인 Python 비즈니스 로직을 결합한 프로덕션 워크플로를 구축합니다.
  • 하위 태스크를 위임하고 서로의 결과를 검증하는 에이전트 팀을 프로토타이핑합니다.
  • AI 기반 프로세스에 사람의 검토 단계와 구조화된 출력을 추가합니다.

빠른 시작

  1. 1

    Python 버전이 3.10~3.14인지 확인합니다

    python3 --version
  2. 2

    README에 있는 공식 uv 설치 스크립트를 실행합니다(다운로드한 뒤 셸에 파이프로 전달).

  3. 3

    CrewAI CLI를 설치합니다

    uv tool install crewai
  4. 4

    새 crew 프로젝트를 만듭니다

    crewai create crew <project_name>

사용 전 알아둘 점

  • Python >=3.10 및 <3.14가 필요합니다.
  • 예제 crew는 openai/gpt-4o와 같은 호스팅 LLM을 호출하므로, 프로젝트의 .env 파일에 본인의 모델 API 키를 설정해야 합니다.
  • Windows에서는 Visual Studio Build Tools가 없으면 chroma-hnswlib 종속 항목 빌드에 실패할 수 있습니다.

토픽

자주 묻는 질문

crewAI은(는) 무엇인가요?
역할 기반 자율 AI 에이전트(Crews)와 이벤트 기반 워크플로(Flows)를 오케스트레이션하는 오픈 소스 Python 프레임워크입니다. CrewAI는 멀티 에이전트 시스템을 구축하기 위한 Python 프레임워크입니다. 각 에이전트에는 역할, 목표, 배경 정보가 정의되어 있으며 도구, 메모리, 지식 소스를 활용할 수 있습니다. 에이전트는 Crews로 그룹화되어 태스크를 나눠 수행하며, 순차적으로 실행하거나 계층형 관리자 프로세스에 따라 실행할 수 있습니다.
crewAI은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
crewAI은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
crewAI은(는) 아직 유지보수되고 있나요?
활발히 유지보수 중. crewAI의 마지막 커밋은 2026년 10월 20일입니다.
crewAI은(는) 어디에 사용할 수 있나요?
전문 에이전트를 활용해 여러 단계로 진행되는 조사와 보고서 작성을 자동화합니다. LLM 호출과 결정론적인 Python 비즈니스 로직을 결합한 프로덕션 워크플로를 구축합니다. 하위 태스크를 위임하고 서로의 결과를 검증하는 에이전트 팀을 프로토타이핑합니다. AI 기반 프로세스에 사람의 검토 단계와 구조화된 출력을 추가합니다.
crewAI는 어떻게 설치하나요?
Python 버전이 3.10~3.14인지 확인합니다: python3 --version README에 있는 공식 uv 설치 스크립트를 실행합니다(다운로드한 뒤 셸에 파이프로 전달). CrewAI CLI를 설치합니다: uv tool install crewai 새 crew 프로젝트를 만듭니다: crewai create crew <project_name>
crewAI은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/crewAIInc/crewAI

요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.

관련 프로젝트