AI Coder - Advanced AI Coding Assistant

✨ Currently available on TestPyPI - Production PyPI release coming soon! ✨

🚀 CodeDev is an advanced open-source AI-powered coding assistant with terminal integration, personally crafted with ❤️ by Ashok Kumar.

✨ Features

Conversational AI Interface: Natural language interaction with your codebase
Workspace Context: Automatically understands your project structure
File Operations: Read, write, and edit files with AI assistance
Code Analysis: Comprehensive codebase analysis and optimization suggestions
Shell Integration: Execute commands and see results in context
Real-time Streaming: Live AI responses as they're generated
MCP Server Mode: JSON-over-stdio protocol for integration with other tools

🛠️ Prerequisites

Ollama installed and running
DeepSeek R1 8B model downloaded

Quick Setup

# Install Ollama
curl -fsSL https://ollama.ai/install.sh | sh

# Start Ollama and get DeepSeek model  
ollama serve
ollama pull deepseek-r1:8b

2. Install Dependencies

pip install httpx

3. Run CodeDev

# Easy way
./start.sh

# Or directly
python3 codedev.py

# Test everything works
python3 test.py

💡 Usage Examples

🚀 codedev> help                               # Show all commands
🚀 codedev> analyze                            # Analyze your codebase
🚀 codedev> files                              # List files
🚀 codedev> read main.py                       # Read file
🚀 codedev> ask "How can I optimize this?"     # Ask AI questions
🚀 codedev> run python test.py                # Execute commands
🚀 codedev> create hello.py                   # Create new file

🎯 What It Can Do

Code Analysis: Understand your entire codebase
AI Chat: Ask questions about your code naturally
File Operations: Read, create, edit files with AI help
Bug Detection: Find and fix issues automatically
Code Review: Get optimization suggestions
Shell Integration: Run commands with AI context

🔧 Available Commands

Command	Description
`help`	Show all commands
`analyze`	Analyze entire codebase
`files [dir]`	List files in directory
`read <file>`	Read and display file
`create <file>`	Create new file interactively
`run <command>`	Execute shell command
`ask "<question>"`	Ask AI anything
`exit`	Exit CodeDev

🤖 AI Examples

🚀 codedev> ask "Find security vulnerabilities in my code"
🚀 codedev> ask "Write unit tests for the User class"  
🚀 codedev> ask "Explain how this algorithm works"
🚀 codedev> ask "Optimize this database query"
🚀 codedev> ask "Add error handling to this function"

🔌 MCP Server Mode

For integration with other tools:

python3 server.py

# Send JSON commands:
{"id":"1","tool":"fs.list","input":{"dir":"."}}
{"id":"2","tool":"ollama.chat","input":{"prompt":"Hello","model":"deepseek-r1:8b"}}

💖 Support My Work

If you find CodeDev helpful and want to support my open-source journey, consider buying me a coffee! Your support helps me continue developing amazing tools for the developer community.

🌟 Every contribution, no matter how small, means the world to me and keeps this project alive!

🔗 Links & Resources

📦 GitHub Repository: https://github.com/ashokumar06/codedev
🐍 PyPI Package: https://pypi.org/project/codedev/
📚 Documentation: GitHub Wiki
🐛 Bug Reports: GitHub Issues
💬 Discussions: GitHub Discussions
👤 Author: Ashok Kumar

🎯 Open Source & Community

CodeDev is completely open source and free to use! This project is my passion and I've put countless hours into making it the best AI coding assistant for developers like you.

🤝 How You Can Help

⭐ Star us on GitHub: github.com/ashokumar06/codedev - It really motivates me!
🍴 Fork the project: Create your own improvements and innovations
🐛 Report bugs: Help me improve the software quality
💡 Suggest features: Share your brilliant ideas with me
🤝 Contribute code: Submit pull requests and be part of the journey
💖 Support financially: Buy me a coffee or support via Razorpay

Personal Note: As an indie developer, your support and feedback mean everything to me. Every star, contribution, and coffee helps me dedicate more time to making CodeDev better! 🚀

🚀 Installation Options

Option 1: Install from PyPI (Recommended)

# Install the latest stable version
pip install codedev

# Use the commands
codedev --version
cdev --version

# Start using
codedev

Option 2: Install from GitHub (Latest)

