thonny-codemate 0.1.0__py3-none-any.whl

thonny_codemate-0.1.0.dist-info/METADATA

@@ -0,0 +1,307 @@
+Metadata-Version: 2.4
+Name: thonny-codemate
+Version: 0.1.0
+Summary: A Thonny IDE plugin that provides AI-powered coding assistance using local and cloud LLMs
+Author-email: tokoroten <shinta.nakayama@gmail.com>
+License: MIT
+Project-URL: Homepage, https://github.com/tokoroten/thonny-codemate
+Project-URL: Repository, https://github.com/tokoroten/thonny-codemate
+Project-URL: Issues, https://github.com/tokoroten/thonny-codemate/issues
+Keywords: thonny,plugin,llm,ai,code-assistant,education
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Education
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Education
+Classifier: Topic :: Software Development :: Code Generators
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: thonny>=4.0.0
+Requires-Dist: huggingface-hub[hf_xet]>=0.16.0
+Requires-Dist: tkinterweb[javascript]>=3.24
+Requires-Dist: pythonmonkey>=0.2.0
+Requires-Dist: markdown>=3.5
+Requires-Dist: pygments>=2.17
+Requires-Dist: llama-cpp-python>=0.3.9
+Provides-Extra: cuda
+Provides-Extra: metal
+Provides-Extra: external-only
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0; extra == "dev"
+Requires-Dist: pytest-cov>=4.0; extra == "dev"
+Requires-Dist: pytest-mock>=3.10.0; extra == "dev"
+Requires-Dist: debugpy>=1.6; extra == "dev"
+Requires-Dist: black>=23.0; extra == "dev"
+Requires-Dist: ruff>=0.1.0; extra == "dev"
+Requires-Dist: llama-cpp-python>=0.3.9; extra == "dev"
+Provides-Extra: test
+Requires-Dist: pytest>=7.0; extra == "test"
+Requires-Dist: pytest-cov>=4.0; extra == "test"
+Requires-Dist: pytest-mock>=3.10.0; extra == "test"
+Dynamic: license-file
+
+# Thonny Local LLM Plugin
+
+A Thonny IDE plugin that integrates local LLM capabilities using llama-cpp-python to provide GitHub Copilot-like features without requiring external API services.
+
+![image](https://github.com/user-attachments/assets/af94b175-bcc1-4e44-bbed-37402ee2850f)
+
+## Features
+
+- 🤖 **Local LLM Integration**: Uses llama-cpp-python to load GGUF models directly (no Ollama server required)
+- 🚀 **On-Demand Model Loading**: Models are loaded on first use (not at startup) to avoid slow startup times
+- 📝 **Code Generation**: Generate code based on natural language instructions
+- 💡 **Code Explanation**: Select code and get AI-powered explanations via context menu
+- 🎯 **Context-Aware**: Understands multiple files and project context
+- 💬 **Conversation Memory**: Maintains conversation history for contextual responses
+- 🎚️ **Skill Level Adaptation**: Adjusts responses based on user's programming skill level
+- 🔌 **External API Support**: Optional support for ChatGPT, Ollama server, and OpenRouter as alternatives
+- 📥 **Model Download Manager**: Built-in download manager for recommended models
+- 🎨 **Customizable System Prompts**: Tailor AI behavior with custom system prompts
+- 📋 **Interactive Code Blocks**: Copy and insert code blocks directly from chat
+- 🎨 **Markdown Rendering**: Optional rich text formatting with tkinterweb
+- 💾 **USB Portable**: Can be bundled with Thonny and models for portable use
+- 🛡️ **Error Resilience**: Advanced error handling with automatic retry and user-friendly messages
+- ⚡ **Performance Optimized**: Message virtualization and caching for handling large conversations
+- 🔧 **Smart Provider Detection**: Automatically detects Ollama vs LM Studio based on API responses
+- 🌐 **Multi-language Support**: Japanese, Chinese (Simplified/Traditional), and English UI
+
+## Installation
+
+### From PyPI
+```bash
+# Standard installation (includes llama-cpp-python for CPU)
+pip install thonny-codemate
+```
+
+**For GPU support**, see [INSTALL_GPU.md](INSTALL_GPU.md) for detailed instructions:
+- NVIDIA GPUs (CUDA)
+- Apple Silicon (Metal)
+- Automatic GPU detection
+
+### Development Installation
+
+#### Quick Setup with uv (Recommended)
+```bash
+# Clone the repository
+git clone https://github.com/tokoroten/thonny-codemate.git
+cd thonny-codemate
+
+# Install uv if not already installed
+# Windows (PowerShell):
+powershell -c "irm https://astral.sh/uv/install.ps1 | iex"
+# Linux/macOS:
+curl -LsSf https://astral.sh/uv/install.sh | sh
+
+# Install all dependencies (including llama-cpp-python)
+uv sync --all-extras
+
+# Or install with development dependencies only
+uv sync --extra dev
+
+# (Optional) Install Markdown rendering support
+# Basic Markdown rendering:
+uv sync --extra markdown
+# Full JavaScript support for interactive features:
+uv sync --extra markdown-full
+
+# Activate virtual environment
+.venv\Scripts\activate  # Windows
+source .venv/bin/activate  # macOS/Linux
+```
+
+#### Alternative Setup Script
+```bash
+# Use the setup script for guided installation
+python setup_dev.py
+```
+
+### Installing with GPU Support
+
+By default, llama-cpp-python is installed with CPU support. For GPU acceleration:
+
+**CUDA support**:
+```bash
+# Reinstall llama-cpp-python with CUDA support
+uv pip uninstall llama-cpp-python
+uv pip install llama-cpp-python --extra-index-url https://abetlen.github.io/llama-cpp-python/whl/cu124
+```
+
+**Metal support (macOS)**:
+```bash
+# Rebuild with Metal support
+uv pip uninstall llama-cpp-python
+CMAKE_ARGS="-DLLAMA_METAL=on" uv pip install llama-cpp-python --no-cache-dir
+```
+
+## Model Setup
+
+### Download GGUF Models
+
+Recommended models:
+- **Qwen2.5-Coder-14B** - Latest high-performance model specialized for programming (8.8GB)
+- **Llama-3.2-1B/3B** - Lightweight and fast models (0.8GB/2.0GB)
+- **Llama-3-ELYZA-JP-8B** - Japanese-specialized model (4.9GB)
+
+```bash
+# Install Hugging Face CLI
+pip install -U "huggingface_hub[cli]"
+
+# Qwen2.5 Coder (programming-focused, recommended)
+huggingface-cli download bartowski/Qwen2.5-Coder-14B-Instruct-GGUF Qwen2.5-Coder-14B-Instruct-Q4_K_M.gguf --local-dir ./models
+
+# Llama 3.2 1B (lightweight)
+huggingface-cli download bartowski/Llama-3.2-1B-Instruct-GGUF Llama-3.2-1B-Instruct-Q4_K_M.gguf --local-dir ./models
+```
+
+## Usage
+
+1. **Start Thonny** - The plugin will load automatically
+2. **Model Setup**:
+   - Open Settings → LLM Assistant Settings
+   - Choose between local models or external APIs
+   - For local models: Select a GGUF file or download recommended models
+   - For external APIs: Enter your API key and model name
+3. **Code Explanation**:
+   - Select code in the editor
+   - Right-click and choose "Explain Selection"
+   - The AI will explain the code based on your skill level
+4. **Code Generation**:
+   - Write a comment describing what you want
+   - Right-click and choose "Generate from Comment"
+   - Or use the AI Assistant panel for interactive chat
+5. **Error Fixing**:
+   - When you encounter an error, click "Explain Error" in the assistant panel
+   - The AI will analyze the error and suggest fixes
+
+### External API Configuration
+
+#### ChatGPT
+1. Get an API key from [OpenAI](https://platform.openai.com/)
+2. In settings, select "chatgpt" as provider
+3. Enter your API key
+4. Choose model (e.g., gpt-3.5-turbo, gpt-4)
+
+#### Ollama
+1. Install and run [Ollama](https://ollama.ai/)
+2. In settings, select "ollama" as provider
+3. Set base URL (default: http://localhost:11434)
+4. Choose installed model (e.g., llama3, mistral)
+
+#### OpenRouter
+1. Get an API key from [OpenRouter](https://openrouter.ai/)
+2. In settings, select "openrouter" as provider
+3. Enter your API key
+4. Choose model (free models available)
+
+## Development
+
+### Project Structure
+```
+thonny-codemate/
+├── thonnycontrib/
+│   └── thonny_codemate/
+│       ├── __init__.py       # Plugin entry point
+│       ├── llm_client.py     # LLM integration
+│       ├── ui_widgets.py     # UI components
+│       └── config.py         # Configuration
+├── models/                   # GGUF model storage
+├── tests/                    # Unit tests
+├── docs_for_ai/             # AI documentation
+└── README.md
+```
+
+### Running in Development Mode
+```bash
+# Normal mode
+python run_dev.py
+
+# Debug mode (for VS Code/PyCharm attachment)
+python run_dev.py --debug
+
+# Quick run with uv
+uv run thonny
+```
+
+### Running Tests
+```bash
+uv run pytest -v
+```
+
+## Configuration
+
+The plugin stores its configuration in Thonny's settings system. You can configure:
+
+- **Provider Selection**: Local models or external APIs (ChatGPT, Ollama, OpenRouter)
+- **Model Settings**: Model path, context size, generation parameters
+- **User Preferences**: Skill level (beginner/intermediate/advanced)
+- **System Prompts**: Choose between coding-focused, explanation-focused, or custom prompts
+- **Generation Parameters**: Temperature, max tokens, etc.
+
+## Requirements
+
+- Python 3.8+
+- Thonny 4.0+
+- llama-cpp-python (automatically installed)
+- 4GB+ RAM (depending on model size)
+- 5-10GB disk space for models
+- uv (for development)
+- tkinterweb with JavaScript support (for Markdown rendering and interactive features)
+  - Automatically installed with the plugin
+  - Includes PythonMonkey for JavaScript-Python communication
+  - Enables Copy/Insert buttons with direct Python integration
+
+## Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request.
+
+1. Fork the repository
+2. Create your feature branch (`git checkout -b feature/AmazingFeature`)
+3. Commit your changes (`git commit -m 'Add some AmazingFeature'`)
+4. Push to the branch (`git push origin feature/AmazingFeature`)
+5. Open a Pull Request
+
+## License
+
+This project is licensed under the MIT License - see the LICENSE file for details.
+
+## Acknowledgments
+
+- Inspired by GitHub Copilot's functionality
+- Built on top of [llama-cpp-python](https://github.com/abetlen/llama-cpp-python)
+- Designed for [Thonny IDE](https://thonny.org/)
+- **99% of the code in this project was generated by [Claude Code](https://claude.ai/code)** - This project demonstrates the capabilities of AI-assisted development
+
+## Status
+
+🚧 **Under Development** - This plugin is currently in early development stage.
+
+## Roadmap
+
+- [x] Initial project setup
+- [x] Development environment with uv
+- [x] Basic plugin structure
+- [x] LLM integration with llama-cpp-python
+- [x] Chat panel UI (right side)
+- [x] Context menu for code explanation
+- [x] Code generation from comments
+- [x] Error fixing assistance
+- [x] Configuration UI
+- [x] Multi-file context support
+- [x] Model download manager
+- [x] External API support (ChatGPT, Ollama, OpenRouter)
+- [x] Customizable system prompts
+- [ ] Inline code completion
+- [ ] USB portable packaging
+- [ ] PyPI release
+
+## Links
+
+- [Thonny IDE](https://thonny.org/)
+- [llama-cpp-python](https://github.com/abetlen/llama-cpp-python)
+- [Project Documentation](docs_for_ai/)

thonny_codemate-0.1.0.dist-info/RECORD

@@ -0,0 +1,27 @@
+thonny_codemate-0.1.0.dist-info/licenses/LICENSE,sha256=f6YK7MRRtaWl2brMAtg_aGrsLK_i4rVyho0y1PdnFi0,1065
+thonnycontrib/__init__.py,sha256=7INAjyU8ojDRVyo0y1OQh3ynMPRGqBJZL4fa--i3elk,33
+thonnycontrib/thonny_codemate/__init__.py,sha256=M312z1qN0Pxtl6xUggSFQ0euX2kD8voBCoqFIlLLM6Q,13485
+thonnycontrib/thonny_codemate/api.py,sha256=YLXjPsB6cykgRwyjzrUBOGFtw0eu4BQgr1AiMbj8e7c,4259
+thonnycontrib/thonny_codemate/context_manager.py,sha256=K83M-VlBy7DR1xzedyPT8NViqnR9CmX95YmXnDBzRFM,11274
+thonnycontrib/thonny_codemate/external_providers.py,sha256=PmIRY_lLOILCAZa4mpP3yB9PU7ZWSddWjYPf2S7vkyY,29016
+thonnycontrib/thonny_codemate/i18n.py,sha256=tq1pBwNLYgQtJBXH36MmTOl1sRuaPaXgSyMaAXVIIPU,28846
+thonnycontrib/thonny_codemate/llm_client.py,sha256=Ojk8oxNI7tKAzVEtaoSwOLVisT1cOYdXf9Qw56eC2L4,33767
+thonnycontrib/thonny_codemate/message_virtualization.py,sha256=kShFsujEOm68_VOUGH47Qui4STBaxBjKu5r-lLqUdGE,4909
+thonnycontrib/thonny_codemate/model_manager.py,sha256=oS0VNuS_NWggNPfoRmQk3z7GIyQlo0DmQ1Bqks8iApY,21268
+thonnycontrib/thonny_codemate/performance_monitor.py,sha256=L6gIin6oBzplRgZB676AkYd3mAtkmc-Qg4K5iM59Q1E,4281
+thonnycontrib/thonny_codemate/prompts.py,sha256=bV4Qjr8SjqWBnnUIk-g-R58sRGbyZOauvlWvNO9GkGg,3885
+thonnycontrib/thonny_codemate/ui/__init__.py,sha256=SDKZ1vYdsb14_jHIP4wTeM8Vqkog8z0PkWquS3-mQIY,43
+thonnycontrib/thonny_codemate/ui/chat_view.py,sha256=veyFSCJUOPVFUt1qJochKTvHQi49u3fzxKQ0Nti0NNc,29203
+thonnycontrib/thonny_codemate/ui/chat_view_html.py,sha256=jgAeEc3dp2pcyfDfMg5RsTLROCHffNKFVlnMQNxFNrw,53561
+thonnycontrib/thonny_codemate/ui/custom_prompt_dialog.py,sha256=LEemjMmHM_KcidEsUhOOffa1DzCauOXNiUqlH2wGjts,5973
+thonnycontrib/thonny_codemate/ui/markdown_renderer.py,sha256=K1vHLTn6EocPRxb7fXMKGsSFD6iY-OhFTqMY_dBkiRw,15649
+thonnycontrib/thonny_codemate/ui/model_download_dialog.py,sha256=1qzqCL_2J_cXCh9OvUdaPAyouBm76BgfyUlPRkNCDGw,13701
+thonnycontrib/thonny_codemate/ui/settings_dialog.py,sha256=fFbTfhFN-_rkI48oW_5eqCT91OzT1ZnqxCOaCSWvjbU,51147
+thonnycontrib/thonny_codemate/utils/__init__.py,sha256=xjA_6r7WFCf3RbCNnZhwFOSapJgcr-4lC3sTI417rDM,523
+thonnycontrib/thonny_codemate/utils/constants.py,sha256=l6KKItPClPy7IWZKH53Kpq-PNMfJogTYIZ2OGKTZO8w,3159
+thonnycontrib/thonny_codemate/utils/error_messages.py,sha256=kOucGfSwBIOE23GsVAIcQYY7YbKjezIuOxiIM1wTKY4,3601
+thonnycontrib/thonny_codemate/utils/unified_error_handler.py,sha256=yvrSiXC3Kzro4KLL6lDLMBRfdff79PLvBF1yjHFhv9E,10769
+thonny_codemate-0.1.0.dist-info/METADATA,sha256=ZKugHzfp8cMIdTNUXCnVjfRh25FESOit_I1LdW8R6iE,10870
+thonny_codemate-0.1.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+thonny_codemate-0.1.0.dist-info/top_level.txt,sha256=thF9WQtY_lcNKOOR4SQeeWLAVWb4i8XhdGC7pEMAOHY,14
+thonny_codemate-0.1.0.dist-info/RECORD,,

thonny_codemate-0.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (80.9.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

thonny_codemate-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 tokoroten
+
+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.

thonny_codemate-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+thonnycontrib

thonnycontrib/__init__.py

@@ -0,0 +1 @@
+# thonnycontrib namespace package