py-gpt

Name: py-gpt
Author: szczyglis-dev

Verified

Desktop AI Assistant powered by GPT-5, GPT-4, o1, o3, Gemini, Claude, Ollama, DeepSeek, Perplexity, Grok, Bielik, chat, vision, voice, RAG, image and video generation, agents, tools, MCP, plugins, speech synthesis and recognition, web search, memory, presets, assistants,and more. Linux, Windows, Mac

1,906stars

343forks

Python

Installation

# Add to your Claude Code skills
git clone https://github.com/szczyglis-dev/py-gpt

Getting Started

Guides for using ai agents skills like py-gpt.

Security ReportVerified

Last scanned: 4/26/2026

{
  "issues": [],
  "status": "PASSED",
  "scannedAt": "2026-04-26T06:09:07.213Z",
  "semgrepRan": false,
  "npmAuditRan": true,
  "pipAuditRan": false
}

README.md

Frequently Asked Questions

What is py-gpt?

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-5, GPT-4, o1, o3, Gemini, Claude, Ollama, DeepSeek, Perplexity, Grok, Bielik, chat, vision, voice, RAG, image and video generation, agents, tools, MCP, plugins, speech synthesis and recognition, web search, memory, presets, assistants,and more. Linux, Windows, Mac. It has 1,906 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.

Agentic AI for Beginners

Build your first AI agent from scratch - tool use, ReAct pattern, memory, deployment

41 minBeginner

Comments (0)

to leave a comment.

No comments yet. Be the first to share your thoughts!

Related Skills

ECC

by affaan-m

The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.

255,402

DemoGPT nezha

⚠️ Third-Party Software Notice

This skill is third-party open-source software developed and hosted independently on GitHub. SkillsLLM is an informational directory and does not control or maintain the underlying repository.

Any security checks, ratings, or warnings displayed by SkillsLLM are automated and limited in scope. They do not constitute a security certification or guarantee that the software is safe, error-free, or free from malicious code, vulnerabilities, compromised dependencies, or prompt-injection risks.

Review the source code, permissions, dependencies, and configuration before installing or running any third-party skill. Use is at your own risk. To the maximum extent permitted by applicable law, SkillsLLM is not liable for losses arising from third-party software.

Read the Terms of Service

PyGPT - Desktop AI Assistant

Release: 2.8.13 | build: 2026-09-09 | Python: >=3.10, <3.14

Official website: https://pygpt.net | Documentation | Discord

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

Compiled version for Linux and Windows: Download (64bit)

Donate: Buy Me A Coffee | GitHub Sponsors | PayPal

Overview

PyGPT is an all-in-one desktop AI assistant supporting models from OpenAI (GPT-6 Astra, GPT-5.6, GPT-4, o1, o3), Google Gemini, Anthropic Claude, xAI Grok, Perplexity / Sonar, DeepSeek, and models available through HuggingFace, LlamaIndex, OpenAI-compatible APIs, and local Ollama installations such as Gemma 4, Qwen 3.6, Llama 4, Mistral Small 3.2, DeepSeek, Bielik, Nemotron, and gpt-oss.

It supports chat, Agents v2 (beta) and other agent workflows, completions, Chat with Files (via LlamaIndex), image and video generation, and image analysis. Models can work with files, run Python and system or custom commands, transfer files, call external APIs, and search the web with DuckDuckGo, Google and Microsoft Bing.

PyGPT also provides speech synthesis through OpenAI, Microsoft Azure, Google Cloud / GenAI, Eleven Labs and xAI, plus speech recognition with OpenAI Whisper (API or local), Google / Google Cloud / GenAI, Bing and xAI Grok Voice. It stores conversation history and memory, supports reusable presets, and can be extended with built-in or custom plugins for tools, automation and external integrations.

Showcase (mp4, version 2.8.3, build 2026-08-16):

https://github.com/user-attachments/assets/22972e34-dc9f-451d-ae64-23a91e945e97

Screenshots (version 2.8.4, build 2026-08-16):

Dark theme: v2_main

Light theme: v2_light

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

Features