# Install directly from GitHub
pip install git+https://github.com/ashokumar06/codedev.git

# Or clone and install
git clone https://github.com/ashokumar06/codedev.git
cd codedev
pip install .

Option 3: Build from Source (Development)

# Clone the repository
git clone https://github.com/ashokumar06/codedev.git
cd codedev

# Create virtual environment (recommended)
python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

# Install dependencies
pip install -r requirements.txt

# Install in development mode
pip install -e .

# Test installation
codedev --version
cdev --version

Option 4: Direct Build and Install

# Clone and build wheel
git clone https://github.com/ashokumar06/codedev.git
cd codedev

# Install build tools
pip install build

# Build the package
python -m build

# Install the wheel
pip install dist/codedev-*.whl

✨ Key Features

🚀 Smart Initialization

Automatic Ollama Detection: Checks for Ollama installation on startup
One-Click Linux Installation: Auto-installs Ollama using curl -fsSL https://ollama.com/install.sh | sh
Cross-Platform Support: Detects Linux, macOS, and Windows with appropriate instructions
Model Auto-Selection: Automatically selects the best available coding model
Health Checks: Verifies AI service connectivity before starting

🧠 AI-Powered Development

Natural Language Interface: Talk naturally - "create a web server", "fix this error"
Context-Aware Responses: Understands your project structure and coding patterns
Multiple AI Models: Support for DeepSeek, Codellama, Qwen2.5-Coder, Llama3.2, and more
Smart Model Management: Auto-detects and recommends optimal models for coding tasks
Improved Timeout Handling: Better stability with slow AI responses

📁 Advanced File Management

File Operations: Create, edit, refactor, move, copy, delete with full history
Project Management: Generate complete projects with templates and AI assistance
Version Control: Built-in undo/redo with automatic file versioning
Smart File Detection: Auto-detects languages and applies appropriate coding standards

💬 Enhanced Natural Language Processing

File References: Use @filename to reference specific files
Todo/Comments: Add notes with # todo add authentication
Conversational Commands: Casual interactions like "hi", "thanks", "what files do I have?"
Context Understanding: Remembers previous conversations and file states

🛡️ Safety & Security

Safe Command Execution: Whitelisted commands with sandboxing
Path Protection: Prevents access to system directories
File Size Limits: Configurable limits for file operations
Backup Creation: Automatic backups before destructive operations

🎨 Rich Terminal Experience

Beautiful UI: Rich terminal interface with colors, tables, and panels
Smart Completion: Auto-complete for commands and file names
History Management: Persistent command history across sessions
Interactive Prompts: Intuitive prompts with context information

🔧 Setup & Usage

Quick Start

Install CodeDev:
```
pip install codedev
```

Start using:

codedev                   # Start in current directory
cdev                      # Short command

AI will auto-setup Ollama (Linux) or guide you through manual installation

Usage Examples

Natural Language Commands

codedev> create a web server
codedev> fix @app.py
codedev> show my files  
codedev> # todo add authentication
codedev> refactor this code to use classes

Structured Commands

codedev> create server.py python "FastAPI web server with JWT auth"
codedev> edit @app.py python "add error handling"
codedev> models                    # Show available AI models
codedev> model deepseek-coder:6.7b # Switch to different model
codedev> help                      # Show all commands

Project Operations

codedev> create-project python myapi "REST API with FastAPI"
codedev> analyze-project
codedev> refactor-project "add type hints everywhere"

🤖 Model Management

The AI Coder automatically detects and manages AI models:

Automatic Model Selection

The system prioritizes models in this order:

DeepSeek R1: deepseek-r1:8b, deepseek-r1:1.5b
DeepSeek Coder: deepseek-coder:6.7b, deepseek-coder:1.3b
Llama 3.2: llama3.2:8b, llama3.2:3b, llama3.2:1b
Qwen2.5 Coder: qwen2.5-coder:7b, qwen2.5-coder:3b
CodeLlama: codellama:7b, codellama:13b
Phi3: phi3:3.8b, phi3:mini

Model Commands

ai-coder> models                    # Show detailed model information
ai-coder> model llama3.2:8b        # Switch to specific model
ai-coder> ollama pull deepseek-r1:8b # Install new model

⚙️ Configuration

Config File Location

Linux/macOS: ~/.config/ai-coder/config.yaml
Windows: %APPDATA%/ai-coder/config.yaml

