Python 기반의 초경량 개인 AI 에이전트 프레임워크로, WebUI, 채팅 채널, 도구, 메모리, MCP 등을 갖춘 완전한 에이전트를 구축할 수 있습니다.
중간맛 분석
라이선스의 오픈소스 Python 에이전트 프레임워크입니다. OpenAI, Claude, Gemini 등 주요 LLM 제공자 지원, 내장 WebUI, Telegram/Discord/Slack/WeChat 등 다중 채팅 채널 통합, MCP(Model Context Protocol) 지원, 메모리 관리, 자동화 및 스케줄링 기능을 포함합니다. 난이도는 중상(3~4/5)이며, 설치 후 즉시 로 시작할 수 있고 WebUI를 통해 시각적으로 관리할 수 있습니다.
이런 레포예요
이럴 때 쓰면 좋아요
- Telegram, Discord, Slack, WeChat 등 메시징 앱에서 실시간으로 동작하는 개인 AI 어시스턴트 구축
- 장기 목표(/goal 명령)를 유지하면서 여러 턴에 걸쳐 복잡한 작업을 자동화
- 웹 검색, 파일 처리, 코드 실행 등 다양한 도구를 통합한 멀티모달 에이전트 구현
핵심 기능
대안 대비 차별점
litellm을 제거하고 공식 LLM SDK를 직접 사용하여 성능과 안정성을 높였으며, 모든 채팅 플랫폼에서 세션이 통합되어 일관된 에이전트 경험을 제공합니다.
먹어본 사람들
실제로 차려 먹어본 손님들의 흔적이에요 — 한마디와 완주 인증 모두 검수 후 공개돼요.
이 레포, 해먹는 법
처음 오셨어요? 어렵지 않아요 — 위에서 아래로 따라 하면 내 컴퓨터에 이 레포를 차려서 바로 맛볼 수 있어요.
준비물
- Python 3.11 이상
- API 키(OpenAI, Claude, Gemini 등 지원 제공자 중 선택)
바로 차려먹기Python (uv)
깃밥이 레포 구조를 확인하고 만든 실행 명령이에요. 터미널에 붙여넣으면 받기부터 실행까지 한 번에 진행돼요.
git clone --depth 1 https://github.com/HKUDS/nanobot.git && cd nanobot && uv sync
uv가 없다면: brew install uv · 실행 명령은 README를 확인하세요.
코드는 내 컴퓨터에서 실행돼요 — 처음 보는 레포라면 내용을 한번 훑어보고 실행하는 습관을 추천해요.
README가 안내하는 자세한 단계 보기
- 설치합니다(macOS/Linux용 한 줄 설치 또는 pip 사용):
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
- 설치를 확인합니다:
nanobot --version
- 초기화하거나 대화형 설정을 실행합니다:
nanobot onboard --wizard
- ~/.nanobot/config.json을 편집하여 API 키와 모델을 설정합니다:
{
"providers": {
"custom": {
"apiKey": "your-api-key",
"apiBase": "https://api.example.com/v1"
}
},
"modelPresets": {
"primary": {
"label": "Primary",
"provider": "custom",
"model": "model-id-from-your-provider",
"maxTokens": 8192,
"contextWindowTokens": 200000,
"temperature": 0.1
}
},
"agents": {
"defaults": {
"modelPreset": "primary"
}
}
}
-
첫 CLI 응답을 확인합니다(설정 후 대화 입력 테스트).
-
WebUI를 엽니다(일반적으로 브라우저에서 자동 시작되거나 http://localhost:8000 접속).
깃밥트라이로 맛보기
받아보기 귀찮고 살짝 불안했다면 — 안전 스캔부터 설치까지 터미널 한 줄로 끝나요.
터미널에 붙여넣으면 깃밥 안전 스캔 → 격리 폴더 clone → 설치 → 실행법 안내까지 자동이에요. 처음이어도 괜찮아요 — 이 한 줄이 전부예요.
npx gitbap-try HKUDS/nanobot
Node.js만 있으면 설치 없이 실행돼요 · 깃밥트라이가 뭐예요? →
별 추이 · 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 기반으로 요약했습니다 · 원문 보기