안녕하세요! 김코딩입니다
최근 오픈소스 커뮤니티에서 주목받고 있는 OpenManus는 Manus의 아이디어를 확장해 누구나 자유롭게 사용할 수 있도록 만든 AI 에이전트입니다. 이 글에서는 Windows와 macOS 환경에서 OpenManus를 설치하고 실행하는 방법을 단계별로 자세히 설명합니다. 특히, Python 3.11 이상을 요구하는 환경에서의 설치 문제를 해결하는 방법까지 다룹니다.
1. OpenManus란 무엇인가?
OpenManus는 **”No fortress, purely open ground”**이라는 슬로건 아래, 초대코드 없이 누구나 사용할 수 있는 오픈소스 AI 에이전트입니다. 다양한 아이디어를 구현하고 실험해볼 수 있도록 설계되어 있으며, 자유로운 확장성과 사용자 친화적인 환경을 제공합니다.
특징 요약:
- 자유로운 사용: 초대코드 필요 없음
- 확장성: 다양한 AI 모델 및 API와 호환
- 오픈소스: GitHub에서 소스코드 공개
- 유연한 환경 설정: 사용자 맞춤 설정 가능
2. OpenManus 설치 전 준비 사항
OpenManus를 설치하고 사용하기 전에 다음과 같은 준비가 필요합니다.
📌 1) Git 설치
- Git을 통해 GitHub 저장소에서 코드를 클론합니다.
- Git 다운로드
📌 2) Python 3.11 이상 설치
- Python 3.11 이상을 설치해야 합니다. Python 다운로드
- 설치 시 “Add Python to PATH” 옵션을 체크합니다.
📌 3) uv 설치
- uv는 빠른 Python 패키지 설치와 의존성 관리를 돕는 도구입니다.
📌 4) API 키 준비
- OpenAI API 키가 필요합니다. API 키 발급
3. Python 3.11 이상으로 OpenManus 설치하기
Python 3.11 이상 환경에서 설치할 때의 문제 해결 방법을 포함합니다.
📌 1) uv 설치
터미널에 다음 명령어를 입력해 uv를 설치합니다.
curl -LsSf https://astral.sh/uv/install.sh | sh
📌 2) GitHub 저장소 클론
OpenManus의 소스를 로컬에 복제합니다.
git clone https://github.com/mannaandpoem/OpenManus.git
cd OpenManus
📌 3) 가상 환경 생성 및 활성화
Python 3.11 기반의 가상 환경을 생성하고 활성화합니다.
1) 기존 가상 환경 삭제:
rd /s /q .venv
2) 새로운 가상 환경 생성:
uv venv
3) 가상 환경 활성화:
.venv\Scripts\activate
4) Python 버전 확인:
python --version
- 예상 결과:
Python 3.11.x
📌 4) 필수 패키지 설치
Python 3.11 환경에서 requirements.txt를 설치합니다.
uv pip install -r requirements.txt
❗ 에러 발생 시 해결 방법:
만약 아래와 같은 에러가 발생한다면:
x No solution found when resolving dependencies:
`-> Because the current Python version (3.10.16) does not satisfy Python>=3.11,<4.0...
해결 방법:
- Python 3.11 이상을 설치합니다.
- 위의 가상 환경 삭제 및 재생성 단계를 다시 진행합니다.
4. OpenManus 환경 설정
📌 1) 설정 파일 복사
기본 설정 파일을 복사해 사용자 설정 파일을 생성합니다.
cp config/config.example.toml config/config.toml
📌 2) 설정 파일 수정 (config/config.toml)
- API 키와 모델 설정을 입력합니다.
[llm] model = "gpt-4o" base_url = "https://api.openai.com/v1" api_key = "sk-..." # 자신의 API 키로 교체 max_tokens = 4096 temperature = 0.0
5. OpenManus 실행 방법
📌 1) 가상 환경 활성화:
.venv\Scripts\activate
📌 2) 최신 소스로 업데이트 및 실행:
git pull
python main.py
6. OpenManus 자동화 스크립트 작성
🪟 1) Windows: BAT 파일 (run_openmanus.bat)
@echo off
call .venv\Scripts\activate
git pull
python main.py
pause
🍏 2) macOS: 쉘 스크립트 (run_openmanus.sh)
#!/bin/bash<br>source .venv/bin/activate<br>git pull<br>python main.py<br>read -p "Press any key to exit..."<br>
실행 권한 부여:
chmod +x run_openmanus.sh
스크립트 실행:
./run_openmanus.sh
🔄 7. 유지보수 및 업데이트
- 주기적으로 GitHub 저장소를 확인하고 업데이트를 적용하세요.
- 패키지 업데이트:
uv pip install --upgrade -r requirements.txt
8. 자주 묻는 질문 (FAQ)
Q1. API 키를 어디서 발급받나요?
A. OpenAI API에서 발급받을 수 있습니다.
Q2. 설치 중 오류가 발생해요!
A. pip와 uv를 최신 버전으로 업데이트한 후 다시 시도해보세요.
9. 마무리 및 참고 자료
OpenManus는 오픈소스 AI 에이전트로서 높은 확장성과 자유도를 제공합니다. 이번 가이드를 참고해 직접 설치하고 다양한 기능을 활용해 보세요.
참고 자료:
이상으로 OpenManus 설치 및 사용 방법에 대한 안내를 마칩니다. 😊
꾸준한 업데이트와 관리로 더 편리하게 사용해보세요!