Skip to content
/ IDEC Public

IDEC (Intelligent Development Environment with Code AI) is a modern, extensible desktop IDE built with Electron, React, and Monaco Editor.It integrates multi-provider AI assistance directly into the coding workflow.

Notifications You must be signed in to change notification settings

syrex1013/IDEC

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

14 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

IDEC

Intelligent Development Environment with AI Code Assistance

A modern, feature-rich integrated development environment powered by AI, combining the flexibility of Monaco Editor with multi-provider AI capabilities.

Version License Platform

Features β€’ Installation β€’ Documentation β€’ Contributing


Overview

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.

Key Highlights

  • πŸ€– 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

Features

AI-Powered Development

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

Development Tools

  • 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

Installation

Prerequisites

Before installing IDEC, ensure you have the following:

  • Runtime: Bun (recommended) or Node.js 18+
  • Optional: Ollama for local AI model support

Quick Start

# Clone the repository
git clone https://github.com/syrex1013/IDEC.git
cd IDEC

# Install dependencies
bun install

# Start development server
bun start

Building from Source

# Build production bundle
bun run build

# Run production build
bun run electron

Creating Distributables

Build 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)

Configuration

AI Provider Setup

IDEC supports multiple AI providers. Configure your preferred provider in Settings (βš™οΈ):

Supported Providers

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 β†’

Local AI with 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

Documentation

Keyboard Shortcuts

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

Project Architecture

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

Technology Stack

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

Development

Development Workflow

# 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

Testing

# Run test suite
bun run test

# Run tests in watch mode
bun run test:watch

# Generate coverage report
bun run test:coverage

Coverage reports are generated in the coverage/ directory and can be viewed in your browser.


Troubleshooting

Common Issues

Ollama Connection Errors

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)

Build Failures

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 build

Application Won't Start

Problem: 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

Contributing

We welcome contributions to IDEC! Whether you're fixing bugs, adding features, or improving documentation, your help is appreciated.

How to Contribute

  1. Fork the repository
  2. Create a feature branch (git checkout -b feature/amazing-feature)
  3. Commit your changes (git commit -m 'Add amazing feature')
  4. Push to the branch (git push origin feature/amazing-feature)
  5. Open a Pull Request

Development Guidelines

  • Follow existing code style and conventions
  • Write tests for new features
  • Update documentation as needed
  • Ensure all tests pass before submitting PR

License

This project is licensed under the MIT License - see the LICENSE file for details.


Acknowledgments

IDEC is built with and inspired by:


Website β€’ Documentation β€’ Report Bug β€’ Request Feature

Made with ❀️ by the IDEC team

About

IDEC (Intelligent Development Environment with Code AI) is a modern, extensible desktop IDE built with Electron, React, and Monaco Editor.It integrates multi-provider AI assistance directly into the coding workflow.

Topics

Resources

Stars

Watchers

Forks

Sponsor this project

 

Packages

No packages published