AI-Powered Odoo Development Suite - Shell, Console & Smart Debugging
by okkype@gmail.com https://linkedin.com/in/okky-permana-sihipo$ 199.99
| Availability |
Odoo Online
Odoo.sh
On Premise
|
| Odoo Apps Dependencies |
Discuss (mail)
|
| Community Apps Dependencies | Show |
| Lines of code | 7626 |
| Technical Name |
odoo_shell_ok |
| License | OPL-1 |
| Website | https://linkedin.com/in/okky-permana-sihipo |
| Availability |
Odoo Online
Odoo.sh
On Premise
|
| Odoo Apps Dependencies |
Discuss (mail)
|
| Community Apps Dependencies | Show |
| Lines of code | 7626 |
| Technical Name |
odoo_shell_ok |
| License | OPL-1 |
| Website | https://linkedin.com/in/okky-permana-sihipo |
Odoo Shell OK - AI-Powered Development Suite
Interactive Shell ⢠Web Console ⢠AI Error Assistant
The ultimate development toolkit for Odoo - combining powerful shell access, system management, and AI-powered debugging in one comprehensive module.
🚀 Complete Feature Set
1. Odoo Interactive Shell
Full Python REPL with Odoo ORM access, running directly in your browser.
- Direct ORM Access: Use
self.envto access any Odoo model instantly - Real-time Execution: Execute Python code and see results immediately
- Auto-configured Environment: Automatically loads the correct database, config file, and virtual environment
- Command History: Navigate previous commands with Up/Down arrow keys
- Fullscreen Mode: Expand to fullscreen for better visibility
- Session Management: Kill or restart sessions as needed
>>> partners = self.env['res.partner'].search([('is_company', '=', True)])
>>> print(f"Found {len(partners)} companies")
>>> for p in partners[:5]:
... print(f"- {p.name} ({p.email})")
2. Web Console (Linux Terminal)
Full-featured Linux terminal embedded in Odoo - no SSH client needed.
- Browser-Based: Access your server's terminal from anywhere, no external tools required
- Full Shell Access: Run bash/sh commands, manage services, check logs
- xterm.js Powered: Professional terminal emulation with proper rendering
- Copy/Paste Support: Right-click context menu and keyboard shortcuts
- Resizable Window: Adjust terminal size or go fullscreen
- Multiple Sessions: Open multiple terminal windows simultaneously
- Restart Odoo service:
sudo systemctl restart odoo - Check server logs:
tail -f /var/log/odoo/odoo.log - Monitor resources:
htoportop - Manage files:
ls -la,cd,nano
🧠 Advanced AI Capabilities
Natural Language Processing (NLP) Engine
Communicate with your Odoo system using natural language - the AI understands context and intent.
- Conversational Interface: Ask questions in plain English, no need for technical jargon
- Context-Aware Understanding: AI analyzes your entire codebase and error context
- Intelligent Code Analysis: Understands Odoo's architecture, ORM patterns, and best practices
- Multi-Language Support: Responds in your preferred language (English, Indonesian, etc.)
- Semantic Error Interpretation: Translates technical errors into human-readable explanations
- Intent Recognition: Understands what you're trying to achieve, not just what you typed
| You Ask (Natural Language) | AI Understands & Responds |
|---|---|
| "Why is my sale order not creating invoices?" | Analyzes sale.order model, invoice generation workflow, and provides specific debugging steps |
| "How do I add a field that shows total price?" | Generates complete code with compute method, dependencies, and proper field definition |
| "This error keeps appearing when I save" | Reads the traceback, identifies the root cause, explains why it happens, and suggests fixes |
Auto-Repairing Code Engine (AI-Powered)
Revolutionary AI system that automatically detects, analyzes, and repairs bugs in your Odoo code.
How Auto-Repair Works:
1. Detection
AI monitors error dialogs and automatically identifies fixable issues
2. Analysis
Reads the entire source file, understands code structure and dependencies
3. Generation
AI generates corrected code following Odoo best practices and patterns
4. Verification
Shows diff for review, applies fix, and restarts server automatically
Intelligent Repair Capabilities:
Code-Level Fixes (Custom Addons)
- Syntax Error Fixing: Automatically corrects Python syntax errors, missing colons, indentation issues
- Import Resolution: Adds missing imports and removes unused ones
- ORM Pattern Correction: Fixes incorrect field definitions, compute methods, and constraints
- API Decorator Fixes: Corrects @api.model, @api.depends, @api.onchange usage
- Method Signature Repair: Fixes missing parameters, incorrect super() calls
- View XML Repair: Fixes malformed XML, incorrect field references
Database-Level Fixes (No Code Changes)
- ValidationError: Fixes data validation issues by correcting invalid field values
- IntegrityError: Resolves unique constraint violations and null value issues
- MissingError: Cleans up orphaned references to deleted records
- ValueError (Wrong value for): Fixes configuration parameter type mismatches
Permission & Access Fixes
- AccessError: Suggests security group assignments (requires manual review)
- Security Rule Fixes: Corrects access rights and record rules issues
System & Dependency Fixes
- ImportError: Identifies missing Python packages and provides pip install instructions
- Dependency Resolution: Identifies and suggests fixes for module dependency issues
Smart Error Detection
AI automatically determines the error type and applies the appropriate fix strategy:
- Database errors are fixed via ORM operations (no file changes)
- Code errors in custom addons are fixed by rewriting the source file
- Permission errors require manual review for security
- System errors provide step-by-step installation instructions
Safety Features:
- Whitelist Protection: Only repairs files in configured Custom Addon Paths
- Core Protection: Refuses to modify Odoo core files or system modules
- Diff Preview: Always shows changes before applying (no blind fixes)
- Backup Recommendation: Warns users to backup before applying fixes
- Rollback Support: Changes can be reverted using version control
Real-World Example:
Error: TypeError: create() missing 1 required positional argument: 'vals'
AI Analysis: Detects that the create method override is missing the vals parameter
Auto-Repair: Generates corrected code:
- def create(self): + def create(self, vals): # Your custom logic here + return super().create(vals)
Result: One-click fix applied, server restarted, error resolved! ✅
AI Technology Stack - Powered by Google Gemini
State-of-the-art Large Language Model with advanced code understanding capabilities.
Code Intelligence Features:
- Multi-Language Understanding: Python, XML, JavaScript, SQL
- Framework Expertise: Deep knowledge of Odoo architecture
- Pattern Recognition: Identifies common bugs and anti-patterns
- Context Window: Analyzes up to 1M tokens (entire modules at once)
- Code Generation: Produces production-ready, tested code
Natural Language Features:
- Conversational AI: Natural back-and-forth dialogue
- Technical Translation: Converts jargon to plain language
- Multi-lingual: Supports 100+ languages
- Contextual Memory: Remembers conversation history
- Sentiment Analysis: Understands urgency and intent
Continuous Learning:
The AI is regularly updated with the latest Odoo versions, best practices, and community patterns. It learns from millions of code examples to provide increasingly accurate suggestions.
🤖 AI-Powered Features (Google Gemini)
AI Ask - Instant Error Explanation
Get plain-English explanations for any error traceback.
- Click "AI Ask" button on any error dialog
- AI analyzes the full traceback and context
- Receive detailed explanation of what went wrong
- Get suggestions on how to fix the issue
- Understand root causes, not just symptoms
AI Fix - Automatic Code Repair
Let AI automatically fix bugs in your custom modules.
- Click "AI Fix" on errors in custom code
- AI reads the buggy file and analyzes the error
- Generates a corrected version of the code
- Shows you a diff for review before applying
- One-click apply with automatic server restart
AI Model Assistant (New!)
AI Method Explanation
Understand complex models instantly without guessing.
- Model Explanation: Click "AI Ask" on any Model form to get a comprehensive summary of its purpose.
- Structure Analysis: AI explains key fields, relationships, and business logic.
- Smart Caching: Explanations are cached and only regenerated when the model structure changes.
AI Field Generator
Create new fields using natural language instructions.
- No Coding Required:
- Advanced Field Types: Supports Compute, Related, Selection, Many2one, and more.
- Auto-Implementation: AI generates the correct Python code (using dictionary assignment) and dependencies.
- Instant Apply: Fields are created immediately as Manual Fields - No Server Restart Needed!
AI OdooBot Integration
Transform OdooBot into an intelligent AI assistant powered by Gemini.
Disabled
Standard OdooBot behavior - no AI responses.
Bot & Tour (Recommended)
AI responds to questions, but stays silent during onboarding tours.
Always AI
AI answers everything, even during tours.
- "How do I create a new field in Odoo?"
- "What's the difference between compute and related fields?"
- "Show me an example of a Many2many field"
- "How do I override the create method?"
AI Model Selection
Choose the right Gemini model for your needs:
| Model | Speed | Quality | Best For |
|---|---|---|---|
| Gemini 2.5 Flash ⭐ | Very Fast | Excellent | General use, quick responses (Recommended) |
| Gemini 2.5 Pro | Moderate | Best | Complex debugging, detailed analysis |
| Gemini 2.5 Flash-Lite | Fastest | Good | Simple questions, rapid iteration |
| Gemini 2.0 Flash | Fast | Excellent | Latest features, cutting-edge |
📋 Configuration Guide
Step 1: Get Your Google Gemini API Key
- Visit Google AI Studio
- Sign in with your Google account
- Click "Get API Key" in the top navigation
- Create a new API key or use an existing one
- Copy the API key (starts with "AIza...")
Step 2: Configure in Odoo
- Go to Settings â General Settings
- Scroll to AI Configuration section
- Paste your API key in the Google Gemini API Key field
- Select your preferred AI Model (Gemini 2.5 Flash recommended)
- Configure Custom Addon Paths - select the addon directories where AI Fix is allowed to modify files
- (Optional) Enable AI OdooBot Mode if you want AI-powered chat assistance
- Click Save
Step 3: Set Custom Addon Paths (Important for AI Fix)
AI Fix will ONLY modify files in the paths you specify here.
- In the AI Configuration section, find Custom Addon Paths
- Select one or more addon directories from the dropdown (these are your server's addon paths)
- Typically, you want to select your custom addons directory, e.g.,
/home/user/odoo-apps - Do NOT include core Odoo directories - AI Fix will refuse to modify them for safety
🎯 Usage Examples
Scenario 1: Debugging a Custom Module
- You're developing a custom module and encounter an error
- An error dialog appears with the traceback
- Click "AI Ask" to understand what went wrong
- Read the AI's explanation and suggested fixes
- If the error is in your custom code, click "AI Fix"
- Review the proposed code changes in the diff view
- Click "Apply Fix" if the changes look correct
- Server automatically restarts with the fixed code
Scenario 2: Server Maintenance via Web Console
- Go to Tools â Web Console
- Terminal opens with full shell access
- Check Odoo service status:
sudo systemctl status odoo - View recent logs:
tail -n 100 /var/log/odoo/odoo.log - Restart service if needed:
sudo systemctl restart odoo - Monitor server resources:
htop
Scenario 3: Data Migration with Odoo Shell
- Go to Technical â Odoo Shell
- Shell loads with full ORM access
- Write migration script:
>>> # Update all partners without email >>> partners = self.env['res.partner'].search([('email', '=', False)]) >>> for partner in partners: ... partner.email = f"{partner.name.lower().replace(' ', '.')}@example.com" >>> self.env.cr.commit() >>> print(f"Updated {len(partners)} partners")
- Execute and verify results immediately
💡 Tips & Best Practices
Do's
- ✅ Always review AI-generated fixes before applying
- ✅ Use "Bot & Tour" mode for AI OdooBot to avoid disrupting onboarding
- ✅ Configure Custom Addon Paths to enable AI Fix
- ✅ Use Gemini 2.5 Flash for best speed/quality balance
- ✅ Keep your API key secure and don't share it
- ✅ Test AI fixes in development before production
Don'ts
- ❌ Don't blindly apply AI fixes without reviewing
- ❌ Don't include core Odoo paths in Custom Addon Paths
- ❌ Don't use "Always AI" mode if you have active tours
- ❌ Don't share your Gemini API key publicly
- ❌ Don't run destructive commands in Web Console without backups
- ❌ Don't execute untested code in production Odoo Shell
🎉 Why Choose Odoo Shell OK?
Developing and maintaining Odoo instances traditionally requires juggling multiple tools: SSH clients for server access, separate terminals for Odoo shell, external editors for debugging, and constant context switching between browser and terminal.
Odoo Shell OK eliminates this friction by bringing everything into one unified interface. Access your server's terminal, run Odoo shell commands, manage SSH connections, and get AI-powered debugging assistance - all without leaving your browser.
The AI integration takes it further: instead of spending hours debugging cryptic error messages or searching Stack Overflow, get instant explanations and automated fixes. The AI understands Odoo's architecture and can provide context-aware solutions specific to your codebase.
Save Hours Every Week
Developers report saving 5-10 hours per week on debugging and server management tasks after adopting Odoo Shell OK.
📞 Support & Resources
Documentation
Comprehensive guides and API references available in the module.
Community Support
Join our community forums for tips, tricks, and troubleshooting.
Regular Updates
Continuous improvements and new AI features added regularly.
Ready to Supercharge Your Odoo Development?
Install Odoo Shell OK today and experience the future of Odoo development.
Odoo Proprietary License v1.0 This software and associated files (the "Software") may only be used (executed, modified, executed after modifications) if you have purchased a valid license from the authors, typically via Odoo Apps, or if you have received a written agreement from the authors of the Software (see the COPYRIGHT file). You may develop Odoo modules that use the Software as a library (typically by depending on it, importing it and using its resources), but without copying any source code or material from the Software. You may distribute those modules under the license of your choice, provided that this license is compatible with the terms of the Odoo Proprietary License (For example: LGPL, MIT, or proprietary licenses similar to this one). It is forbidden to publish, distribute, sublicense, or sell copies of the Software or modified copies of the Software. The above copyright notice and this permission notice must be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
Please log in to comment on this module