빠른 실행
초기 설정과 API 키 입력을 마친 상태에서 서버를 시작하고 사용하는 방법을 설명합니다.
개발 서버 구동
기본적으로 nexus-agent는 단일 포트 서버 형태로 백엔드(FastAPI)와 프론트엔드 정적 파일(Next.js)을 서빙합니다.
명령줄에 다음을 입력하세요:
nexus-agent start
성공적으로 구동되면 브라우저에서 http://localhost:8000 주소를 열어 UI 화면에 접속할 수 있습니다.
옵션 활용하기
서버를 시작할 때 추가할 수 있는 플래그 옵션들입니다.
# 기본 8000 포트가 아닌 다른 포트를 지정합니다.
nexus-agent start --port 9000
# 외부 접속을 제한하고 로컬(127.0.0.1) 연결만 허용합니다.
nexus-agent start --host 127.0.0.1
# 개발 모드로 구동합니다. CORS(Cross-Origin Resource Sharing)를 허용하며 브라우저 자동 리로드가 적용됩니다.
nexus-agent start --dev
개발 모드(--dev)의 경우, 프론트엔드 코드를 별개의 Next.js 데브 서버(pnpm dev 보통 3000포트)로 띄워 백엔드와 연결할 때 주로 활용합니다.
시스템 버전 확인 및 업데이트
설치된 현재 버전을 확인하려면 다음 명령어를 사용합니다.
nexus-agent --version
최신 버전으로 업데이트하려면 (GitHub 토큰 인증이 되어 있어야 합니다)
nexus-agent update
특정 버전(예: v0.4.13) 지정 업데이트:
nexus-agent update v0.4.13
자, 이제 Nexus Agent Platform의 모든 기능을 활용할 준비가 끝났습니다! 다음 장부터 다양한 핵심 기능(Chat, Workspace, MCP 등)에 대해 살펴보세요.