py-gpt is an open-source ai agents skill for AI coding assistants such as Claude Code, Codex CLI, and ChatGPT, built by szczyglis-dev. Desktop AI Assistant powered by GPT-6, GPT-5, Gemini, Claude, Grok, Ollama, DeepSeek, Perplexity, and more - chat, agents, tools, MCP, plugins, RAG, vision, voice, image and video generation, speech synthesis and speech recognition, web search, memory, presets, canvas, assistants, themes, computer use. Windows, Linux, and Mac. It has 2,002 GitHub stars.

Is py-gpt safe to use?

Yes. py-gpt passed SkillsLLM's automated security scan — a dependency vulnerability audit plus prompt-injection heuristics — with no high-severity issues. You can read the full report in the Security Report section on this page.

How do I install py-gpt?

Clone the repository with "git clone https://github.com/szczyglis-dev/py-gpt" and add it to your Claude Code skills directory (see the Installation section above).

What programming language is py-gpt written in?

py-gpt is primarily written in Python. It is open-source under szczyglis-dev on GitHub, so you can review or fork the full source.

Are there alternatives to py-gpt?

Yes. SkillsLLM lists many other AI Agents skills you can browse and compare side by side. Open the AI Agents category from the badge at the top of this page, or use the Related Skills and comparison links further down to weigh py-gpt against similar tools.

PyGPT - Desktop AI Assistant

Name: py-gpt
Author: szczyglis-dev

Release: 2.9.1 | build: 2026-10-06 | Python: >=3.10, <3.14

Official website: pygpt.net | Documentation | Add-ons | Discord

Get it from: PyPi | Snap Store | Microsoft Store | AppImage

Prebuilt binaries for Linux and Windows: Download (64-bit)

Donate: Buy Me A Coffee | GitHub Sponsors | PayPal

Overview

PyGPT is an open-source desktop AI assistant for Linux, Windows and macOS. It supports models from OpenAI (GPT-6 Astra, GPT-5.6, GPT-4, etc.), Google Gemini, Anthropic Claude, xAI Grok, Perplexity / Sonar, DeepSeek, plus models available through HuggingFace, LlamaIndex, OpenAI-compatible APIs, and local Ollama installations such as DeepSeek, Qwen, gpt-oss, Gemma, Mistral, Llama, and others.

Beyond chat, PyGPT includes Agents with Chat, Orchestrator and Swarm workflows, Agent Skills, plugins and MCP connectors, RAG, files and attachments, Python/IPython and system tools, web search, vision and camera input, image and video generation, Computer use, realtime voice, speech input/output, memory, automation, and external integrations. Models can use local and remote tools, work with files, call APIs, and control the desktop or browser when enabled.

Screenshots (version 2.9.0, build 2026-10-04):

Dark theme: v2_main

Light theme: v2_light

Split-screen (dark theme): v2_main4

Split-screen (light theme): v2_light2

You can download compiled 64-bit versions for Windows and Linux here: https://pygpt.net/#download

Features

Desktop AI assistant for Linux, Windows and macOS, written in Python.
Runs as a local desktop application with a ChatGPT-like conversational interface.
Work modes include Chat, Agents, Realtime + audio, Research, Completion, Image and Video generation, Computer use, Experts, Autonomous mode, and Custom agents.
Supports OpenAI GPT-6 Astra, GPT-5.6, GPT-4, Google Gemini, Anthropic Claude, xAI Grok, DeepSeek V3/R1, Perplexity / Sonar, and models available through LlamaIndex and Ollama, including DeepSeek, Qwen, gpt-oss, Gemma, Mistral, Llama, and others.
Integrated LlamaIndex RAG for files, webpages, Google/GitHub data, media, images, conversation history, and formats such as txt, pdf, csv, html, md, docx, json, epub, xlsx, and xml.
Built-in vector-store support with automatic file, database-context, and data embedding.
Image generation with models such as gpt-image, Imagen, Gemini, and Nano Banana.
Video generation with models such as Veo3 and Sora2.
Web search via DuckDuckGo, Google, Microsoft Bing and remote web search.
Speech synthesis via OpenAI, Microsoft Azure, Google Cloud / GenAI, Eleven Labs, and xAI.
Speech recognition via OpenAI Whisper (API or local), Google / Google Cloud / GenAI, Microsoft Bing, and xAI Grok Voice.
Extensible plugin system with Filesystem, Python and OS, Web search, Google, Facebook, X/Twitter, Slack, Telegram, GitHub, MCP, and more.
Model Context Protocol (MCP) support.
Built-in MCP Connectors manager with catalog browsing and import from Claude, Codex, OpenClaw, Cursor, VS Code, OpenCode, MCPorter, and generic JSON/TOML/YAML configurations.
Agents multi-agent workflows with Chat, Orchestrator, and Swarm runtimes.
Optional project-specific .agents/ directory support for Agents and Custom agents.
Portable SKILL.md-based Agent Skills with GitHub/local import, catalog browsing, per-profile enable/disable, and on-demand loading.
Built-in Python/OS tool for real-time Python, IPython, and system command execution.
Built-in real-time Canvas with annotation support and web browser integration for interactive workflows.
Camera capture for real-time image input in Chat and other supported modes.
Image analysis with vision-capable models.
Accessibility features including keyboard shortcuts, voice control, and spoken descriptions of on-screen actions.
Conversation history with short- and long-term memory support.
Integrated calendar, day notes, and conversation search by date.
Tool and command execution through plugins, including filesystem, Python/OS, and system commands.
User-defined custom commands and scripts exposed as tools.
Built-in Crontab / Task scheduler.
File and attachment upload, download, organization, and processing.
Reopen and continue previous conversations, with optional advanced context handling for very long chats.
Editable prompt and model presets for reusable configurations.
Desktop UI designed for direct, practical use.
Built-in notepad.
Built-in painter / drawing tool.
Node-based Custom agent builder for designing Custom agents workflows.
Multi-language interface support.
No prior AI-model experience required.
Extensive configuration options.
Theme support.
Real-time code syntax highlighting.
Built-in token usage estimation and reporting.
Open source; source code is available on GitHub.
Uses the user's own provider API keys.
and many more.

