szczyglis-dev/py-gpt

어떤 프로젝트인가요?

핵심 기능

• 01ChatGPT 스타일의 채팅 인터페이스를 갖춘 Linux, Windows, macOS용 로컬 데스크톱 앱으로 실행됩니다.
• 02OpenAI, Gemini, Claude, Grok, Perplexity/Sonar, DeepSeek와 Ollama 및 OpenAI 호환 엔드포인트에 연결합니다.
• 03Agents 모드에서 작업자 및 반복 횟수 제한을 설정해 Chat, Orchestrator, Swarm 멀티 에이전트 워크플로를 사용할 수 있습니다.
• 04LlamaIndex RAG로 txt, pdf, csv, html, md, docx, json, epub, xlsx, xml 등의 형식으로 된 파일, 웹 페이지, 미디어를 색인합니다.
• 05플러그인 시스템과 MCP 커넥터를 통해 파일 시스템, Python/OS, 웹 검색, Google, GitHub, Slack, Telegram 등의 도구를 추가합니다.
• 06OpenAI Realtime, Gemini Live, Grok을 지원하는 실시간 음성 모드와 VAD 기반 자동 발화 처리를 제공합니다.
• 07gpt-image, Imagen, Gemini, Nano Banana, Veo, Sora 등의 모델로 이미지와 동영상을 생성합니다.
• 08마우스와 키보드 입력을 사용해 데스크톱이나 Playwright 브라우저 샌드박스를 제어할 수 있습니다.

활용 사례

• API 키를 직접 입력해 하나의 데스크톱 클라이언트에서 여러 클라우드 모델이나 로컬 모델과 대화하기.
• Orchestrator 또는 Swarm 에이전트 워크플로에 여러 단계로 이루어진 코딩이나 조사 작업 맡기기.
• 프롬프트에 텍스트를 붙여 넣는 대신 로컬 RAG 색인을 통해 내부 문서와 PDF에 질의하기.
• 내장 도구를 통해 채팅에서 Python, IPython, 시스템 명령 실행하기.
• 하나의 앱에서 음성 대화, 카메라 입력, 이미지 또는 동영상 생성 활용하기.

빠른 시작

1. 1

   PyPI에서 PyGPT 설치

   pip install pygpt-net
2. 2

   PyGPT 실행

   pygpt
3. 3

   Config -> Settings -> API Keys에서 API 키 추가(로컬 모델에서는 필요하지 않음)

사용 전 알아둘 점

• !클라우드 모델을 사용하려면 각 제공업체의 API 키가 필요합니다.
• !Linux 사전 빌드 바이너리에는 GLIBC 2.35 이상이 필요합니다.
• !라이선스가 NOASSERTION으로 표시되어 있으므로 재사용하기 전에 저장소의 라이선스를 확인하세요.

포함된 컬렉션

토픽

자주 묻는 질문

py-gpt은(는) 무엇인가요?

클라우드 및 로컬 모델, 에이전트, RAG, 플러그인, MCP, 음성을 지원하는 크로스 플랫폼 데스크톱 AI 어시스턴트입니다. PyGPT는 Linux, Windows, macOS에서 사용할 수 있는 Python 기반 오픈소스 데스크톱 AI 어시스턴트로, ChatGPT와 비슷한 대화형 인터페이스를 제공합니다. OpenAI, Google Gemini, Anthropic Claude, xAI Grok, Perplexity/Sonar, DeepSeek의 클라우드 모델은 물론 Ollama 또는 OpenAI 호환 엔드포인트를 통해 로컬 모델이나 자체 호스팅 모델과도 대화할 수 있습니다. 사용자는 각 제공업체의 API 키를 직접 입력해야 하며, 로컬 모델은 API 키가 필요하지 않습니다.

py-gpt은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

py-gpt은(는) Other 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

py-gpt은(는) 아직 유지보수되고 있나요?

6개월 이내 업데이트. py-gpt의 마지막 커밋은 2026년 10월 6일입니다.

py-gpt은(는) 어디에 사용할 수 있나요?

API 키를 직접 입력해 하나의 데스크톱 클라이언트에서 여러 클라우드 모델이나 로컬 모델과 대화하기. Orchestrator 또는 Swarm 에이전트 워크플로에 여러 단계로 이루어진 코딩이나 조사 작업 맡기기. 프롬프트에 텍스트를 붙여 넣는 대신 로컬 RAG 색인을 통해 내부 문서와 PDF에 질의하기. 내장 도구를 통해 채팅에서 Python, IPython, 시스템 명령 실행하기. 하나의 앱에서 음성 대화, 카메라 입력, 이미지 또는 동영상 생성 활용하기.

py-gpt는 어떻게 설치하나요?

PyPI에서 PyGPT 설치: pip install pygpt-net PyGPT 실행: pygpt Config -> Settings -> API Keys에서 API 키 추가(로컬 모델에서는 필요하지 않음)

py-gpt은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/szczyglis-dev/py-gpt