abstractassistant 0.3.1__tar.gz → 0.3.3__tar.gz

abstractassistant-0.3.3/ACKNOWLEDGMENTS.md

@@ -0,0 +1,164 @@
+# Acknowledgments
+
+AbstractAssistant would not be possible without the incredible work of the open-source community and the following libraries and projects:
+
+## Core Foundation
+
+### [AbstractCore](https://www.abstractcore.ai/)
+**The heart of AbstractAssistant's multi-provider LLM support**
+
+AbstractCore provides the universal interface that makes it possible to seamlessly switch between different AI providers. Without AbstractCore, this project would require implementing separate integrations for each LLM provider.
+
+- **What it provides**: Universal LLM interface, provider discovery, model management, session handling
+- **Why it's essential**: Enables support for 6+ LLM providers and 100+ models through a single, consistent API
+- **License**: MIT License
+- **Repository**: [AbstractCore on GitHub](https://github.com/lpalbou/abstractcore)
+
+*Special thanks to the AbstractCore team for creating such a robust and extensible foundation for AI applications.*
+
+## Voice and Audio
+
+### [AbstractVoice](https://github.com/lpalbou/abstractvoice)
+**High-quality Text-to-Speech integration**
+
+AbstractVoice provides the conversational AI capabilities that make AbstractAssistant truly interactive. The VITS model integration delivers natural-sounding speech synthesis.
+
+- **What it provides**: TTS engine, voice activity detection, speech-to-text capabilities
+- **Features used**: Text-to-speech with speed control, model fallbacks, threading support
+- **License**: MIT License
+
+### [Coqui TTS](https://github.com/coqui-ai/TTS)
+**Advanced Text-to-Speech engine**
+
+The underlying TTS engine that powers AbstractVoice's high-quality speech synthesis.
+
+- **What it provides**: Neural text-to-speech models, voice cloning, multilingual support
+- **License**: MPL 2.0 License
+
+### [OpenAI Whisper](https://github.com/openai/whisper)
+**Robust automatic speech recognition**
+
+Used by AbstractVoice for potential future speech-to-text features.
+
+- **What it provides**: Multilingual speech recognition, robust audio processing
+- **License**: MIT License
+
+### [PyAudio](https://people.csail.mit.edu/hubert/pyaudio/)
+**Cross-platform audio I/O**
+
+Enables audio input/output for voice features.
+
+- **What it provides**: Audio stream handling, cross-platform audio support
+- **License**: MIT License
+
+## User Interface
+
+### [Qt Framework](https://www.qt.io/) (PyQt5/PySide2/PyQt6)
+**Modern, native GUI framework**
+
+Qt provides the foundation for AbstractAssistant's sleek, native-feeling interface. The automatic detection of PyQt5, PySide2, or PyQt6 ensures compatibility across different environments.
+
+- **What it provides**: Native GUI widgets, cross-platform compatibility, modern styling
+- **Features used**: Custom widgets, layouts, styling, threading, event handling
+- **License**: 
+  - PyQt5/PyQt6: GPL v3 / Commercial License
+  - PySide2/PySide6: LGPL v3 / Commercial License
+
+### [pystray](https://github.com/moses-palmer/pystray)
+**Cross-platform system tray support**
+
+Enables AbstractAssistant to live in the macOS menu bar with native integration.
+
+- **What it provides**: System tray icon management, context menus, click handling
+- **License**: LGPL v3 License
+
+## Image Processing
+
+### [Pillow (PIL Fork)](https://python-pillow.org/)
+**Powerful image processing library**
+
+Used for dynamic system tray icon generation with animations and status indicators.
+
+- **What it provides**: Image creation, manipulation, format support
+- **Features used**: Dynamic icon generation, image compositing, color manipulation
+- **License**: HPND License
+
+## Utilities and Support
+
+### [pyperclip](https://github.com/asweigart/pyperclip)
+**Cross-platform clipboard operations**
+
+Enables copy-to-clipboard functionality for AI responses.
+
+- **What it provides**: Clipboard read/write operations
+- **License**: BSD 3-Clause License
+
+### [plyer](https://github.com/kivy/plyer)
+**Cross-platform native features**
+
+Provides access to platform-specific notification systems.
+
+- **What it provides**: Native notifications, platform abstraction
+- **License**: MIT License
+
+### [markdown](https://python-markdown.github.io/)
+**Markdown processing**
+
+Enables rich text rendering in the history dialog and notifications.
+
+- **What it provides**: Markdown to HTML conversion, extensions support
+- **License**: BSD 3-Clause License
+
+### [Pygments](https://pygments.org/)
+**Syntax highlighting**
+
+Provides code syntax highlighting in markdown-rendered content.
+
+- **What it provides**: Code syntax highlighting, multiple language support
+- **License**: BSD 2-Clause License
+
+## Configuration and Data
+
+### [tomli](https://github.com/hukkin/tomli) / [tomli-w](https://github.com/hukkin/tomli-w)
+**TOML configuration file support**
+
+Enables clean, human-readable configuration files.
+
+- **What it provides**: TOML parsing and writing
+- **License**: MIT License
+
+## Development Tools
+
+### [setuptools](https://setuptools.pypa.io/)
+**Python packaging**
+
+Modern Python packaging and distribution.
+
+- **License**: MIT License
+
+## Special Recognition
+
+### The Python Community
+The entire Python ecosystem that makes rapid development of sophisticated applications possible.
+
+### macOS Integration
+Apple's excellent developer documentation and APIs that enable seamless system integration.
+
+### Open Source Contributors
+All the maintainers, contributors, and users of the above projects who make open-source software development possible.
+
+---
+
+## License Compatibility
+
+AbstractAssistant is released under the MIT License, which is compatible with all the dependencies listed above. Users should be aware of the specific licensing terms of each dependency, particularly:
+
+- **Qt-based components** (PyQt5/PyQt6) are available under GPL v3 or commercial license
+- **PySide2/PySide6** are available under LGPL v3 or commercial license
+- All other dependencies use permissive licenses (MIT, BSD, etc.)
+
+For commercial use, consider the licensing implications of Qt-based components.
+
+---
+
+**Thank you to all the developers and maintainers who make projects like AbstractAssistant possible!** 🙏

abstractassistant-0.3.3/CHANGELOG.md

@@ -0,0 +1,210 @@
+# Changelog
+
+All notable changes to AbstractAssistant will be documented in this file.
+
+
+## [0.3.3] - 2025-10-24
+
+### Changed
+- **Keyboard Behavior**: Reversed Enter/Shift+Enter behavior for more intuitive message sending
+  - `Enter`: Send message (previously required Shift+Enter)
+  - `Shift+Enter`: Add new line without sending (previously just Enter)
+  - Updated both Qt and Tkinter chat interfaces for consistency
+  - Improved user experience with standard chat application behavior
+
+### Fixed
+- **macOS App Bundle**: Consolidated and improved app bundle creation system
+  - Merged `setup_macos_app.py` functionality into `create_app_bundle.py` for cleaner architecture
+  - Enhanced Python environment discovery in launch script for better reliability
+  - Improved custom icon preservation logic to prevent overwriting user icons
+  - Fixed app bundle creation for various Python installation methods (pyenv, system, conda)
+  - Removed redundant files and streamlined packaging structure
+
+### Improved
+- **Documentation**: Updated all documentation to reflect current features and behavior
+  - Fixed keyboard shortcuts documentation across all guides
+  - Updated installation instructions with correct app bundle creation commands
+  - Verified consistency of Python version requirements (3.9+) across all docs
+  - Corrected outdated references to deprecated modules
+
+### Removed
+- **Code Cleanup**: Removed deprecated `setup_macos_app.py` after consolidation
+  - All functionality moved to `abstractassistant/create_app_bundle.py`
+  - Updated PyPI packaging to exclude development artifacts
+  - Cleaner project structure with single app bundle creation entry point
+
+## [0.3.0] - 2025-10-22
+
+### Fixed
+- **CRITICAL: Session Persistence**: Completely eliminated unwanted session clearing that was destroying chat history
+  - Sessions now persist when switching providers or models
+  - TTS mode switching preserves chat history
+  - Error handling preserves sessions instead of creating new ones
+  - System tray actions require user confirmation and cannot bypass session control
+  - Only explicit "Clear" button action in UI destroys sessions
+  - Separated LLM initialization from session management
+  - Added `update_session_mode()` method for history-preserving mode switches
+  - Fixed automatic session loading that bypassed user control
+  - Bulletproof session control: NO internal process can clear sessions
+- **UI Layout**: Fixed window resizing when adding/removing file attachments
+  - Window now dynamically resizes to accommodate file attachment widget
+  - Base size: 630x196, expands to 630x224 when files are attached (compact)
+  - Voice mode properly adjusts: 630x120 base, 630x148 with attachments
+  - Maintains proper positioning relative to system tray after resize
+- **Session Clearing**: Clear session now also clears attached files
+  - When user clicks "Clear" button, both messages and attached files are cleared
+  - Updated confirmation dialog to mention attached files will be removed
+  - Ensures complete session reset including file attachments
+- **File Chip Styling**: Made file attachment chips more compact and space-efficient
+  - Reduced font size from 10px to 8px for better space utilization
+  - Decreased border radius from 10px to 6px for tighter appearance
+  - Minimized padding and margins throughout (50% reduction)
+  - Smaller remove buttons (16x16 → 12x12) for cleaner look
+  - Window expansion reduced from +40px to +28px (30% space savings)
+- **UI Cleanup**: Removed unwanted voice control panel extension
+  - Eliminated the play/pause control panel that sometimes appeared at bottom
+  - Cleaner interface without unnecessary UI extensions
+  - Voice controls still available through existing TTS toggle button
+- **File Attachment Persistence & Visual Indicators**: Enhanced file handling for better user experience
+  - Files now remain attached after sending messages, allowing for easy reuse in follow-up messages
+  - Added visual file attachment indicators (📎) in chat history dialog showing file count per message
+  - Enhanced message history structure to track file attachments per message
+  - Clear session now properly clears both messages and file attachment tracking
+  - Improved file workflow: attach once, use multiple times until manually removed
+
+## [0.2.8] - 2025-10-21
+
+### Added
+- **macOS App Bundle**: Native macOS application bundle (`.app`) with Dock integration and system tray support
+- **Automated App Creation**: `create-app-bundle` command to generate macOS app bundle post-installation
+- **Streamlined Installation**: `install.py` script for one-command macOS setup with app bundle creation
+- **Neural Network Icon**: Beautiful AI-inspired icon automatically generated and converted to `.icns` format
+
+### Improved
+- **Cross-Environment Compatibility**: Robust Python environment detection supporting pyenv, anaconda, homebrew, and system Python
+- **Portable Launch Script**: Smart Python discovery that works across different users and system configurations
+- **Error Handling**: User-friendly dialog boxes for installation and launch issues
+- **Documentation**: Updated installation guides for macOS App Bundle workflow
+
+### Fixed
+- **Python Environment Detection**: Resolved issues with finding correct Python installation in GUI launch context
+- **Development vs Production**: Launch script now correctly uses installed package instead of development version
+- **PATH Resolution**: Fixed Python executable discovery when launched from Dock vs terminal
+
+### Technical
+- Added `MacOSAppBundleGenerator` class for programmatic app bundle creation
+- Enhanced `setup_macos_app.py` with comprehensive Python environment detection
+- Updated `pyproject.toml` to include app bundle creation tools as console scripts
+- Improved launch script with fallback mechanisms for different Python installations
+- Added proper `Info.plist` configuration for macOS app bundle standards
+
+### Installation
+```bash
+# Simple one-command installation for macOS users
+python install.py
+
+# Or manual installation
+pip install abstractassistant
+create-app-bundle
+```
+
+### Usage
+- Launch from **Applications folder** or **Dock**
+- Look for neural network icon in **menu bar** (system tray)
+- All existing CLI options remain available
+
+## [0.2.5] - 2025-10-21
+
+### Added
+- **File Attachments**: Click the 📎 button to attach images, PDFs, Office docs, or data files to your messages. The AI can now analyze documents, images, spreadsheets, and more.
+- **Clickable Messages**: Click any message bubble in the history panel to copy its content to clipboard. A subtle flash confirms the copy.
+
+### Improved
+- **Chat History Layout**: Reduced text size (17px → 14px), increased bubble width (320px → 400px), and tightened spacing throughout for better readability and more efficient use of screen space.
+- **Markdown Rendering**: Headers, paragraphs, and lists now use minimal spacing to display more content without scrolling.
+
+### Updated
+- **AbstractCore 2.4.5**: Upgraded from 2.4.2 to leverage universal media handling system with support for images, PDFs, Office documents (DOCX, XLSX, PPTX), and data files (CSV, JSON).
+
+### Technical
+- Added `ClickableBubble` widget with visual feedback for clipboard operations
+- Enhanced `LLMManager` and `LLMWorker` to handle media file attachments
+- File chips display with type-specific icons and individual remove buttons
+- Improved markdown processor with tighter vertical spacing
+
+## [1.1.0] - 2024-10-16
+
+### 🌐 Major UI Overhaul: Beautiful Web Interface
+
+#### Added
+- **Modern Web Interface**: Complete replacement of Qt/Tkinter with beautiful HTML/CSS/JavaScript
+- **Glassmorphism Design**: Stunning visual effects with backdrop blur and transparency
+- **WebSocket Communication**: Real-time bidirectional communication between web UI and Python backend
+- **Responsive Design**: Works perfectly on desktop and mobile browsers
+- **Advanced Settings Panel**: Theme selection, temperature control, and token limit configuration
+- **Smooth Animations**: Professional transitions and loading states
+- **Dark/Light Themes**: Automatic system theme detection with manual override
+
+#### Enhanced
+- **Web Server**: Full aiohttp-based server with WebSocket support
+- **Real-time Status**: Live updates for connection status and processing state
+- **Modern Typography**: Inter font family for professional appearance
+- **Gradient Buttons**: Beautiful send button with hover effects
+- **Message Bubbles**: Elegant chat interface with markdown rendering
+
+#### Technical Improvements
+- Added `aiohttp` and `websockets` dependencies
+- Created `WebServer` class with async/await support
+- Fallback to simple HTTP server if aiohttp unavailable
+- Updated system tray to launch web interface instead of Qt bubble
+- Maintained backward compatibility with existing configuration
+
+## [1.0.0] - 2024-10-15
+
+### Added
+- **System Tray Integration**: Native macOS menu bar icon with neural network-inspired design
+- **Modern Chat Bubble UI**: Glassy, translucent interface with 1/6th screen size
+- **Multi-Provider Support**: OpenAI, Anthropic, and Ollama integration via AbstractCore
+- **Toast Notifications**: Elegant collapsible notifications with markdown rendering
+- **TOML Configuration**: Modern configuration management with validation
+- **CLI Interface**: `abstractassistant` command with multiple options
+- **Real-time Status**: Token counting and execution status display
+- **Copy to Clipboard**: One-click result sharing
+- **Keyboard Shortcuts**: Cmd+Enter to send, Escape to close
+- **Error Handling**: Graceful fallbacks and user-friendly error messages
+- **Debug Mode**: Comprehensive debugging and logging capabilities
+
+### Features
+- **Universal LLM Support**: Works with any provider supported by AbstractCore
+- **Session Management**: Persistent conversation memory
+- **Modern Design**: Dark theme with glassy effects and smooth animations
+- **Performance Optimized**: Threaded operations and efficient resource usage
+- **Cross-Platform Foundation**: Built for future Windows/Linux support
+
+### Technical
+- **Modular Architecture**: Clean separation of concerns
+- **Robust Error Handling**: Comprehensive exception management
+- **Configuration Validation**: Type-safe configuration with defaults
+- **Package Structure**: Proper Python package with CLI entry points
+- **Development Mode**: Editable installation support
+
+### CLI Commands
+```bash
+abstractassistant                    # Launch with default settings
+abstractassistant --provider openai # Set provider
+abstractassistant --model gpt-4o     # Set model
+abstractassistant --debug            # Debug mode
+abstractassistant --config custom.toml # Custom config
+```
+
+### Configuration
+- TOML-based configuration with validation
+- Environment variable support for API keys
+- Customizable UI themes and behavior
+- Provider and model defaults
+
+### Dependencies
+- AbstractCore 2.4.0+ for universal LLM support
+- CustomTkinter for modern UI components
+- pystray for cross-platform system tray
+- TOML libraries for configuration management