PyGPT is free and open source. Cloud providers use your own API credentials; local models such as those served through Ollama do not require external API keys. Additional credentials may be required for specific providers and integrations.

Installation

Prebuilt binaries (Windows / Linux)

Download PyGPT

Prebuilt 64-bit packages are the simplest way to run PyGPT:

Windows 10/11: MSI installer.
Linux: prebuilt archive; requires GLIBC >= 2.35.
macOS: use the PyPI or source installation below.

Microsoft Store (Windows)

PyGPT is also available from Microsoft Store:

AppImage (Linux)

Download the latest AppImage from GitHub Releases

Make it executable before the first run:

chmod +x ./PyGPT-X.X.X-x86_64.AppImage

Optional incremental updates are available through AppImageUpdate:

appimageupdatetool ./PyGPT-X.X.X-x86_64.AppImage

Snap Store (Linux)

Install from Snap Store:

sudo snap install pygpt

Update an existing installation with:

sudo snap refresh pygpt

Optional Snap interfaces are required only for the corresponding features.

Camera:

sudo snap connect pygpt:camera

Microphone:

sudo snap connect pygpt:audio-record :audio-record
sudo snap connect pygpt:alsa

Audio output:

sudo snap connect pygpt:audio-playback
sudo snap connect pygpt:alsa

Docker sandbox:

sudo snap connect pygpt:docker-executables docker:docker-executables
sudo snap connect pygpt:docker docker:docker-daemon

PyPI (pip)

Requires Python >=3.10, <3.14. A virtual environment is recommended:

python3 -m venv venv
source venv/bin/activate

Install and run PyGPT:

pip install pygpt-net
pygpt

Running from GitHub source code

Clone the repository and install the requirements in a virtual environment:

git clone https://github.com/szczyglis-dev/py-gpt.git
cd py-gpt
python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt
python3 run.py

Poetry

Poetry can be used instead of pip:

git clone https://github.com/szczyglis-dev/py-gpt.git
cd py-gpt
pip install poetry
poetry env use python3.10
poetry shell
poetry install
poetry run python3 run.py

For Poetry >=2.0, activate the environment with:

poetry env use python3.10
poetry env activate

Tip: You can use PyInstaller to create a compiled version of the application (required version 6.4.0).

Troubleshooting

If you have a problems with xcb plugin with newer versions of PySide on Linux, e.g. like this:

qt.qpa.plugin: Could not load the Qt platform plugin "xcb" in "" even though it was found.
This application failed to start because no Qt platform plugin could be initialized. 
Reinstalling the application may fix this problem.

...then install libxcb:

sudo apt install libxcb-cursor0

If you have a problems with audio on Linux, then try to install portaudio19-dev and/or libasound2:

sudo apt install portaudio19-dev

sudo apt install libasound2
sudo apt install libasound2-data 
sudo apt install libasound2-plugins

Problems with GLIBC on Linux

If you encounter error:

Error loading Python lib libpython3.10.so.1.0: dlopen: /lib/x86_64-linux-gnu/libm.so.6: version GLIBC_2.35 not found (required by libpython3.10.so.1.0)

when trying to run the compiled version for Linux, try updating GLIBC to version

py-gpt

Compare with similar skills

Frequently Asked Questions

What is py-gpt?