A modern, feature-rich integrated development environment powered by AI, combining the flexibility of Monaco Editor with multi-provider AI capabilities.
Features β’ Installation β’ Documentation β’ Contributing
IDEC is a next-generation integrated development environment that seamlessly integrates AI-powered coding assistance into your workflow. Built on modern web technologies, IDEC offers a responsive, intuitive interface with support for multiple AI providers including Claude, OpenAI, Groq, and local models via Ollama.
- π€ Multi-Provider AI Integration β Switch seamlessly between Claude, OpenAI, Groq, and local Ollama models
- π Professional Code Editor β Powered by Monaco Editor with full syntax highlighting and IntelliSense
- π» Integrated Terminal β Built-in terminal emulator for complete workflow integration
- π¨ Modern UI/UX β Minimalist design with smooth animations powered by Framer Motion
- π Project Management β Intuitive file explorer and workspace management
- β‘ Cross-Platform β Native builds for macOS, Windows, and Linux
IDEC provides four distinct AI interaction modes tailored for different development tasks:
| Mode | Description | Use Case |
|---|---|---|
| π¬ Chat | Interactive conversation with AI | Ask questions, get suggestions, debug issues |
| π Explain | Code analysis and documentation | Understand complex code, generate documentation |
| β»οΈ Refactor | Code optimization and improvement | Enhance performance, improve readability |
| β¨ Generate | AI-assisted code generation | Create boilerplate, scaffold components |
- Monaco Editor β The same powerful editor that powers Visual Studio Code
- Terminal Emulation β Full-featured terminal with xterm.js and node-pty
- File System Integration β Browse, edit, and manage project files
- Syntax Highlighting β Support for all major programming languages
- Dark Theme β Eye-friendly interface optimized for extended coding sessions
Before installing IDEC, ensure you have the following:
# Clone the repository
git clone https://github.com/syrex1013/IDEC.git
cd IDEC
# Install dependencies
bun install
# Start development server
bun start# Build production bundle
bun run build
# Run production build
bun run electronBuild platform-specific installers and packages:
# Build for current platform
bun run dist
# Platform-specific builds
bun run dist:mac # macOS (.dmg, .zip)
bun run dist:win # Windows (.exe installer)
bun run dist:linux # Linux (.AppImage, .deb)IDEC supports multiple AI providers. Configure your preferred provider in Settings (βοΈ):
| Provider | API Key Format | Type | Setup Guide |
|---|---|---|---|
| Claude | sk-ant-... |
Cloud | Get API Key β |
| OpenAI | sk-... |
Cloud | Get API Key β |
| Groq | gsk_... |
Cloud | Get API Key β |
| Ollama | Not required | Local | Install Ollama β |
For privacy-focused development or offline work, use Ollama for local AI models:
# Install Ollama
curl -fsSL https://ollama.ai/install.sh | sh
# Download recommended models
ollama pull llama3.2 # General-purpose model
ollama pull codellama # Optimized for code generation
# Configure IDEC
# 1. Open Settings in IDEC
# 2. Select "Ollama" as provider
# 3. Ensure Ollama is running: ollama serve| Shortcut | Action |
|---|---|
Cmd/Ctrl + S |
Save current file |
Cmd/Ctrl + O |
Open folder/project |
Cmd/Ctrl + N |
New file |
Cmd/Ctrl + W |
Close current file |
IDEC/
βββ src/
β βββ main/ # Electron main process
β β βββ main.js # Application entry point
β β βββ ipc/ # Inter-process communication
β βββ renderer/ # React frontend application
β βββ components/ # Reusable UI components
β βββ styles/ # Global styles and themes
β βββ utils/ # Helper functions
β βββ App.js # Root application component
βββ public/ # Static assets and resources
βββ dist/ # Webpack build output
βββ release/ # Platform-specific distributables
βββ tests/ # Test suites
IDEC is built with modern, industry-standard technologies:
- Application Framework: Electron 40
- UI Library: React 19
- Animation: Framer Motion
- Code Editor: Monaco Editor (VS Code engine)
- Terminal: xterm.js + node-pty
- Icons: Lucide React
- Build Tools: Webpack 5, electron-builder
- Package Manager: Bun
# Start development server with hot module replacement
bun start
# Build production bundle (no packaging)
bun run build
# Create packaged app without installer (for testing)
bun run pack
# Create full distribution with installer
bun run dist# Run test suite
bun run test
# Run tests in watch mode
bun run test:watch
# Generate coverage report
bun run test:coverageCoverage reports are generated in the coverage/ directory and can be viewed in your browser.
Problem: Cannot connect to Ollama or models aren't responding
Solution:
# Ensure Ollama service is running
ollama serve
# Verify Ollama is accessible
curl http://localhost:11434/api/tags
# Check IDEC settings for correct URL (default: http://localhost:11434)Problem: Build errors or dependency conflicts
Solution:
# Clear all caches and dependencies
rm -rf node_modules dist release bun.lockb
# Reinstall dependencies
bun install
# Rebuild application
bun run buildProblem: Electron app crashes on startup
Solution:
- Ensure you're using Node.js 18+ or latest Bun
- Check for conflicting global packages
- Review error logs in the terminal
- Try running in development mode:
bun start
We welcome contributions to IDEC! Whether you're fixing bugs, adding features, or improving documentation, your help is appreciated.
- Fork the repository
- Create a feature branch (
git checkout -b feature/amazing-feature) - Commit your changes (
git commit -m 'Add amazing feature') - Push to the branch (
git push origin feature/amazing-feature) - Open a Pull Request
- Follow existing code style and conventions
- Write tests for new features
- Update documentation as needed
- Ensure all tests pass before submitting PR
This project is licensed under the MIT License - see the LICENSE file for details.
IDEC is built with and inspired by:
- Monaco Editor by Microsoft
- Electron framework
- xterm.js terminal emulator
- The open-source community
Website β’ Documentation β’ Report Bug β’ Request Feature
Made with β€οΈ by the IDEC team