QodeAssist

QodeAssist

QodeAssist is an AI-powered coding assistant plugin for Qt Creator

Stars: 99

Visit
 screenshot

QodeAssist is an AI-powered coding assistant plugin for Qt Creator, offering intelligent code completion and suggestions for C++ and QML. It leverages large language models like Ollama to enhance coding productivity with context-aware AI assistance directly in the Qt development environment. The plugin supports multiple LLM providers, extensive model-specific templates, and easy configuration for enhanced coding experience.

README:

QodeAssist - AI-powered coding assistant plugin for Qt Creator

Build plugin GitHub Downloads (all assets, all releases) GitHub Tag Static Badge Static Badge

qodeassist-icon QodeAssist is an AI-powered coding assistant plugin for Qt Creator. It provides intelligent code completion and suggestions for C++ and QML, leveraging large language models through local providers like Ollama. Enhance your coding productivity with context-aware AI assistance directly in your Qt development environment.

⚠️ Important Notice About Paid Providers

When using paid providers like Claude, OpenRouter or OpenAI-compatible services:

  • These services will consume API tokens which may result in charges to your account
  • The QodeAssist developer bears no responsibility for any charges incurred
  • Please carefully review the provider's pricing and your account settings before use

Table of Contents

  1. Overview
  2. Install plugin to QtCreator
  3. Configure for Anthropic Claude
  4. Configure for OpenAI
  5. Configure for using Ollama
  6. System Prompt Configuration
  7. Template-Model Compatibility
  8. QtCreator Version Compatibility
  9. Development Progress
  10. Hotkeys
  11. Troubleshooting
  12. Support the Development
  13. How to Build

Overview

  • AI-powered code completion
  • Chat functionality:
    • Side and Bottom panels
  • Support for multiple LLM providers:
  • Extensive library of model-specific templates
  • Custom template support
  • Easy configuration and model selection
Code completion: (click to expand) QodeAssistPreview
Multiline Code completion: (click to expand) QodeAssistPreview
Chat with LLM models in side panels: (click to expand) QodeAssistChat
Chat with LLM models in bottom panel: (click to expand) QodeAssistBottomPanel

Install plugin to QtCreator

  1. Install Latest Qt Creator
  2. Download the QodeAssist plugin for your Qt Creator
  3. Launch Qt Creator and install the plugin:
    • Go to:
      • MacOS: Qt Creator -> About Plugins...
      • Windows\Linux: Help -> About Plugins...
    • Click on "Install Plugin..."
    • Select the downloaded QodeAssist plugin archive file

