Installation & Usage Instructions

Learn how to install and use the KiCad Chatbot by ALT TAB

System Requirements
Before installing, make sure your system meets these requirements
  • KiCad 9.0 or later
  • Python 3.7 or later
  • Internet connection (for API access)
  • OpenAI API key
Installation Guide
Follow these steps to install the KiCad Chatbot by ALT TAB

Method 1: Direct Download (Recommended)

  1. Download the latest release ZIP file from our download page
  2. Extract the ZIP file contents
  3. Copy the extracted folder to your KiCad plugins directory:
    # Windows
    C:\Users\[username]\Documents\KiCad\9.0\scripting\plugins\

    # macOS
    ~/Documents/KiCad/9.0/scripting/plugins/

    # Linux
    ~/.kicad/9.0/scripting/plugins/
  4. Restart KiCad
KiCad plugin installation process

Method 2: Using Plugin and Content Manager

  1. Download the latest release ZIP file from our download page
  2. Open KiCad
  3. Go to "Plugin and Content Manager" from the main menu
  4. Click on "Open Package Directory"
  5. Navigate to the "plugins" folder inside this directory
  6. Extract and copy the downloaded ZIP file contents into this plugins folder
  7. Close KiCad and reopen it
  8. When you open the PCB Editor, the KiCad Chatbot by ALT TAB plugin will appear in the toolbar
KiCad plugin installation using Plugin Manager

Method 3: Manual Installation from GitHub (For Authorized Users Only)

This method requires access to the private repository. Please contact Stefan Jancic for access.

  1. Clone the private repository (requires authorization):
    git clone https://github.com/jancicS/kicad-chatbot.git
  2. Navigate to the cloned directory:
    cd kicad-chatbot
  3. Install the required Python dependencies:
    pip install -r requirements.txt
  4. Copy the entire plugin folder to your KiCad plugins directory:
    # Windows
    xcopy /E /I kicad-chatbot "C:\Users\[username]\Documents\KiCad\9.0\scripting\plugins\KiCad_ChatBot_by_ALTTAB"

    # macOS
    cp -r kicad-chatbot ~/Documents/KiCad/9.0/scripting/plugins/KiCad_ChatBot_by_ALTTAB

    # Linux
    cp -r kicad-chatbot ~/.kicad/9.0/scripting/plugins/KiCad_ChatBot_by_ALTTAB
  5. Restart KiCad

API Key Setup

Before you can use the chatbot, you need to configure your OpenAI API key:

  1. Launch KiCad and open the PCB or Schematic editor
  2. Click on the "KiCad Chatbot by ALT TAB" button in the toolbar
  3. Click on the "Settings" button (gear icon) in the chat interface
  4. Select "Configure API Key" from the menu
  5. Enter your OpenAI API key and click "Save"

You can get an API key from OpenAI's platform.