OpenManus: 로컬에서 AI 에이전트 실행하기

By /

OpenManus: 로컬에서 AI 에이전트 실행하기

게시일: 2025/03/09 21:46 | 조회수: 45

최근 오픈소스 커뮤니티에서 OpenManus가 주목받고 있다. 기존 AI 에이전트인 Manus의 개념을 확장하여 누구나 쉽게 활용할 수 있도록 개발된 프로젝트로, 초대 코드 없이 설치 및 실행이 가능하다는 점이 특징이다. 이번 글에서는 GitHub에 공개된 가이드를 참고하여 Windows와 macOS 환경에서 OpenManus를 설치하고 실행하는 방법을 소개한다.

1. OpenManus란?

OpenManus는 “No fortress, purely open ground“라는 철학을 기반으로 한 AI 에이전트다. 별도의 제한 없이 자유롭게 사용할 수 있으며, 설치 후 API 키만 입력하면 AI 기반 작업을 실행할 수 있다.

2. 설치 전 준비사항

설치를 진행하기 전에 다음 도구들이 필요하다.

  • Git → GitHub에서 저장소를 클론(clone)하기 위해 필요
  • Python 3.12 → 최신 버전 사용 권장
  • uv → Python 패키지 및 의존성 관리 도구
  • API 키 → OpenAI 등의 AI 서비스를 활용하려면 필요

3. OpenManus 설치 방법

(1) uv 설치

먼저, uv를 설치하려면 아래 명령어를 실행한다.

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

(2) GitHub에서 저장소 복제

Git을 이용해 OpenManus 저장소를 로컬에 복사한다.

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

(3) 가상 환경 생성 및 활성화

uv를 이용해 가상 환경을 생성하고 활성화한다.

uv venv
source .venv/bin/activate  # macOS/Linux
# Windows에서는:
# .venv\Scripts\activate

(4) 필수 패키지 설치

프로젝트 실행에 필요한 패키지를 설치한다.

uv pip install -r requirements.txt

(5) Playwright 설치

웹 자동화 기능이 필요하다면 Playwright를 설치한다.

playwright install

4. 환경 설정

(1) 설정 파일 생성

기본 설정 파일을 복사해 사용자 설정 파일을 만든다.

cp config/config.example.toml config/config.toml

(2) 설정 파일 수정

API 키 및 기타 설정을 config/config.toml에서 직접 입력해야 한다.

[llm]
model = "gpt-4o"
base_url = "https://api.openai.com/v1"
api_key = "sk-..."  # 본인의 API 키 입력
max_tokens = 4096
temperature = 0.0

설정 파일에서 [llm]과 [llm.vision] 섹션이 중복되지 않도록 주의한다.

5. OpenManus 실행하기

설치가 끝났다면 이제 OpenManus를 실행할 차례다.

source .venv/bin/activate  # macOS/Linux
.venv\Scripts\activate      # Windows
git pull                    # 최신 소스로 업데이트
python main.py              # OpenManus 실행

6. 실행 자동화

매번 수동으로 실행하는 대신, 스크립트를 만들어 자동으로 실행할 수도 있다.

Windows – 배치 파일 (BAT) 사용

Windows에서는 .bat 파일을 생성하고 다음 내용을 입력한다.

@echo off
call .venv\Scripts\activate
git pull
python main.py
pause

macOS – 쉘 스크립트 (SH) 사용

macOS에서는 .sh 파일을 생성한 뒤 다음 명령어를 추가한다.

#!/bin/bash
source .venv/bin/activate
git pull
python main.py
read -p "Press any key to exit..."

이후 실행 권한을 부여하고 사용할 수 있다.

chmod +x run_openmanus.sh
./run_openmanus.sh

7. 마무리

이제 OpenManus를 로컬 환경에서 자유롭게 실행할 수 있다. AI 기반 에이전트가 필요한 사용자라면 OpenManus를 직접 설치하여 활용해 보자. 보다 상세한 정보는 GitHub 저장소에서 확인할 수 있다. 🚀

Related Posts