Configure for Anthropic Claude

  1. Open Qt Creator settings and navigate to the QodeAssist section
  2. Go to Provider Settings tab and configure Claude api key
  3. Return to General tab and configure:
    • Set "Claude" as the provider for code completion or/and chat assistant
    • Set the Claude URL (https://api.anthropic.com)
    • Select your preferred model (e.g., claude-3-5-sonnet-20241022)
    • Choose the Claude template for code completion or/and chat
Example of Claude settings: (click to expand) Claude Settings

Configure for OpenAI

  1. Open Qt Creator settings and navigate to the QodeAssist section
  2. Go to Provider Settings tab and configure OpenAI api key
  3. Return to General tab and configure:
    • Set "OpenAI" as the provider for code completion or/and chat assistant
    • Set the OpenAI URL (https://api.openai.com)
    • Select your preferred model (e.g., gpt-4o)
    • Choose the OpenAI template for code completion or/and chat
Example of OpenAI settings: (click to expand) OpenAI Settings

Configure for using Ollama

  1. Install Ollama. Make sure to review the system requirements before installation.
  2. Install a language models in Ollama via terminal. For example, you can run:

For standard computers (minimum 8GB RAM):

ollama run qwen2.5-coder:7b

For better performance (16GB+ RAM):

ollama run qwen2.5-coder:14b

For high-end systems (32GB+ RAM):

ollama run qwen2.5-coder:32b
  1. Open Qt Creator settings (Edit > Preferences on Linux/Windows, Qt Creator > Preferences on macOS)
  2. Navigate to the "Qode Assist" tab
  3. On the "General" page, verify:
    • Ollama is selected as your LLM provider
    • The URL is set to http://localhost:11434
    • Your installed model appears in the model selection
    • The prompt template is Ollama Auto FIM or Ollama Auto Chat for chat assistance. You can specify template if it is not work correct
  4. Click Apply if you made any changes

You're all set! QodeAssist is now ready to use in Qt Creator.

Example of Ollama settings: (click to expand) Ollama Settings

System Prompt Configuration

The plugin comes with default system prompts optimized for chat and instruct models, as these currently provide better results for code assistance. If you prefer using FIM (Fill-in-Middle) models, you can easily customize the system prompt in the settings.

Template-Model Compatibility

Template Compatible Models Purpose
CodeLlama FIM codellama:code Code completion
DeepSeekCoder FIM deepseek-coder-v2, deepseek-v2.5 Code completion
Ollama Auto FIM Any Ollama base/fim models Code completion
Qwen FIM Qwen 2.5 models(exclude instruct) Code completion
StarCoder2 FIM starcoder2 base model Code completion
Alpaca starcoder2:instruct Chat assistance
Basic Chat Messages without tokens Chat assistance
ChatML Qwen 2.5 models(exclude base models) Chat assistance
Llama2 llama2 model family, codellama:instruct Chat assistance
Llama3 llama3 model family Chat assistance
Ollama Auto Chat Any Ollama chat/instruct models Chat assistance

QtCreator Version Compatibility

  • QtCreator 15.0.1 - 0.4.8 - 0.4.x
  • QtCreator 15.0.0 - 0.4.0 - 0.4.7
  • QtCreator 14.0.2 - 0.2.3 - 0.3.x
  • QtCreator 14.0.1 - 0.2.2 plugin version and below

Development Progress

  • [x] Basic plugin with code autocomplete functionality
  • [x] Improve and automate settings
  • [x] Add chat functionality
  • [x] Sharing diff with model
  • [ ] Sharing project source with model
  • [ ] Support for more providers and models

Hotkeys

  • To call manual request to suggestion, you can use or change it in settings
    • on Mac: Option + Command + Q
    • on Windows: Ctrl + Alt + Q
  • To insert the full suggestion, you can use the TAB key
  • To insert word of suggistion, you can use Alt + Right Arrow for Win/Lin, or Option + Right Arrow for Mac

Troubleshooting

If QodeAssist is having problems connecting to the LLM provider, please check the following:

  1. Verify the IP address and port:

  2. Check the endpoint:

Make sure the endpoint in the settings matches the one required by your provider - For Ollama, it should be /api/generate - For LM Studio and OpenAI compatible providers, it's usually /v1/chat/completions

  1. Confirm that the selected model and template are compatible:

Ensure you've chosen the correct model in the "Select Models" option Verify that the selected prompt template matches the model you're using

If you're still experiencing issues with QodeAssist, you can try resetting the settings to their default values:

  1. Open Qt Creator settings
  2. Navigate to the "Qode Assist" tab
  3. Pick settings page for reset
  4. Click on the "Reset Page to Defaults" button
    • The API key will not reset
    • Select model after reset

Support the development of QodeAssist

If you find QodeAssist helpful, there are several ways you can support the project:

  1. Report Issues: If you encounter any bugs or have suggestions for improvements, please open an issue on our GitHub repository.

  2. Contribute: Feel free to submit pull requests with bug fixes or new features.

  3. Spread the Word: Star our GitHub repository and share QodeAssist with your fellow developers.

  4. Financial Support: If you'd like to support the development financially, you can make a donation using one of the following:

    • Bitcoin (BTC): bc1qndq7f0mpnlya48vk7kugvyqj5w89xrg4wzg68t
    • Ethereum (ETH): 0xA5e8c37c94b24e25F9f1f292a01AF55F03099D8D
    • Litecoin (LTC): ltc1qlrxnk30s2pcjchzx4qrxvdjt5gzuervy5mv0vy
    • USDT (TRC20): THdZrE7d6epW6ry98GA3MLXRjha1DjKtUx

Every contribution, no matter how small, is greatly appreciated and helps keep the project alive!

How to Build

Create a build directory and run

cmake -DCMAKE_PREFIX_PATH=<path_to_qtcreator> -DCMAKE_BUILD_TYPE=RelWithDebInfo <path_to_plugin_source>
cmake --build .

where <path_to_qtcreator> is the relative or absolute path to a Qt Creator build directory, or to a combined binary and development package (Windows / Linux), or to the Qt Creator.app/Contents/Resources/ directory of a combined binary and development package (macOS), and <path_to_plugin_source> is the relative or absolute path to this plugin directory.

For Contributors

QML code style: Preferably follow the following guidelines https://github.com/Furkanzmc/QML-Coding-Guide, thank you @Furkanzmc for collect them C++ code style: check use .clang-fortmat in project

qodeassist-icon qodeassist-icon-small

For Tasks:

Click tags to check more tools for each tasks

For Jobs:

Alternative AI tools for QodeAssist

Similar Open Source Tools

For similar tasks

For similar jobs