OpenManus 초보자 설치 가이드: 실제 사례로 보는 AI 에이전트의 세계

들어가며: AI 에이전트란 무엇인가?

OpenManus는 여러분의 아이디어를 현실로 만들어주는 디지털 동반자입니다. 여러분이 "이런 앱을 만들어줘" 또는 "이런 문제를 해결해줘"라고 말하면, OpenManus는 마치 숙련된 개발자처럼 작업을 분석하고, 코드를 작성하며, 해결책을 제시합니다.

이 가이드는 OpenManus를 설치하고 사용하는 과정을 실제 사례와 함께 설명합니다. 코딩 경험이 전혀 없어도 걱정하지 마세요. 여러분의 창의적인 아이디어가 가장 중요한 재료입니다.

준비물

• 맥북 또는 Windows 컴퓨터

• 인터넷 연결

• 호기심과 창의력

• 약 30분의 시간

• OpenAI API 키 (아래 설명)

1단계: OpenAI API 키 준비하기

OpenManus는 GPT-4와 같은 강력한 AI 모델을 활용합니다. 이를 위해 OpenAI API 키가 필요합니다.

실제 사례: "make an app for managing epub or pdf files of books"라는 명령을 내렸을 때, OpenManus는 OpenAI API를 통해 이 요청을 이해하고, 어떤 기능이 필요한지 분석했습니다. API 키는 이런 AI의 두뇌에 접근하는 열쇠와 같습니다.

1. OpenAI 웹사이트에 가입하세요.

2. 로그인 후 오른쪽 상단의 프로필 아이콘을 클릭하고 "View API keys"를 선택하세요.

3. "Create new secret key" 버튼을 클릭하세요.

4. 생성된 API 키를 안전한 곳에 복사해 두세요. (이 키는 나중에 다시 볼 수 없으니 반드시 저장해두세요!)

2단계: 터미널 열기

컴퓨터의 터미널(또는 명령 프롬프트)은 여러분이 컴퓨터와 직접 대화할 수 있는 창입니다.

실제 사례: 설치 로그에서 볼 수 있듯이, 모든 명령어는 터미널에서 실행됩니다. 터미널은 마치 컴퓨터와의 대화창으로, "이 프로그램을 설치해줘", "이 파일을 열어줘"와 같은 명령을 내릴 수 있습니다.

macOS:

1. Finder에서 "응용 프로그램 > 유틸리티 > 터미널"을 찾아 클릭하세요.

2. 또는 Command(⌘) + Space를 누르고 Spotlight 검색에 "Terminal"을 입력하세요.

Windows:

1. 시작 메뉴에서 "cmd" 또는 "명령 프롬프트"를 검색하여 실행하세요.

2. 또는 Windows 키 + R을 누르고 "cmd"를 입력한 후 Enter 키를 누르세요.

3단계: 필수 도구 설치하기

OpenManus를 설치하기 전에 몇 가지 기본 도구가 필요합니다.

실제 사례: 로그를 보면, 사용자는 먼저 Homebrew를 설치한 다음 Python과 Git을 설치했습니다. 이는 마치 집을 짓기 전에 토대를 다지는 것과 같습니다.

macOS:

# Homebrew 설치 (패키지 관리자)
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# Python 설치
brew install python@3.12

# Git 설치
brew install git

Windows:

1. Python 공식 웹사이트에서 Python 3.12 버전을 다운로드하고 설치하세요. 설치 시 "Add python.exe to PATH"를 체크하세요.

2. Git 공식 웹사이트에서 Windows용 Git을 다운로드하고 설치하세요.

4단계: OpenManus 다운로드하기

이제 OpenManus 코드를 다운로드합니다.

실제 사례: 로그에서 git clone 명령어를 사용하여 OpenManus 저장소를 복제하는 것을 볼 수 있습니다. 이것은 마치 건축 설계도를 가져오는 것과 같습니다.

git clone https://github.com/mannaandpoem/OpenManus.git
cd OpenManus

5단계: 가상 환경 설정하기

가상 환경은 다른 프로그램들과 충돌하지 않도록 독립된 작업 공간을 만드는 것입니다.

실제 사례: 로그에서 uv venv 명령어를 사용하여 가상 환경을 생성하고 활성화하는 것을 볼 수 있습니다. 터미널 앞에 (OpenManus)가 표시되면 성공적으로 활성화된 것입니다.