Key Settings

ai:
  api_url: "http://127.0.0.1:11434"
  model: "deepseek-r1:8b"
  timeout: 120
  max_retries: 5
  temperature: 0.7

workspace:
  directory: "."
  history_dir: ".ai-coder-history"
  auto_save: true
  backup_on_edit: true

safety:
  allowed_commands: ["python", "node", "git", ...]
  blocked_paths: ["/etc", "/usr", "~/.ssh", ...]
  max_file_size: 10485760  # 10MB

🌐 Platform Support

Platform	Installation	Status
Linux	✅ Automatic	Fully Supported
macOS	📋 Manual	Supported
Windows	📋 Manual	Supported

Linux

Auto-installs Ollama using official installer
Auto-starts service via systemctl or direct command
Full feature support

macOS & Windows

Manual installation required
Download from https://ollama.com/download
All features supported after manual setup

🔍 Troubleshooting

Common Issues

Ollama Not Found

# Linux: AI Coder will offer to install automatically
# macOS/Windows: Download from https://ollama.com/download

Connection Timeout

# Check if Ollama is running
ollama serve

# Check service status (Linux)
systemctl status ollama

No Models Available

# AI Coder will automatically suggest and install recommended models
# Or manually: ollama pull deepseek-r1:8b

📚 Advanced Features

File Versioning

Every edit creates a timestamped backup
Full undo/redo history per file
Restore to any previous version

Smart Context

Understands project structure
Maintains conversation history
Learns from your coding patterns

Cross-Platform CLI

Works identically on Linux, macOS, Windows
Rich terminal UI with colors and formatting
Intelligent error handling and recovery

🤝 Contributing

We welcome contributions from the community! CodeDev is open source and thrives on community involvement.

Ways to Contribute

⭐ Star the Repository: Show your support on GitHub
🐛 Report Bugs: Submit issues on GitHub Issues
💡 Feature Requests: Suggest new features via GitHub Discussions
📖 Documentation: Improve docs and examples
🔧 Code Contributions: Submit pull requests

Development Setup

# Fork the repository on GitHub, then:
git clone https://github.com/YOUR_USERNAME/codedev.git
cd codedev

# Create virtual environment
python -m venv venv
source venv/bin/activate

# Install dependencies
pip install -r requirements.txt
pip install -e .

# Run tests
python test_installation.py

# Make your changes and submit a pull request!

Project Structure

codedev/
├── ai_coder/           # Main package
│   ├── ai/            # AI client and prompt management
│   ├── core/          # Configuration and core utilities  
│   ├── operations/    # File and project operations
│   ├── safety/        # Security and sandboxing
│   ├── utils/         # Utilities and platform detection
│   └── cli.py         # Main CLI interface
├── config/            # Default configuration
├── tests/             # Test suite
├── .github/           # GitHub workflows
└── setup.py           # Package configuration

📄 License

CodeDev is released under the MIT License - see LICENSE file for details.

This means you can:

✅ Use it commercially
✅ Modify and distribute
✅ Private use
✅ Include in your projects

� Support the Project

If you find CodeDev useful, please consider:

⭐ Starring the repository on GitHub
🐛 Reporting bugs and suggesting features
🤝 Contributing code or documentation
💬 Sharing it with other developers

🎯 Get Started Now!

# Install and start using immediately
pip install codedev
codedev

# Or build from source
git clone https://github.com/ashokumar06/codedev.git
cd codedev && pip install -e .
codedev --version

Ready to revolutionize your coding workflow with AI? 🚀

Made with ❤️ and countless cups of coffee by Ashok Kumar

GitHub • PyPI • Issues • Discussions

Connect with me for collaboration, feedback, and let's build something amazing together! 🤝

Name		Name	Last commit message	Last commit date
Latest commit History 15 Commits
.github/workflows		.github/workflows
ai_coder		ai_coder
config		config
tests		tests
.gitignore		.gitignore
LICENSE		LICENSE
MANIFEST.in		MANIFEST.in
README.md		README.md
SUMMARY.md		SUMMARY.md
codedev.py		codedev.py
pyproject.toml		pyproject.toml
requirements.txt		requirements.txt
server.py		server.py
setup.py		setup.py
test.py		test.py

License

ashokumar06/codedev

Folders and files

Latest commit

History

Repository files navigation