핵심 요점
- MIT 라이선스 — 상업적 이용을 포함해 무료로 사용, 수정, 자체 호스팅 가능
- GitHub 저장소 microsoft/TaskWeaver는 스타 6,100개, 포크 780개를 넘어섬(2023년 9월 생성)
- Microsoft가 2026년 3월 23일 보관 처리 — 저장소는 현재 읽기 전용이며 새 커밋·릴리스·이슈 없음
- Planner + Code Generator 아키텍처를 통해 자연어 요청을 실행 가능한 Python 코드로 변환
- 상태 유지: 세션 전체에 걸쳐 대화 기록과 코드 실행 기록(DataFrame 같은 메모리 내 데이터 포함)을 보존
- 도메인별 데이터 분석 작업을 위한 플러그인 시스템으로 확장
git clone+pip install -r requirements.txt로 설치 — PyPI 패키지 없음
📍 한 문장으로
TaskWeaver는 Microsoft가 데이터 분석용으로 만든 무료, MIT 라이선스, 코드 우선 AI 에이전트 프레임워크로, Planner 역할과 Code Generator 역할을 통해 자연어 요청을 실행 가능한 Python 코드로 변환한다 — Microsoft는 2026년 3월 23일 이 저장소를 보관 처리하여 읽기 전용으로 만들었다.
💬 쉽게 말하면
TaskWeaver를 사용하면 평범한 말로 데이터 작업을 설명하고 실제 Python 코드를 작성·실행해 처리하게 할 수 있으며, 대화와 그 과정에서 생성된 데이터를 모두 기억한다 — 하지만 Microsoft는 개발을 중단하고 이 프로젝트를 읽기 전용으로 표시했다.
📌참고: TaskWeaver는 보관 처리되어 더 이상 활발히 개발되지 않습니다 — 새 프로덕션 작업의 출발점이 아니라 참조 구현이나 기존 배포에 적합한 선택지로 취급하세요. TaskWeaver가 활발히 유지보수되는 에이전트 프레임워크와 어떻게 비교되는지는 로컬 LLM 소프트웨어 디렉터리를 참고하세요.
연구 논문에서 보관된 저장소까지
Microsoft Research는 2023년 말 arXiv에 TaskWeaver 논문을 게재하고 GitHub에 코드를 공개하며, 이를 "데이터 분석 작업을 매끄럽게 계획하고 실행하는 최초의 코드 우선 에이전트 프레임워크"라고 설명했다.
개발은 2024년과 2025년 초까지 계속되었다: 2024년 3월 컨테이너 기반 코드 실행 모드가 기본값으로 출시되었고, 같은 달 올인원 Docker 이미지가 뒤따랐으며, 2024년 9월에는 역할 간 정보를 전달하는 공유 메모리 시스템이 도입되었고, 2024년 12월에는 AgentOps 관찰 가능성 통합이 추가되었으며, 2025년 1월에는 Recepta라는 실험적 추론 역할이 출시되었고, 2025년 3월에는 Planner 역할에 대한 비전 입력이 도입되었다.
프로젝트 자체 변경 로그에서 2025년 3월의 이 업데이트 이후로는 더 이상의 기능 발표가 없었다. 커밋 활동은 의존성 업데이트만으로 줄어들었고, Microsoft는 2026년 3월 23일 이 저장소를 보관 처리했다 — GitHub의 보관 배너에는 저장소가 "소유자에 의해 2026년 3월 23일 보관되었으며" "현재 읽기 전용"이라고 명시되어 있으며, 이는 새 커밋, 풀 리퀘스트, 이슈 제출을 비활성화한다.
이는 TaskWeaver를 이 시리즈의 다른 대부분 프레임워크와 다른 위치에 놓는다. AutoGen은 Microsoft가 관리하는 유지보수 모드(버그 및 보안 수정만)에 있으며 Microsoft Agent Framework라는 명시된 후속작이 있다. 반면 TaskWeaver는 명시된 후속작도, 어떠한 유지보수 약속도 없다 — 보관 시점의 상태 그대로 동결되어 있다.
저장소 생성
- 날짜:
- 2023-09
- 의미:
- GitHub 저장소 microsoft/TaskWeaver가 생성되고, 얼마 지나지 않아 논문이 arXiv에 게재됨
컨테이너 모드 기본화 + Docker 이미지
- 날짜:
- 2024-03
- 의미:
- 코드 실행이 격리된 컨테이너에서 기본으로 수행됨; 한 단계 설정을 위한 올인원 Docker 이미지 출시
공유 메모리 + AgentOps 통합
- 날짜:
- 2024-09 – 2024-12
- 의미:
- 역할 간 메모리 시스템을 통해 정보를 공유할 수 있게 됨; AgentOps와의 관찰 가능성 통합 추가
Recepta 추론 역할 + 비전 입력
- 날짜:
- 2025-01 – 2025-03
- 의미:
- 실험적 추론 역할과 Planner 역할용 비전 입력 출시 — 마지막으로 문서화된 기능들
Microsoft가 저장소 보관 처리
- 날짜:
- 2026-03-23
- 의미:
- GitHub가 저장소를 읽기 전용으로 표시: 새 커밋, 릴리스, 풀 리퀘스트, 이슈 불가
📌참고: MIT 라이선스는 보관으로 인해 변경되지 않는다 — 기존 코드는 그 조건 아래 자유롭게 사용, 포크, 수정할 수 있다. 달라지는 점은 Microsoft가 앞으로 버그를 수정하거나 보안 문제를 패치하거나 새 기능을 추가하지 않는다는 것이다.
TaskWeaver란 무엇인가?
TaskWeaver는 Microsoft Research가 데이터 분석을 위해 만든 오픈소스 코드 우선 AI 에이전트 프레임워크(MIT 라이선스, 보관됨, github.com/microsoft/TaskWeaver)로, 자연어 요청을 자유 형식 지시가 아닌 실행 가능한 Python 코드로 해석하고, 해당 코드를 상태를 유지하는 세션에서 실행한다.
- Planner 역할: 복잡한 요청을 일련의 하위 작업으로 분해하고 대화 전체에 걸쳐 진행 상황을 추적함
- Code Generator 역할: 각 하위 작업을 수행할 실행 가능한 Python 코드 조각을 작성하며, 설정된 플러그인과 조율함
- 플러그인 시스템: 데이터베이스 쿼리, 예측, 문서 검색 등 도메인별 작업이 Code Generator가 호출할 수 있는 플러그인으로 패키징됨
- 상태 유지 실행: TaskWeaver는 이전 메시지의 텍스트뿐 아니라 대화 기록과 코드 실행 기록(pandas DataFrame 같은 메모리 내 데이터 구조 포함)을 세션 전체에 걸쳐 보존함
- 풍부한 데이터 구조: 상태가 메모리에 유지되므로 TaskWeaver는 DataFrame이나 다른 Python 객체를 텍스트로 다시 직렬화하지 않고 단계 간에 직접 전달할 수 있음
- 코드 검증: 생성된 코드는 실행 전에 잠재적 문제가 있는지 확인되며, 제안된 수정 사항이 사용자에게 표시됨
- 세션 기반 다중 사용자 분리: 기본적인 세션 관리로 여러 사용자의 데이터를 분리하며, 코드 실행은 간섭을 피하기 위해 별도 프로세스에서 실행됨
- 기본적으로 컨테이너 기반 실행: 2024년 3월부터 생성된 코드는 호스트 프로세스가 아닌 컨테이너 내부에서 실행되며, 이는 Docker를 필요로 함
# 클론 후 설치 (Python 3.10 이상 필요)
git clone https://github.com/microsoft/TaskWeaver.git
cd TaskWeaver
pip install -r requirements.txt
# taskweaver_config.json에서 LLM을 설정한 뒤 실행:
python -m taskweaver -p ./project/TaskWeaver 비용은 얼마인가?
TaskWeaver 자체는 MIT 라이선스 아래 무료다 — 구독료, 유료 등급, Microsoft가 호스팅하는 서비스 비용이 전혀 없다. 지불하는 것은 자신의 하드웨어나 서버, 그리고 taskweaver_config.json에서 설정한 LLM 제공업체의 API 요금뿐이다.
- TaskWeaver(오픈소스 프레임워크): MIT 라이선스 아래 영구 무료, 자체 호스팅, 사용량 제한 없음, 실행에 Microsoft 계정 불필요
- Microsoft가 호스팅하는 제품이나 구독 없음: TaskWeaver는 직접 실행하는 코드이며 관리형 서비스가 아니다 — 구독할 것이 없음
- 선택적 비용: 클라우드 모델을 로컬 모델 대신 연결할 경우, 자신의 하드웨어나 서버 및 설정한 LLM 제공업체의 API 요금(예: OpenAI의 토큰당 가격)
- 선택적 비용: 기본 컨테이너 기반 코드 실행 모드에는 Docker가 필요하며, 이미 보유했거나 직접 프로비저닝한 인프라에서 실행됨
TaskWeaver를 어떻게 설치하고 시작하는가?
TaskWeaver에는 PyPI 패키지가 없다 — GitHub 저장소를 클론하고 pip로 요구사항을 설치해 설치하며, Python 3.10 이상이 필요하다. 프로젝트가 보관 처리되었으므로 이는 보관 시점에 배포되었던 설치 과정 그대로이며, 대신 설치할 향후 릴리스는 없을 것이다.
- 1Python 3.10 이상이 설치되어 있는지 확인한다(선택적으로 먼저 전용 환경을 만들 수 있음:
conda create -n taskweaver python=3.10 && conda activate taskweaver). - 2저장소를 클론한다:
git clone https://github.com/microsoft/TaskWeaver.git. - 3의존성을 설치한다:
cd TaskWeaver && pip install -r requirements.txt. - 4
taskweaver_config.json에서 LLM 제공업체를 설정한다 — 예를 들어 OpenAI의 경우{"llm.api_key": "당신의 키", "llm.model": "gpt-4"}. - 5기본 컨테이너 기반 코드 실행 모드를 사용할 계획이라면 Docker를 설치한다(권장); 컨테이너를 사용하지 않는 대안은 코드 실행 문서를 참고한다.
- 6클론한 폴더에서 CLI를 시작한다:
python -m taskweaver -p ./project/, 또는 대신 프로젝트를 라이브러리로 가져온다 — 라이브러리 사용 문서를 참고한다.
보관 처리되었는데도 TaskWeaver를 설치할 수 있나요?
네. 보관은 새로운 기여에 대해 저장소를 읽기 전용으로 만들지만, 기존 코드와 브랜치, 태그된 릴리스는 공개 당시 그대로 완전히 다운로드하고 설치할 수 있습니다.
TaskWeaver의 PyPI 패키지가 있나요?
없습니다. 문서화된 설치 경로는 클론한 폴더에서 git clone 후 pip install -r requirements.txt를 실행하거나, 특정 태그 릴리스의 경우 pip install git+https://github.com/microsoft/TaskWeaver@<TAG>를 사용하는 것입니다.
TaskWeaver는 누구에게 적합한가?
TaskWeaver는 이미 이를 기반으로 구축된 실제 배포를 보유한 팀, 또는 Planner/Code Generator 아키텍처를 참조 구현으로 연구하고 싶은 팀에게 적합하다. 보관 상태를 고려하면, 오늘 새로운 프로덕션 에이전트 프로젝트를 시작하려는 사람에게는 더 좁은 선택지다.
TaskWeaver를 언제 사용하지 말아야 하는가?
이 리뷰 시점 기준으로 새로운 프로덕션 프로젝트에는 TaskWeaver를 피해야 한다 — Microsoft는 2026년 3월 23일 저장소를 보관 처리했으며, 앞으로 유지보수도, 보안 패치도, 로드맵도 없다.
- 새 에이전트 프로젝트를 처음부터 시작하는 팀 — 해결되지 않은 채 동결된 53건의 이슈가 있는 보관된 저장소는 새 프로덕션 작업의 기반으로 약하다
- 의존성에 대한 보안 패치가 필요한 팀 —
requirements.txt에 고정된 버전은 보관 이후로 동결되어 업데이트되지 않으므로, 고정된 의존성에서 나중에 발견되는 취약점은 업스트림에서 수정되지 않는다 - 공식 지원이 필요한 팀 — 프로젝트 README에 따르면 한때 "우선" 지원 채널이었던 GitHub Issues는 보관된 저장소에서 더 이상 새 제출을 받지 않는다
- 새 구축을 위해 특별히 Microsoft 에이전트 프레임워크를 평가하는 팀 — 대신 AutoGen(유지보수 모드, 적어도 수정 사항은 계속 받음)이나 적극적으로 개발되는 Microsoft Agent Framework부터 시작하라
- TaskWeaver는 그 코드 우선, 상태 유지형 Planner/Code Generator 패턴의 기존 배포를 특별히 연구하거나 유지보수해야 할 때만 사용하라
TaskWeaver와 대안 비교
TaskWeaver는 다른 코드 실행형·Microsoft 생태계 에이전트 프레임워크와 경쟁하며, 그중 대부분은 — TaskWeaver와 달리 — 여전히 적극적으로 유지보수되거나 적어도 공식 유지보수 모드에 있다.
도구 | 인터페이스 | 라이선스 | 상태 | 가장 적합한 용도 |
|---|---|---|---|---|
| TaskWeaver | Python 코드 / CLI | MIT | 보관됨 (2026-03) | 기존 배포 연구/유지 |
| AutoGen | Python 코드 | MIT / CC BY 4.0 | 유지보수 모드 | 기존 AutoGen 앱에만 해당 |
| Semantic Kernel | .NET/Python/Java SDK | MIT | 활발함 (MAF로 수렴 중) | 엔터프라이즈 오케스트레이션 SDK |
| CrewAI | Python 코드 | MIT | 활발함, VC 투자 | 역할 기반 다중 에이전트 팀 |
| LangGraph | Python 코드 | MIT | 활발함 | 상태 유지형 그래프 기반 워크플로 |
TaskWeaver 평가 시 흔한 실수
이러한 실수는 저장소 상태를 직접 확인하지 않거나 TaskWeaver를 다른 Microsoft 에이전트 프로젝트와 혼동하는 데서 비롯된다.
자주 묻는 질문
TaskWeaver는 아직 유지보수되나요?
아닙니다. Microsoft는 2026년 3월 23일 microsoft/TaskWeaver 저장소를 보관 처리하여 읽기 전용으로 만들었습니다 — 앞으로 새로운 커밋, 릴리스, 이슈 제출은 받아들여지지 않습니다.
TaskWeaver는 무료로 사용할 수 있나요?
네. TaskWeaver는 MIT 라이선스이며 상업적 이용, 수정, 자체 호스팅이 무료입니다. 구독료나 Microsoft가 호스팅하는 유료 제품이 없습니다.
GitHub 저장소에서 "보관됨"은 무슨 의미인가요?
소유자가 저장소를 보관 처리하면 GitHub는 이를 읽기 전용으로 표시합니다: 새로운 커밋, 풀 리퀘스트, 이슈를 제출할 수 없지만 기존 코드, 브랜치, 릴리스는 계속 다운로드할 수 있습니다.
TaskWeaver의 핵심 아키텍처는 무엇인가요?
Planner 역할이 요청을 하위 작업으로 분해하고, Code Generator 역할이 각 하위 작업에 대해 Python 코드를 작성·실행하며, 플러그인 시스템이 도메인별 작업을 제공합니다 — 이 모든 것이 대화 기록과 코드 실행 기록을 보존하는 상태 유지형 세션에서 조율됩니다.
TaskWeaver는 어떻게 설치하나요?
git clone https://github.com/microsoft/TaskWeaver.git로 저장소를 클론한 뒤, 클론한 폴더 안에서 pip install -r requirements.txt를 실행하세요. PyPI 패키지는 없습니다.
TaskWeaver는 Docker가 필요한가요?
엄격히 필수는 아니지만, 2024년 3월 이후 기본 코드 실행 모드는 생성된 코드를 컨테이너 내부에서 실행하며 이는 Docker를 필요로 합니다 — 컨테이너를 사용하지 않는 대안은 코드 실행 문서를 참고하세요.
TaskWeaver는 어떤 라이선스로 배포되나요?
MIT 라이선스이며, 무료 상업적 이용, 수정, 자체 호스팅을 허용합니다. 저장소 보관은 라이선스를 변경하지 않습니다.
TaskWeaver를 대체한 것은 무엇인가요?
TaskWeaver에는 공식적으로 명시된 후속작이 없습니다. 적극적으로 개발 중인 범용 Microsoft 에이전트 프레임워크가 필요하다면 대신 Microsoft Agent Framework나 Semantic Kernel을 검토하세요.
TaskWeaver의 GitHub 스타는 몇 개인가요?
2026년 9월 기준 microsoft/TaskWeaver 저장소는 GitHub 스타 6,100개, 포크 780개를 넘어섰습니다.
TaskWeaver에 여전히 이슈를 열거나 기여할 수 있나요?
아닙니다. 보관으로 인해 새로운 이슈와 풀 리퀘스트가 비활성화됩니다. 보관 시점에 열려 있던 53건의 이슈는 계속 표시되지만 동결된 상태이며 처리되거나 닫히지 않습니다.