9b26a2c6f7
✨ New Features: - 3 AI Interaction Modes: Analysis (Safe), Advisory (Guided), Assistant (Interactive) - Mode-specific AI responses and behavior - Enhanced user interface with mode selection dropdown - Step-by-step guidance in Advisory mode - Interactive assistance framework for future automation 📸 Documentation: - Added 3 screenshots showing main interface, mode selection, and PCB analysis - Comprehensive README with mode explanations and examples - Installation guide (INSTALL.md) with troubleshooting - Upgrade notes and changelog 🔧 Technical Improvements: - Enhanced AI dialog with mode detection - Context-aware conversation system - Improved safety warnings and user guidance - Professional project structure with proper organization 📦 Ready for Distribution: - Complete plugin package for KiCad 9.0+ - Compatible with Ollama LLM integration - Supports both PCB and schematic analysis - Three ZIP releases available for different use cases
1.9 KiB
1.9 KiB
KIC-AI Assistant Installation Guide
Quick Install (Recommended)
- Download the latest release:
kic-ai-assistant-v1.3.0-with-screenshots.zip - Open KiCad → Plugin and Content Manager
- Click "Install from File"
- Select the downloaded ZIP file
- Restart KiCad
Prerequisites
Before using the plugin, ensure you have:
1. Ollama Setup
# Install Ollama from https://ollama.ai
ollama pull llama3.2:3b
ollama serve
2. Python Requirements
pip install requests
Manual Installation
If the Plugin Manager doesn't work:
Windows
Copy plugin to: %APPDATA%/kicad/9.0/scripting/plugins/
macOS
Copy plugin to: ~/Library/Application Support/kicad/9.0/scripting/plugins/
Linux
Copy plugin to: ~/.config/kicad/9.0/scripting/plugins/
First Run
- Open PCB Editor (not Schematic Editor!)
- Look for robot icon 🤖 in toolbar
- Choose interaction mode:
- 🔍 Analysis (Safe for beginners)
- 📋 Advisory (Step-by-step guidance)
- 🤖 Assistant (Advanced features)
Troubleshooting
Plugin doesn't appear
- ✅ Check KiCad version (9.0+ required)
- ✅ Restart KiCad after installation
- ✅ Look in PCB Editor, not Schematic Editor
AI doesn't respond
- ✅ Start Ollama:
ollama serve - ✅ Install model:
ollama pull llama3.2:3b - ✅ Check internet connection
- ✅ Install requests:
pip install requests
Permission errors
- ✅ Run KiCad as administrator (Windows)
- ✅ Check plugin directory permissions
- ✅ Use Plugin Manager instead of manual copy
Support
- 📖 See README.md for detailed usage
- 🔄 Check CHANGELOG.md for latest features
- 📋 Read UPGRADE_NOTES.md for version changes
- 🐛 Report issues on GitHub
Quick Start: Install → Start Ollama → Open PCB Editor → Click 🤖 → Choose Analysis Mode → Start chatting!