macOS:

# uv 설치
curl -LsSf https://astral.sh/uv/install.sh | sh

# 환경 변수 설정
source ~/.zshrc

# 가상 환경 생성 및 활성화
uv venv --python 3.12
source .venv/bin/activate

Windows:

# 가상 환경 생성
python -m venv venv

# 가상 환경 활성화
venv\Scripts\activate

6단계: 필요한 패키지 설치하기

OpenManus가 작동하려면 여러 패키지(라이브러리)가 필요합니다.

실제 사례: 실제 설치 로그를 보면, 처음에는 모든 패키지를 한 번에 설치하려고 했지만 의존성 충돌 문제가 발생했습니다. 이에 개별 패키지를 하나씩 설치하는 방식을 사용했습니다. 이것은 마치 복잡한 기계의 부품을 조립할 때 호환성을 고려하며 하나씩 조립하는 것과 같습니다.

macOS:

# 기본 패키지 설치
uv pip install pydantic==2.10.6 openai==1.66.3

# 추가 패키지 설치
uv pip install tiktoken tenacity pyyaml loguru numpy datasets
uv pip install fastapi uvicorn html2text gymnasium pillow 
uv pip install browsergym unidiff browser-use 
uv pip install googlesearch-python baidusearch
uv pip install aiofiles duckduckgo_search

Windows:

# 기본 패키지 설치
pip install pydantic==2.10.6 openai==1.66.3

# 추가 패키지 설치
pip install tiktoken tenacity pyyaml loguru numpy datasets
pip install fastapi uvicorn html2text gymnasium pillow 
pip install browsergym unidiff browser-use 
pip install googlesearch-python baidusearch
pip install aiofiles duckduckgo_search

7단계: 설정 파일 구성하기

OpenManus가 AI 모델에 접근할 수 있도록 API 키를 설정합니다.

실제 사례: 설정 파일의 중요성은 "make an app for managing epub or pdf files of books" 예시에서 잘 드러납니다. 제대로 설정된 API 키가 없다면, OpenManus는 이 복잡한 요청을 이해하고 적절한 코드를 생성할 수 없었을 것입니다.

macOS:

# 설정 파일 복사
cp config/config.example.toml config/config.toml

# 설정 파일 편집
nano config/config.toml

Windows:

# 설정 파일 복사
copy config\config.example.toml config\config.toml

# 설정 파일 편집
notepad config\config.toml

열린 파일에서 api_key = "sk-..." 부분을 찾아 실제 OpenAI API 키로 바꾸세요.

8단계: OpenManus 실행하기

모든 준비가 완료되면 OpenManus를 실행할 수 있습니다.

실제 사례: 로그에서 볼 수 있듯이, python main.py 명령어로 OpenManus를 실행한 후 "Enter your prompt:"라는 메시지가 표시되면 사용자는 "make an app for managing epub or pdf files of books"라는 명령을 입력했습니다. 그러자 OpenManus는 이 요청을 분석하고, 앱의 기능을 정의하고, Python 코드를 생성하여 책 관리 앱을 만들어냈습니다.

python main.py

"Enter your prompt:"라는 메시지가 표시되면 여러분의 아이디어나 요청을 자연어로 입력하세요.

9단계: 첫 번째 명령 내리기

OpenManus가 실행되면 여러분의 첫 명령을 입력할 수 있습니다.

실제 사례: "make an app for managing epub or pdf files of books"라는 명령에 OpenManus는 다음과 같이 반응했습니다:

1. 먼저 요청을 분석하고 필요한 기능을 파악했습니다:

   • 책 추가 기능

   • 책 목록 보기 기능

   • 책 정리 기능

   • 책 검색 기능

   • 책 제거 기능

2. 코드 실행을 시도했지만 ebooklib 라이브러리가 없어서 실패했습니다.

3. 문제를 인식하고 PDF 파일만 처리하는 방식으로 접근을 변경했습니다.

4. BookManager 클래스를 개발하여 PDF 파일을 관리할 수 있는 코드를 생성했습니다.

5. 코드를 book_manager.py 파일로 저장했습니다.

6. 생성된 코드를 어떻게 사용하고 확장할 수 있는지 설명했습니다.

이것은 마치 전문 개발자에게 앱 개발을 의뢰한 것과 같은 경험입니다!

