WebUI·터미널·채팅앱에서 실행하는 오픈소스 AI 에이전트 프레임워크
중간맛 분석
WebUI, 터미널, 여러 채팅 채널에서 대화형 AI 에이전트를 운영하는 Python 프레임워크입니다. 사용자 메시지를 입력하면 에이전트는 도구(파일 편집, 웹 검색, MCP 호출, 셸 명령 실행)를 작동시키고, 대화 맥락과 Dream이라 불리는 장기 메모리를 유지하며 응답을 생성합니다. 설치 후 'nanobot webui' 한 명령으로 브라우저 UI가 자동으로 열리고, Settings → Models에서 모델을 설정한 뒤 바로 사용할 수 있습니다. 한 줄 설치(macOS/Linux/Windows), uv, pip, 소스 클론 등 다양한 방식을 지원하며, Render 클릭 배포나 자체호스팅, Linux 서비스 등록도 가능합니다.
이런 레포예요
이럴 때 쓰면 좋아요
- 팀이 Slack이나 Discord 채널에서 AI 에이전트와 협업하여 대화 이력과 메모리를 지속적으로 유지하며 장기 프로젝트 진행
- 개발자가 로컬 서버에 에이전트를 설치해서 웹 검색, 파일 편집, 셸 명령 실행을 자동화
- 사용자가 WebUI에서 여러 대화 주제별로 프로젝트를 분리 관리하면서 각각의 맥락과 메모리 유지
핵심 기능
대안 대비 차별점
작고 읽기 쉬운 코어로 MCP, 장기 메모리, 자동화를 내장하면서도 WebUI와 여러 채팅 채널을 동시에 지원하는 오픈소스 자체호스팅 프레임워크
먹어본 사람들
실제로 차려 먹어본 손님들의 흔적이에요 — 한마디와 완주 인증 모두 검수 후 공개돼요.
이 레포, 해먹는 법
처음 오셨어요? 어렵지 않아요 — 위에서 아래로 따라 하면 내 컴퓨터에 이 레포를 차려서 바로 맛볼 수 있어요.
준비물
- Python 3.11 이상
- 모델 제공자의 API 키
바로 차려먹기Python (uv)
깃밥이 레포 구조를 확인하고 만든 실행 명령이에요. 터미널에 붙여넣으면 받기부터 실행까지 한 번에 진행돼요.
git clone --depth 1 https://github.com/HKUDS/nanobot.git && cd nanobot && uv sync
uv가 없다면: brew install uv · 실행 명령은 README를 확인하세요.
코드는 내 컴퓨터에서 실행돼요 — 처음 보는 레포라면 내용을 한번 훑어보고 실행하는 습관을 추천해요.
README가 안내하는 자세한 단계 보기
- 설치 방법을 선택해서 실행합니다(이하 중 하나).
macOS/Linux:
curl -fsSL https://raw.githubusercontent.com/HKUDS/nanobot/main/scripts/install.sh | sh
또는 Windows PowerShell:
irm https://raw.githubusercontent.com/HKUDS/nanobot/main/scripts/install.ps1 | iex
또는 uv:
uv tool install nanobot-ai
또는 pip:
python -m pip install nanobot-ai
또는 소스에서 설치:
git clone https://github.com/HKUDS/nanobot.git
cd nanobot
python -m venv .venv
가상환경 활성화(macOS/Linux):
source .venv/bin/activate
Windows PowerShell:
.venv\Scripts\Activate.ps1
의존성 설치:
python -m pip install -e .
- 브라우저에서 WebUI를 실행합니다.
nanobot webui
-
브라우저 Settings → Models에서 모델 제공자와 API 자격증명을 설정합니다.
-
새로운 주제를 만들고 "Hello!"를 입력해서 연결을 확인합니다.
-
(선택사항) 백그라운드에서 에이전트를 계속 실행:
nanobot gateway --background
- (선택사항) 터미널 UI에서만 사용:
nanobot
깃밥트라이로 맛보기
받아보기 귀찮고 살짝 불안했다면 — 안전 스캔부터 설치까지 터미널 한 줄로 끝나요.
터미널에 붙여넣으면 깃밥 안전 스캔 → 격리 폴더 clone → 설치 → 실행법 안내까지 자동이에요. 처음이어도 괜찮아요 — 이 한 줄이 전부예요.
npx gitbap-try HKUDS/nanobot
Node.js만 있으면 설치 없이 실행돼요 · 깃밥트라이가 뭐예요? →
이걸로 써먹는 법
맛봤다면 이제 써먹을 차례 — 이 레포를 내 일과 사업에 응용하는 방법을 모아뒀어요.
🍳 레시피 — AI에게 이대로 시켜보세요
레시피 불러오는 중…
별 추이 · 7일
확인 시각
활용성 · 따라 만들기 좋은가
- 관대한 라이선스
- 테스트 있음
- 예제 디렉토리
- 최근 활동
- AGENTS.md
- llms.txt
- 템플릿
🟢 최근 활동 있음 · 2026년 생성
「AI 에이전트」 이런 레포, 매주 받아보실래요?
매주 월요일 아침, 골라 담은 밥상만. 광고 없이 · 언제든 해지.
내 레포인가요? README에 깃밥 배지 달기
[](https://www.gitbap.com/r/HKUDS/nanobot)🔌 클로드에서 바로 써보기 — 깃밥 연결하는 법
깃밥을 클로드에 연결하면 이런 레포를 클로드·커서·Codex에서 바로 찾고 체험할 수 있어요.
클로드 설정 → 커넥터에 이 주소를 붙여넣기.
https://www.gitbap.com/api/mcp플러그인을 설치하면 /gitbap-trending·/gitbap-try 슬래시 커맨드로 레포를 그 자리에서 체험. Claude Code에서 아래 두 줄을 차례로 실행하세요.
/plugin marketplace add jakeparkcolde/gitbap-cowork/plugin install gitbap-cowork@gitbapAI가 README 기반으로 요약했습니다 · 원문 보기