---
url: https://docs.cybrosys.com/pycharm-plugin/troubleshooting.md
description: >-
  Fix common installation and usage problems with the Odoo Helper plugin for
  PyCharm, and find out where to get help.
---

# Troubleshooting

This guide provides solutions for common issues you might encounter while using the Cybrosys Assista PyCharm plugin. If you don't find your issue here, please visit our [Support](/support) page.

## Installation issues

### Plugin not found in marketplace

**Symptoms:**

* Plugin doesn't appear in PyCharm's marketplace
* Search returns no results

**Solutions:**

1. Verify PyCharm version (2023.1 or later required)
2. Check internet connection
3. Clear PyCharm cache:
   * Go to **File → Invalidate Caches**
   * Select all options
   * Click **Invalidate and Restart**

### Installation fails

**Symptoms:**

* Installation process fails
* Error messages during installation
* Plugin doesn't appear after restart

**Solutions:**

1. Check PyCharm logs:
   * Go to **Help → Show Log**
   * Look for error messages
2. Verify system requirements:
   * Python 3.8 or later
   * Sufficient disk space
   * Proper permissions
3. Try manual installation:
   * Download plugin from website
   * Install from disk

## Configuration issues

### Plugin settings not saving

**Symptoms:**

* Settings changes don't persist
* Configuration resets after restart
* Custom templates not saved

**Solutions:**

1. Check file permissions:
   * Verify PyCharm config directory
   * Ensure write access
2. Reset settings:
   * Export current settings
   * Reset to defaults
   * Re-import settings
3. Check for conflicts:
   * Disable other plugins
   * Test in safe mode

### Odoo path not recognized

**Symptoms:**

* Module templates not working
* Code completion not functioning
  * Smart suggestions missing
  * Model names not recognized

**Solutions:**

1. Verify Odoo installation:
   * Check path in settings
   * Ensure Odoo is installed
   * Verify version compatibility
2. Update plugin settings:
   * Go to **Settings → Tools → Cybrosys Assista**
   * Set correct Odoo path
   * Add custom module paths
3. Rebuild indices:
   * Go to **File → Invalidate Caches**
   * Select "Clear file system cache"
   * Click **Invalidate and Restart**

## Feature-specific issues

### Module template generator

**Symptoms:**

* Templates not appearing
* Generation fails
* Missing files or folders

**Solutions:**

1. Check template cache:
   * Clear template cache
   * Rebuild indices
2. Verify module structure:
   * Check target directory
   * Ensure proper permissions
3. Review error logs:
   * Check PyCharm logs
   * Look for specific errors

### File creator

**Symptoms:**

* New file menu not appearing
* Template selection fails
* Generated files incomplete

**Solutions:**

1. Verify context menu:
   * Right-click in correct location
   * Check for "New Odoo File"
2. Check templates:
   * Verify template files
   * Update if needed
3. Review permissions:
   * Check directory access
   * Verify file creation rights

### Code snippets

**Symptoms:**

* Snippets not appearing
* Trigger not working
* Wrong completions

**Solutions:**

1. Check snippet settings:
   * Verify trigger word
   * Check language settings
2. Update snippets:
   * Clear snippet cache
   * Rebuild indices
3. Verify file type:
   * Check file extension
   * Ensure proper language

### Smart suggestions

**Symptoms:**

* No suggestions appearing
* Wrong suggestions
* Performance issues

**Solutions:**

1. Check indexing:
   * Rebuild indices
   * Clear caches
2. Verify model detection:
   * Check Odoo path
   * Update model cache
3. Review settings:
   * Check completion settings
   * Verify language support

### Code inspection

**Symptoms:**

* Inspections not running
* False positives
* Missing inspections

**Solutions:**

1. Check inspection settings:
   * Verify enabled inspections
   * Adjust severity levels
2. Update inspection rules:
   * Review custom rules
   * Reset to defaults
3. Clear inspection cache:
   * Rebuild indices
   * Clear caches

## Performance issues

### Slow plugin response

**Symptoms:**

* Delayed suggestions
* Slow template generation
* High CPU usage

**Solutions:**

1. Optimize settings:
   * Reduce inspection scope
   * Limit suggestion depth
2. Clear caches:
   * Clear file system cache
   * Rebuild indices
3. Check system resources:
   * Monitor CPU usage
   * Check memory usage
   * Verify disk space

### High memory usage

**Symptoms:**

* PyCharm becomes slow
* High memory consumption
* Frequent freezes

**Solutions:**

1. Adjust memory settings:
   * Increase heap size
   * Reduce cache size
2. Optimize plugin:
   * Disable unused features
   * Reduce inspection scope
3. System maintenance:
   * Close unused projects
   * Clear system caches
   * Restart PyCharm

## Common error messages

### "Plugin Not Compatible"

**Solution:**

* Update PyCharm to latest version
* Check plugin version compatibility
* Contact support if issue persists

### "Odoo Path Not Found"

**Solution:**

* Verify Odoo installation path
* Update plugin settings
* Check path permissions

### "Template Generation Failed"

**Solution:**

* Check target directory permissions
* Verify template files
* Clear template cache

### "Indexing Failed"

**Solution:**

* Clear file system cache
* Rebuild indices
* Check disk space

## Getting help

If you are still stuck, contact support and include your PyCharm version, plugin version, operating system and error logs.

* Email <assista@cybrosys.com>.
* Use the [contact form](https://assista.cybrosys.com/contact).
* See [Support](/support).

## Next steps

* [Installation](/pycharm-plugin/installation)
* [Quick start](/pycharm-plugin/quick-start)