10단계: 더 복잡한 시나리오 시도하기

OpenManus의 능력을 더 탐색하기 위해 복잡한 명령을 시도해 보세요.

실제 사례: 로그에서 볼 수 있는 두 번째 예시인 "Create a comprehensive vocabulary memorization system for English teachers"는 더 복잡한 요청이었습니다. OpenManus는 이 요청을 분석하고, 필요한 기능을 파악했습니다:

1. 기억술 기법과 시각적 연상

2. 어원 설명

3. 간격 반복 알고리즘

4. 진행 상황 추적

5. 게임화 요소

그런 다음 기본 시스템 구조를 구현하는 Python 코드를 실행하고, 게임화 전략에 대한 정보를 얻기 위해 웹 검색까지 수행했습니다. 마지막으로 코드를 vocabulary_system.py로 저장했습니다.

세 번째 예시인 누워서 책을 읽을 수 있는 장치 개발 요청은 한국어로 작성되었는데도 OpenManus는 이를 이해하고 분석할 수 있었습니다. 이는 OpenManus가 다양한 언어로 된 요청도 처리할 수 있음을 보여줍니다.

문제 해결 팁

설치 과정에서 문제가 발생하면 다음 팁을 참고하세요:

실제 사례: 로그에서 볼 수 있듯이, 패키지 설치 과정에서 의존성 충돌 오류가 발생했지만, 개별 패키지를 하나씩 설치하는 방식으로 문제를 해결했습니다.

1. 명령어가 작동하지 않을 때:

   • 명령어 앞의 # 기호는 주석이므로 입력하지 마세요.

   • 명령어를 복사-붙여넣기할 때 스페이스와 특수문자가 정확히 복사되었는지 확인하세요.

2. 패키지 설치 오류:

   • 패키지 하나를 설치할 때 오류가 발생하면 다음과 같이 시도해보세요:

   uv pip install [패키지명] --ignore-requires-python
   

3. API 키 문제:

   • OpenAI API 키가 유효한지 확인하세요.

   • API 키에 결제 정보가 연결되어 있는지 확인하세요.

4. 가상 환경이 활성화되지 않을 때:

   • 터미널 앞에 (OpenManus)가 표시되는지 확인하세요.

   • 표시되지 않으면 다음 명령어를 실행하세요:

   source .venv/bin/activate  # macOS
   venv\Scripts\activate      # Windows
   

OpenManus로 시도해 볼 수 있는 프로젝트 아이디어

실제 사례에서 영감을 받아 다음과 같은 프로젝트를 시도해 보세요:

1. 개인 블로그 웹사이트: "Create a simple blog website with a homepage, about page, and blog post listing page" 명령으로 블로그 웹사이트를 만들어보세요.

2. 가족 사진 정리 앱: "Develop an app to organize and tag family photos based on people, dates, and locations" 명령으로 사진 정리 앱을 만들어보세요.

3. 예산 관리 도구: "Create a budget tracking tool that can categorize expenses and visualize spending patterns" 명령으로 예산 관리 도구를 만들어보세요.

4. 어휘 학습 시스템: 로그에서 볼 수 있듯이, "Create a comprehensive vocabulary memorization system" 명령으로 어휘 학습 시스템을 만들어보세요.

5. 혁신적인 제품 설계: "Help me design a book holder for reading while lying down" 명령으로 혁신적인 제품을 설계해보세요.

결론: AI 에이전트와의 새로운 여정

OpenManus를 설치하고 사용하는 과정은 단순한 프로그램 설치를 넘어 AI 에이전트와의 협업 여정입니다. 실제 사례에서 볼 수 있듯이, OpenManus는 복잡한 요청을 이해하고, 문제를 분석하며, 창의적인 해결책을 제시합니다.

코딩 지식이 전혀 없어도 AI의 도움으로 소프트웨어를 개발하고, 복잡한 문제를 해결하고, 혁신적인 제품을 설계할 수 있습니다. 그리고 이 모든 것이 여러분의 간단한 자연어 명령으로 시작됩니다.

OpenManus와 함께하는 이 여정에서 여러분의 창의력만이 한계입니다. 새로운 아이디어를 시도하고, 문제를 해결하고, 혁신을 만들어보세요. 행복한 AI 에이전트 생성 되세요! 🚀