Desktop AI Assistant for Linux, Windows and Mac, written in Python.
Works similarly to ChatGPT, but locally (on a desktop computer).
11 modes of operation: Chat, Chat with Files, Realtime + audio, Research (Perplexity), Completion, Image and Video generation, Experts, Computer use, Agents v2 (beta), Agents and Autonomous Mode.
Supports multiple models like OpenAI GPT-6 Astra, GPT-5.6, GPT-4, o1, o3, o4, Google Gemini, Anthropic Claude, xAI Grok, DeepSeek V3/R1, Perplexity / Sonar, and any model accessible through LlamaIndex and Ollama such as Gemma 4, Qwen 3.6, Llama 4, Mistral Small 3.2, DeepSeek, Bielik, Nemotron, gpt-oss, etc.
Chat with your own Files: integrated LlamaIndex support: chat with data such as: txt, pdf, csv, html, md, docx, json, epub, xlsx, xml, webpages, Google, GitHub, video/audio, images and other data types, or use conversation history as additional context provided to the model.
Built-in vector databases support and automated files and data embedding.
Image generation via models like gpt-image, Imagen, Gemini, and Nano Banana.
Video generation via models like Veo3 and Sora2.
Internet access via DuckDuckGo, Google and Microsoft Bing.
Speech synthesis via OpenAI, Microsoft Azure, Google Cloud / GenAI, Eleven Labs and xAI Text-To-Speech services.
Speech recognition via OpenAI Whisper (API or local), Google / Google Cloud / GenAI, Microsoft Bing and xAI Grok Voice.
Plugins support with built-in plugins like Files I/O, Code Interpreter, Web Search, Google, Facebook, X/Twitter, Slack, Telegram, GitHub, MCP, and many more.
MCP support.
Camera capture for real-time image analysis in Chat and other supported modes.
Image analysis via vision models.
Included support features for individuals with disabilities: customizable keyboard shortcuts, voice control, and translation of on-screen actions into audio via speech synthesis.
Handles and stores the full context of conversations (short and long-term memory).
Integrated calendar, day notes and search in contexts by selected date.
Tools and commands execution (via plugins: access to the local filesystem, Python/OS, system commands execution, and more).
Custom commands creation and execution.
Crontab / Task scheduler included.
Built-in Python/OS tool with real-time Python / IPython execution.
Manages files and attachments with options to upload, download, and organize.
Context history with the capability to revert to previous contexts (long-term memory).
Allows you to easily manage prompts with handy editable presets.
Provides an intuitive operation and interface.
Includes a notepad.
Includes simple painter / drawing tool.
Includes an node-based Agents Builder.
Includes Agents v2 (beta), an advanced orchestrated multi-agent mode with a user-facing Orchestrator and dynamically managed worker agents.
Supports multiple languages.
Requires no previous knowledge of using AI models.
Fully configurable.
Themes support.
Real-time code syntax highlighting.
Built-in token usage calculation.
Open source; source code is available on GitHub.
Utilizes the user's own API key.
and many more.

The application is free, open-source, and runs on PCs with Linux, Windows 10, Windows 11 and Mac. Full Python source code is available on GitHub.

PyGPT uses your own API credentials to connect to supported AI providers such as OpenAI, Google, Anthropic, xAI, Perplexity, Mistral, OpenRouter, and others. Depending on the selected model and provider, you may need an account and a valid API key for that service. Local models do not require external API credentials. You can also use built-it LlamaIndex support to connect to other Large Language Models (LLMs), such as those on HuggingFace. Additional API keys may be required.

Installation

Binaries (Linux, Windows 10 and 11)

You can download compiled binary versions for Linux and Windows (10/11).

PyGPT binaries require a PC with Windows 10, 11, or Linux. Simply download the installer or the archive with the appropriate version from the download page at https://pygpt.net, extract it, or install it, and then run the application. A binary version for Mac is not available, so you must run PyGPT from PyPi or from the source code on Mac. Currently, only 64-bit binaries are available.

Linux version requires GLIBC >= 2.35.

Microsoft Store (Windows)

For Windows 10/11, you can install PyGPT directly from Microsoft Store:

Link to MS Store: https://apps.microsoft.com/detail/XP99R4MX3X65VQ

AppImage (Linux)

You can download the latest PyGPT AppImage for Linux from the release page:

Releases: https://github.com/szczyglis-dev/py-gpt/releases

Tip: Remember to give execution permissions to the downloaded file:

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

To manage future updates you can use AppImageUpdate tool:

You can download it from: https://github.com/AppImage/AppImageUpdate/releases

After downloading, run the following command in terminal:

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

Snap Store (Linux)

You can install PyGPT directly from Snap Store:

sudo snap install pygpt

To manage future updates use:

sudo snap refresh pygpt

Using camera: to use camera in Snap version you must connect the camera with:

sudo snap connect pygpt:camera

Using microphone: to use microphone in Snap version you must connect the microphone with:

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

Using audio output: to use audio output in Snap version you must connect the audio with:

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

Connecting IPython in Docker in Snap version:

To use IPython in the Snap version, you must connect PyGPT to the Docker daemon:

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

sudo snap connect pygpt:docker docker:docker-daemon

PyPi (pip)

The application can also be installed from PyPi using pip install:

Create virtual environment:

python3 -m venv venv
source venv/bin/activate

Install from PyPi:

pip install pygpt-net

Once installed run the command to start the application:

pygpt

Running from GitHub source code

An alternative method is to download the source code from GitHub and execute the application using the Python interpreter (>=3.10, <3.14).

Install with pip

Clone git repository or download .zip file:

git clone https://github.com/szczyglis-dev/py-gpt.git
cd py-gpt

Create a new virtual environment:

python3 -m venv venv
source venv/bin/activate

Install requirements:

pip install -r requirements.txt

Run the application:

python3 run.py