Files
KiC-AI/CONFIG_UPDATE_v2.3.0.md
Jochem 3c06ec6a89 Add complete configuration system with Nexar API key management
🔧 New Features:
- Complete configuration dialog with tabbed interface
- Nexar API key management with persistent storage
- Automatic demo/API mode switching
- Settings saved to ~/.kic-ai/config.json
- Enhanced MCP client with API key support

📦 Updates:
- Updated README with v2.3.0 ZIP and Nexar pricing features
- Updated metadata.json with new version and pricing tags
- Remove old ZIP files and keep only latest version
- Add comprehensive configuration documentation

🚀 Ready for production use with optional API key setup
2025-08-01 21:21:25 +02:00

3.3 KiB

KIC-AI v2.3.0 - Configuration Update

New Features

🔧 Complete Configuration System

  • Advanced Config Dialog: Tabbed interface with API Settings, General Settings, and Info
  • Nexar API Key Management: Store and manage your Nexar API key
  • Persistent Settings: Configuration saved to ~/.kic-ai/config.json
  • Demo/API Mode Toggle: Automatic switching between demo and real API mode

⚙️ Configuration Features

  • API Settings Tab:

    • Nexar API key input (with password masking)
    • Demo mode checkbox
    • Connection testing
    • Status indicators
  • General Settings Tab:

    • AI Mode selection (Analysis, Chat, Expert)
    • Language selection (English, Nederlands, Deutsch, Français)
  • Info Tab:

    • Feature overview
    • Configuration help
    • Contact information

🔄 Smart API Integration

  • Automatic Mode Detection: Uses real API when key is configured, demo otherwise
  • Environment Variable Support: Falls back to NEXAR_TOKEN environment variable
  • Embedded Server Enhancement: API key passed to embedded Nexar server
  • Status Reporting: Clear indication of demo vs API mode

📋 Usage Instructions

1. Install the Plugin

Extract kicad-ai-assistant-v2.3.0-with-config.zip to your KiCad plugins directory

2. Access Configuration

  1. Open KiCad PCBNew or Eeschema
  2. Click the robot icon to open KIC-AI Assistant
  3. Click the ⚙️ Config button
  4. Navigate through the tabs to configure your settings

3. Configure Nexar API (Optional)

  1. Go to Nexar API to get your free API key
  2. In the Config dialog, enter your API key in the "API Settings" tab
  3. Click "💾 Save" to store your configuration
  4. Test pricing functionality with real API data

4. Demo Mode (Default)

  • Works immediately without any API keys
  • Provides realistic demo pricing data
  • Perfect for testing and evaluation

🔧 Technical Details

Configuration File

  • Location: ~/.kic-ai/config.json
  • Contains: API keys, preferences, UI settings
  • Automatically created on first save

API Key Priority

  1. Configuration dialog setting
  2. Environment variable NEXAR_TOKEN
  3. Demo mode (fallback)

New Files Added

  • plugins/config_manager.py: Complete configuration management system
  • Enhanced plugins/ai_dialog.py: Integration with config system
  • Enhanced plugins/simple_mcp_client_embedded.py: API key support

🎯 Benefits

  1. Easy API Key Management: No need to edit files or set environment variables
  2. Persistent Configuration: Settings remembered across KiCad sessions
  3. Flexible Setup: Works in demo mode or with real API keys
  4. User-Friendly Interface: Professional tabbed configuration dialog
  5. Backwards Compatible: Existing installations continue to work

🧪 Testing

The configuration system has been tested with:

  • API key storage and retrieval
  • Demo mode fallback
  • Settings persistence
  • UI integration
  • Embedded server API key passing

🚀 Getting Started

  1. Quick Start: Install and use immediately in demo mode
  2. Full Setup: Add your Nexar API key for real pricing data
  3. Customize: Configure AI mode and language preferences

Previous Version: v2.2.1 (Basic config info dialog) Current Version: v2.3.0 (Full configuration system) Next: Advanced features and additional API integrations