pengy 1.0.0__tar.gz

pengy-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Pat Wendorf (dungeons@gmail.com)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

pengy-1.0.0/PKG-INFO

@@ -0,0 +1,230 @@
+Metadata-Version: 2.4
+Name: pengy
+Version: 1.0.0
+Summary: Local-first AI agent with tools — GUI and CLI
+Author-email: Pat Wendorf <dungeons@gmail.com>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/patw/pengy
+Project-URL: Repository, https://github.com/patw/pengy
+Project-URL: Bug Tracker, https://github.com/patw/pengy/issues
+Project-URL: Changelog, https://github.com/patw/pengy/releases
+Keywords: llm,ai-agent,openai,ollama,groq,vllm,openrouter,chat,cli,qt6,pyside6
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: X11 Applications :: Qt
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: openai>=1.0.0
+Requires-Dist: ddgs>=9.0.0
+Provides-Extra: gui
+Requires-Dist: PySide6>=6.6.0; extra == "gui"
+Requires-Dist: markdown>=3.5; extra == "gui"
+Requires-Dist: pygments>=2.17.0; extra == "gui"
+Provides-Extra: cli
+Requires-Dist: rich>=13.0.0; extra == "cli"
+Provides-Extra: all
+Requires-Dist: PySide6>=6.6.0; extra == "all"
+Requires-Dist: markdown>=3.5; extra == "all"
+Requires-Dist: pygments>=2.17.0; extra == "all"
+Requires-Dist: rich>=13.0.0; extra == "all"
+Dynamic: license-file
+
+# Pengy 🐧
+
+**A local-first AI agent with tools.** Desktop GUI **and** command-line — both backed by the same agent core, talking to any OpenAI-compatible API.
+
+[![PyPI - Version](https://img.shields.io/pypi/v/pengy)](https://pypi.org/project/pengy/)
+[![PyPI - Python Version](https://img.shields.io/pypi/pyversions/pengy)](https://pypi.org/project/pengy/)
+[![PyPI - License](https://img.shields.io/pypi/l/pengy)](https://github.com/patw/pengy/blob/main/LICENSE)
+
+---
+
+## What is Pengy?
+
+Pengy is an LLM agent that runs on your own machine. It connects to OpenAI, Ollama, vLLM, Groq, OpenRouter, or any local endpoint, and gives the model a set of tools to operate on your filesystem, run code, search the web, and fetch URLs — all with your approval.
+
+Two interfaces, one agent:
+
+| **🐧 Pengy Desktop** | **🐧 Pengy CLI** |
+|---|---|
+| Qt6 GUI with markdown rendering, multi-session sidebar, file attachments | Terminal REPL with slash commands, single-shot mode for scripting |
+
+Both share the same core — same tools, same chat history, same config. Use whichever fits your flow.
+
+---
+
+## Quick Start
+
+### Install
+
+```bash
+# Everything (GUI + CLI)
+pip install pengy[all]
+
+# CLI only
+pip install pengy[cli]
+
+# GUI only
+pip install pengy[gui]
+
+# Minimum (no GUI, no CLI — use as a library)
+pip install pengy
+```
+
+### Desktop GUI
+
+```bash
+pengy
+```
+
+### CLI (interactive)
+
+```bash
+pengy-cli
+```
+
+### CLI (single-shot)
+
+```bash
+pengy-cli "What is the capital of France?"
+pengy-cli "List all files in /tmp"
+```
+
+---
+
+## Features
+
+- **OpenAI-compatible** — Works with OpenAI, Ollama, vLLM, LM Studio, OpenRouter, Groq, or any local endpoint
+- **11 built-in tools** — Read, write, and edit files; run bash (with sudo support) and Python code; search the web and fetch URLs; explore directory trees and search codebases
+- **Agentic workflow** — The LLM can call multiple tools per turn, chaining them to accomplish complex tasks
+- **Tool confirmation** — Three modes: YOLO (All) skips all confirmations, Safe auto-approves read-only tools, None confirms everything
+- **Context management** — Elide old tool results to save context window space; configurable per-chat
+- **Token usage display** — See prompt/completion token counts after every turn (GUI sidebar + CLI footer)
+- **Model discovery** — Fetch available models from your endpoint with one click or `/models` command
+- **Multi-session** — Create, switch, and delete chat sessions; history saved locally as JSON
+- **File attachments** — GUI: attach files from the input bar; CLI: use `/attach <path>` or `@path` inline syntax
+- **Slash commands** (CLI) — `/new`, `/load`, `/models`, `/yolo`, `/model`, `/list`, `/delete`, `/attach`, `/compact`, and more
+- **Templated system message** — Auto-fills `{date}`, `{username}`, `{hostname}`, `{osinfo}` at send time
+- **Persistent config** — Settings and chat history live in `~/.config/pengy/`, shared between GUI and CLI
+
+---
+
+## Screenshot
+
+![Pengy Interface](screenshot.png)
+
+---
+
+## Configuration
+
+**Desktop:** Click ⚙ Settings in the sidebar.  
+**CLI:** Run `/config` to view, `/model <name>` to switch models.
+
+| Setting | Description |
+|---------|-------------|
+| Base URL | API endpoint (e.g. `http://localhost:11434/v1` for Ollama) |
+| API Key | Your API key (or anything for local endpoints) |
+| Model | Model name, e.g. `gpt-4o`, `llama3`, `gemma` |
+| System Message | Supports `{date}`, `{username}`, `{hostname}`, `{osinfo}` placeholders |
+| Tool Confirmation | YOLO (All) / Safe Only / None — controls which tools require approval |
+| UI Scale (GUI) | 75 / 100 / 125 / 200 % — takes effect on next launch |
+
+---
+
+## Tools
+
+Pengy gives the LLM these tools to operate on your machine:
+
+| Tool | Description |
+|------|-------------|
+| `read_file` / `read_multiple_files` | Read one or more files at once |
+| `write_file` | Write or overwrite a file |
+| `replace_in_file` | Targeted text replacement (safer than full rewrites) |
+| `run_bash` | Execute shell commands (configurable timeout; sudo password dialog) |
+| `run_python` | Execute Python code (uses the same interpreter/venv as Pengy) |
+| `web_search` | DuckDuckGo web search |
+| `download_file` | Download a URL to `~/Downloads/` |
+| `fetch_url` | Fetch a URL's text content into context |
+| `directory_tree` | Visual directory structure listing |
+| `search_content` | Regex search across files in a codebase |
+
+---
+
+## API Compatibility
+
+| Service | Base URL |
+|---------|----------|
+| OpenAI | `https://api.openai.com/v1` |
+| Ollama | `http://localhost:11434/v1` |
+| LM Studio | `http://localhost:1234/v1` |
+| vLLM | `http://localhost:8000/v1` |
+| OpenRouter | `https://openrouter.ai/api/v1` |
+| Groq | `https://api.groq.com/openai/v1` |
+
+---
+
+## Project Structure
+
+```
+pengy/
+├── main.py              # Desktop GUI entry point
+├── cli/
+│   └── main.py          # CLI entry point (interactive + single-shot)
+├── assets/
+│   └── icon.svg         # App icon
+├── core/
+│   ├── config.py        # Settings load/save + system message templating
+│   ├── chat_manager.py  # Chat session CRUD
+│   ├── llm_client.py    # API client (generator protocol for tool handling)
+│   └── tools.py         # Tool definitions and execution
+└── ui/
+    ├── main_window.py   # Main window; wires all signals
+    ├── chat_history.py  # Sidebar chat list + quick settings
+    ├── chat_view.py     # Markdown chat renderer
+    ├── chat_input.py    # Input field + file attachment
+    ├── chat_worker.py   # Background thread driving the LLM generator
+    └── settings_dialog.py  # Settings dialog
+```
+
+---
+
+## Development
+
+### Install from source
+
+```bash
+git clone https://github.com/patw/pengy.git
+cd pengy
+pip install -e ".[all]"
+```
+
+### Running tests
+
+```bash
+pip install -e ".[all]"
+python -m pytest tests/ -v
+```
+
+---
+
+## Dependencies
+
+| Package | Purpose |
+|---------|---------|
+| PySide6 | Qt6 GUI framework |
+| openai | OpenAI-compatible API client |
+| markdown | Markdown rendering |
+| pygments | Syntax highlighting |
+| ddgs | DuckDuckGo web search |
+| rich | CLI formatting (tables, panels, markdown) |

pengy-1.0.0/README.md

@@ -0,0 +1,188 @@
+# Pengy 🐧
+
+**A local-first AI agent with tools.** Desktop GUI **and** command-line — both backed by the same agent core, talking to any OpenAI-compatible API.
+
+[![PyPI - Version](https://img.shields.io/pypi/v/pengy)](https://pypi.org/project/pengy/)
+[![PyPI - Python Version](https://img.shields.io/pypi/pyversions/pengy)](https://pypi.org/project/pengy/)
+[![PyPI - License](https://img.shields.io/pypi/l/pengy)](https://github.com/patw/pengy/blob/main/LICENSE)
+
+---
+
+## What is Pengy?
+
+Pengy is an LLM agent that runs on your own machine. It connects to OpenAI, Ollama, vLLM, Groq, OpenRouter, or any local endpoint, and gives the model a set of tools to operate on your filesystem, run code, search the web, and fetch URLs — all with your approval.
+
+Two interfaces, one agent:
+
+| **🐧 Pengy Desktop** | **🐧 Pengy CLI** |
+|---|---|
+| Qt6 GUI with markdown rendering, multi-session sidebar, file attachments | Terminal REPL with slash commands, single-shot mode for scripting |
+
+Both share the same core — same tools, same chat history, same config. Use whichever fits your flow.
+
+---
+
+## Quick Start
+
+### Install
+
+```bash
+# Everything (GUI + CLI)
+pip install pengy[all]
+
+# CLI only
+pip install pengy[cli]
+
+# GUI only
+pip install pengy[gui]
+
+# Minimum (no GUI, no CLI — use as a library)
+pip install pengy
+```
+
+### Desktop GUI
+
+```bash
+pengy
+```
+
+### CLI (interactive)
+
+```bash
+pengy-cli
+```
+
+### CLI (single-shot)
+
+```bash
+pengy-cli "What is the capital of France?"
+pengy-cli "List all files in /tmp"
+```
+
+---
+
+## Features
+
+- **OpenAI-compatible** — Works with OpenAI, Ollama, vLLM, LM Studio, OpenRouter, Groq, or any local endpoint
+- **11 built-in tools** — Read, write, and edit files; run bash (with sudo support) and Python code; search the web and fetch URLs; explore directory trees and search codebases
+- **Agentic workflow** — The LLM can call multiple tools per turn, chaining them to accomplish complex tasks
+- **Tool confirmation** — Three modes: YOLO (All) skips all confirmations, Safe auto-approves read-only tools, None confirms everything
+- **Context management** — Elide old tool results to save context window space; configurable per-chat
+- **Token usage display** — See prompt/completion token counts after every turn (GUI sidebar + CLI footer)
+- **Model discovery** — Fetch available models from your endpoint with one click or `/models` command
+- **Multi-session** — Create, switch, and delete chat sessions; history saved locally as JSON
+- **File attachments** — GUI: attach files from the input bar; CLI: use `/attach <path>` or `@path` inline syntax
+- **Slash commands** (CLI) — `/new`, `/load`, `/models`, `/yolo`, `/model`, `/list`, `/delete`, `/attach`, `/compact`, and more
+- **Templated system message** — Auto-fills `{date}`, `{username}`, `{hostname}`, `{osinfo}` at send time
+- **Persistent config** — Settings and chat history live in `~/.config/pengy/`, shared between GUI and CLI
+
+---
+
+## Screenshot
+
+![Pengy Interface](screenshot.png)
+
+---
+
+## Configuration
+
+**Desktop:** Click ⚙ Settings in the sidebar.  
+**CLI:** Run `/config` to view, `/model <name>` to switch models.
+
+| Setting | Description |
+|---------|-------------|
+| Base URL | API endpoint (e.g. `http://localhost:11434/v1` for Ollama) |
+| API Key | Your API key (or anything for local endpoints) |
+| Model | Model name, e.g. `gpt-4o`, `llama3`, `gemma` |
+| System Message | Supports `{date}`, `{username}`, `{hostname}`, `{osinfo}` placeholders |
+| Tool Confirmation | YOLO (All) / Safe Only / None — controls which tools require approval |
+| UI Scale (GUI) | 75 / 100 / 125 / 200 % — takes effect on next launch |
+
+---
+
+## Tools
+
+Pengy gives the LLM these tools to operate on your machine:
+
+| Tool | Description |
+|------|-------------|
+| `read_file` / `read_multiple_files` | Read one or more files at once |
+| `write_file` | Write or overwrite a file |
+| `replace_in_file` | Targeted text replacement (safer than full rewrites) |
+| `run_bash` | Execute shell commands (configurable timeout; sudo password dialog) |
+| `run_python` | Execute Python code (uses the same interpreter/venv as Pengy) |
+| `web_search` | DuckDuckGo web search |
+| `download_file` | Download a URL to `~/Downloads/` |
+| `fetch_url` | Fetch a URL's text content into context |
+| `directory_tree` | Visual directory structure listing |
+| `search_content` | Regex search across files in a codebase |
+
+---
+
+## API Compatibility
+
+| Service | Base URL |
+|---------|----------|
+| OpenAI | `https://api.openai.com/v1` |
+| Ollama | `http://localhost:11434/v1` |
+| LM Studio | `http://localhost:1234/v1` |
+| vLLM | `http://localhost:8000/v1` |
+| OpenRouter | `https://openrouter.ai/api/v1` |
+| Groq | `https://api.groq.com/openai/v1` |
+
+---
+
+## Project Structure
+
+```
+pengy/
+├── main.py              # Desktop GUI entry point
+├── cli/
+│   └── main.py          # CLI entry point (interactive + single-shot)
+├── assets/
+│   └── icon.svg         # App icon
+├── core/
+│   ├── config.py        # Settings load/save + system message templating
+│   ├── chat_manager.py  # Chat session CRUD
+│   ├── llm_client.py    # API client (generator protocol for tool handling)
+│   └── tools.py         # Tool definitions and execution
+└── ui/
+    ├── main_window.py   # Main window; wires all signals
+    ├── chat_history.py  # Sidebar chat list + quick settings
+    ├── chat_view.py     # Markdown chat renderer
+    ├── chat_input.py    # Input field + file attachment
+    ├── chat_worker.py   # Background thread driving the LLM generator
+    └── settings_dialog.py  # Settings dialog
+```
+
+---
+
+## Development
+
+### Install from source
+
+```bash
+git clone https://github.com/patw/pengy.git
+cd pengy
+pip install -e ".[all]"
+```
+
+### Running tests
+
+```bash
+pip install -e ".[all]"
+python -m pytest tests/ -v
+```
+
+---
+
+## Dependencies
+
+| Package | Purpose |
+|---------|---------|
+| PySide6 | Qt6 GUI framework |
+| openai | OpenAI-compatible API client |
+| markdown | Markdown rendering |
+| pygments | Syntax highlighting |
+| ddgs | DuckDuckGo web search |
+| rich | CLI formatting (tables, panels, markdown) |

pengy-1.0.0/pengy/assets/icon.svg

@@ -0,0 +1,25 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64">
+  <!-- Blue background pill -->
+  <circle cx="32" cy="32" r="32" fill="#4a90d9"/>
+  <!-- Body -->
+  <ellipse cx="32" cy="46" rx="15" ry="15" fill="#1a1a2e"/>
+  <!-- Belly -->
+  <ellipse cx="32" cy="49" rx="9" ry="9" fill="#f0f0f0"/>
+  <!-- Head -->
+  <circle cx="32" cy="23" r="13" fill="#1a1a2e"/>
+  <!-- White face patch -->
+  <ellipse cx="32" cy="25" rx="7.5" ry="8.5" fill="#f0f0f0"/>
+  <!-- Eyes -->
+  <circle cx="28.5" cy="21" r="2.2" fill="#1a1a2e"/>
+  <circle cx="35.5" cy="21" r="2.2" fill="#1a1a2e"/>
+  <circle cx="29.1" cy="20.4" r="0.7" fill="white"/>
+  <circle cx="36.1" cy="20.4" r="0.7" fill="white"/>
+  <!-- Beak -->
+  <path d="M 29 25.5 Q 32 30 35 25.5 Z" fill="#f5a623"/>
+  <!-- Wings -->
+  <ellipse cx="17" cy="46" rx="5" ry="12" fill="#1a1a2e" transform="rotate(-18 17 46)"/>
+  <ellipse cx="47" cy="46" rx="5" ry="12" fill="#1a1a2e" transform="rotate(18 47 46)"/>
+  <!-- Feet -->
+  <ellipse cx="27" cy="60" rx="6" ry="2.5" fill="#f5a623"/>
+  <ellipse cx="37" cy="60" rx="6" ry="2.5" fill="#f5a623"/>
+</svg>

pengy-1.0.0/pengy/cli/__init__.py

@@ -0,0 +1 @@
+"""Pengy CLI - command-line interface."""