OpusAgents: AI 에이전트 및 도구 구축을 위한 오픈소스 프레임워크

Opus Agents는 AI 에이전트를 쉽게 구축하고 도구를 구성할 수 있도록 돕는 오픈소스 Agentic AI 프레임워크입니다.

이 프레임워크의 목표는 단순히 MCP 서버를 에이전트나 Claude Desktop, Cursor 같은 다른 AI 도구에 추가하는 것보다 더 예측 가능하고 신뢰할 수 있는 방식으로 사용될 수 있는 에이전트와 도구를 구축하는 것입니다. 이는 여러 MCP 서버/도구로 인한 Context pollution을 줄이고, Custom tool, Higher order tool, Meta tool 등과 같은 추상화를 사용하여 Tool 선택 정확도를 향상시킵니다.

OpusAgents 프레임워크를 사용해 구축된 에이전트의 예:

# DeepWork 스케줄링 에이전트 구축
config_manager = ConfigManager()
deepwork_agent = (
...

OpusAgents는 특정 도메인을 위한 번들된 AI 에이전트와 도구를 제공합니다. OpusTodoAgent는 Google Calendar, Slack, Zoom, 할 일 목록(Todo lists), 노트 등 생산성 및 협업 소프트웨어에 중점을 둔 번들 에이전트입니다.

OpusTodoAgent의 목표는 우리가 매일 사용하는 생산성, 협업, 소프트웨어 개발 등의 소프트웨어를 마치 자신만의 Jarvis를 가진 것처럼 더 원활하고 예측 가능하며 신뢰할 수 있게 만드는 것입니다. OpusTodoAgent가 특정 사용 사례에서 Cursor나 ClaudeDesktop을 MCP 서버와 함께 사용하는 것보다 얼마나 더 원활한지 확인하려면 docs/COMPARE_CURSOR_MCP_VS_OPUS.md 파일을 참조하십시오.

프레임워크 자체와 번들된 에이전트 모두 확장 가능하고 수정하기 쉬워서(extensible/hackable), 사용자의 고유 워크플로우 및 자주 사용하는 소프트웨어에 맞게 쉽게 확장할 수 있습니다.

OpusAgents 프레임워크를 사용하여 자신만의 도구를 구축하거나 자신만의 에이전트를 구축할 수 있습니다. 시작하려면 다음 가이드를 참조하십시오:

Custom tool 구축: Custom tools는 함수 도구(function tools)와 유사하게 에이전트의 기능을 확장합니다.
Higher Order tool 구축: Higher order tools는 하나 이상의 기존 MCP 서버/도구 위에 추가되는 기능으로, 에이전트가 사용하기 더 쉽게 만듭니다.
Meta tool 구축: Meta tools는 OpenAPI specs와 같은 기존 패턴 위에 재사용 가능한 도구로, 최소한의 코드로 구축할 수 있습니다.
에이전트 구축: 프레임워크의 모든 측면을 사용하는 방법을 보여주는 완전한 에이전트입니다.

프레임워크는 PydanticAI와 FastMCP를 기반으로 구축되었습니다.

Google Calendar, Slack, Todoist, Obsidian, Zoom 등 생산성/협업 소프트웨어에서 OpusAgents를 사용하려면 '설치 및 사용자 가이드(Installation and User Guide)'를 참고하세요.

프레임워크 또는 번들된 도구에 대한 개발 및 기여는 '기여 가이드(Contributing Guide)'를 읽어보세요.

• AI 에이전트 오케스트레이션, 모델, MCP 서버, 사용자 지정 도구, 상위 수준 도구, 프롬프트 관리
• 에이전트를 위한 CLI, 슬래시 명령어용 CLI
• 설정 관리
• 프롬프트 관리
• Frontier 모델 및 gpt-oss, Qwen3, Ollama3와 같은 로컬 LLM을 사용한 모델 관리
• MCP 서버 통합
• MCP 서버를 향상시키는 사용자 지정 도구 및 상위 수준 도구
• 곧 출시 예정 - 플러그인, Cursor/ClaudeDesktop과 같은 기존 AI 도구와의 통합, 로컬 모델 엔드투엔드

생산성 및 협업 도구를 위한 주요 기능은 다음과 같습니다:

• 생산성

  • 할 일 목록 - 일일 및 주간 검토, 사용자 지정 GTD 또는 작업 우선순위 프레임워크
  • 메모 작성 - 노트에 인덱싱하고 질문하기

• 협업

  • Google Calendar 또는 Clockwise - 회의 브리핑 받기, 심층 작업 일정 잡기, 캘린더 최적화
  • Slack - 팀/프로젝트별 채널 따라잡기
  • Zoom 또는 Loom - 회의 녹취록에 후속 질문하기
  • Gmail (곧 출시 예정) - 받은 편지함 제로(Inbox Zero)를 달성하기 위해 개인 워크플로우 적용

• 보안

  • 내장된 데이터 보안은 작업장에서 승인한 방법과 OAuth를 통해서만 도구를 인증하고 권한을 부여할 수 있도록 보장합니다.
  • 민감한 데이터는 gpt-oss, Qwen3, Ollama3와 같은 로컬 LLM에서 독점적으로 실행되도록 구성할 수 있습니다.

선호하는 소프트웨어 또는 사용자 지정 워크플로우가 여기에 없는 경우, '기여 가이드(Contributing Guide)'를 참고하여 Pull request를 제출해 주세요.

opus_agent_base를 빌드하고 로컬에서 릴리스하려면:

# wheel 파일 빌드
cd opus_agent_base
uv run python -m build
...

opus_agent_base를 빌드하고 PyPI에 릴리스하기: TODO

다른 Python 프로젝트에서 opus_agent_base를 사용하려면: TODO

Opus Agents는 커스터마이징 가능하고 해킹 가능한 프레임워크로 설계되었습니다. 이 프로젝트는 MIT LICENSE 하에 오픈 소스로 유지될 것입니다.

AI에 대한 의견은 'AI가 인간을 대체할 것'이라는 극단적인 주장부터, '현재 AI는 지능이 아니라 다음 토큰 예측일 뿐이다'라는 주장에 이르기까지 다양합니다. 이 프로젝트는 Neil DeGrasse Tyson의 팟캐스트(https://www.youtube.com/watch?v=BYizgB2FcAQ)에서 나온 AI에 대한 균형 잡힌 관점에서 영감을 받았습니다. 그는 사회가 이미 산업 혁명부터 자동차, 인터넷을 거쳐 왔으며, AI가 인간 생산성을 통해 다음 폭발적 성장의 물결을 이끌 것이라고 제안합니다. 우리는 Cursor나 코딩 CLI와 같은 AI 코딩 도구에서 이미 이러한 모습의 단편들을 보고 있습니다. 이 비전이 모든 영역에서 가능해지기 위해서는 AI가 우리가 사용하는 대부분의 소프트웨어/도구에 대한 Jarvis와 같은 동반자가 되어야 합니다. OpusAgents는 우리가 일상적으로 사용하는 AI와 소프트웨어/도구 간의 상호작용을 가능한 한 원활하고, 커스터마이징 가능하며, 예측 가능하고/신뢰할 수 있으며, Jarvis와 같도록 만드는 시도입니다.

이 이름은 '위대한 작품'이라는 뜻의 라틴어 구절 "magnum opus"에서 영감을 받았습니다.