DrGPT is designed for developers, system administrators, and power users who want intelligent assistance directly in their terminal. It supports OpenAI, Anthropic, Google, and custom APIs.

✨ Features

• 🤖 Multi-Provider Support: OpenAI (GPT-4, GPT-4o-mini), Anthropic (Claude), Google (Gemini), and custom APIs
• 💻 Interactive Shell Commands: Generate and execute shell commands safely with confirmation
• 🔧 Pure Code Generation: Generate clean code without explanations in markdown format
• 📝 Text Editor Integration: Use your favorite editor for complex prompt composition
• 💬 Interactive AI Interface: Continuous chat mode with special commands and context
• 🎨 Rich Output: Beautiful markdown rendering, syntax highlighting, and formatted panels
• ⚡ Streaming Responses: Real-time response streaming with live formatting
• ⚙️ Highly Configurable: Extensive configuration options with elegant status displays
• 🔐 Secure: Encrypted API key storage and safe command execution
• 🚀 Fast: Optimized for speed with animated loading indicators
• 🌐 Cross-Platform: Full support for Windows, macOS, and Linux

🚀 Quick Start

Installation

# Install from PyPI (recommended)
pip install drgpt

# Or install from source
git clone https://github.com/DrDataYE/drgpt.git
cd drgpt
pip install -e .

Updating

# Update to latest version from GitHub
drgpt --update

# Check current version
drgpt --version

Basic Setup

1. Set your API key (choose your preferred provider):

# OpenAI (recommended for beginners)
drgpt --provider openai --api-key YOUR_OPENAI_API_KEY

# Anthropic (Claude)
drgpt --provider anthropic --api-key YOUR_ANTHROPIC_API_KEY

# Google (Gemini)
drgpt --provider google --api-key YOUR_GOOGLE_API_KEY

2. Start using DrGPT:

drgpt "Explain how Python decorators work"

Environment Variables

# Windows (PowerShell)
$env:OPENAI_API_KEY = "your-api-key-here"

# Linux/macOS
export OPENAI_API_KEY="your-api-key-here"

📖 Usage Guide

🤖 Basic AI Queries

# General questions with beautiful markdown rendering
drgpt "What is quantum computing?"

# Get help with programming (formatted code blocks)
drgpt "How do I implement a binary search in Python?"

# System administration
drgpt "How to monitor disk usage on Linux?"

💻 Pure Code Generation

Generate clean code without explanations:

# Generate Python function (code only)
drgpt -c "Create a function to calculate fibonacci numbers"  

# Generate JavaScript code
drgpt -c "Create a React component for user authentication"  

# Generate SQL query
drgpt -c "Write a query to find top 10 customers by revenue"  

🛠️ Interactive Shell Commands

Generate and execute shell commands safely:

# Generate shell command with execution options
drgpt -s "Install Docker on Ubuntu"  

# Output shows:
# Generated Command: sudo apt-get update && sudo apt-get install docker.io
# [E]xecute, [D]escribe, [A]bort (e/d/a):

Options:

• [E]xecute: Run the command with confirmation
• [D]escribe: Get detailed explanation
• [A]bort: Cancel safely

📝 Text Editor Integration

Use your preferred text editor for complex prompts:

# Open editor for input composition
drgpt -e  

# Supports: VS Code, nano, vim, notepad, gedit
# Respects EDITOR and VISUAL environment variables

� Terminal Integration

Setup DrGPT aliases in your terminal for seamless AI assistance:

# Setup terminal aliases (one-time setup)
drgpt -i  

# After setup, use these shortcuts directly in your terminal:
! "What is machine learning?"              # Chat with AI
s: "Install Docker on Ubuntu"              # Shell commands with execution
c: "Create a Python sorting function"      # Code generation only
e:                                          # Open editor for complex prompts

How it works:

• ! prefix - Direct AI chat responses
• s: prefix - Generate shell commands with execution options
• c: prefix - Generate clean code without explanations
• e: - Open your default editor for complex prompt composition

Platform Support:

• Windows: PowerShell profile integration
• macOS/Linux: Bash/Zsh profile integration
• Fish Shell: Native function support

Setup is automatic - just run drgpt -i once and restart your terminal!

🎛️ Output Options

# Disable streaming for immediate formatted output
drgpt --no-streaming "Explain machine learning concepts"

# Get plain text output (no markdown formatting)
drgpt --no-markdown "Simple explanation without formatting"

# Save response to file
drgpt -o response.md "Generate API documentation"  

🔧 Provider Management

# List all available providers and models
drgpt --list-providers

# Switch providers and models
drgpt --provider anthropic --model claude-3-sonnet

# Check current status
drgpt --status

⚙️ Advanced Usage

# Custom temperature (creativity level)
drgpt --temperature 0.8 "Write a creative story about AI"

# Limit response length
drgpt --max-tokens 500 "Summarize machine learning"

# Combine multiple options
drgpt -c --no-streaming -o functions.py "Create utility functions for file operations"  # With shortcuts

# Chat session
drgpt -ch session_1 "Let's discuss Python programming"  

🛡️ Security Features

Safe Command Execution

• Confirmation Required: All shell commands require user confirmation
• Timeout Protection: Commands timeout after 5 minutes
• Error Handling: Safe execution with proper error reporting
• Abort Option: Easy cancellation for any command

Secure Configuration

• Encrypted API Keys: Secure local storage
• Environment Variables: Support for env-based configuration
• No Data Logging: No transmission beyond chosen AI provider

🌐 Cross-Platform Support

Platform	Editors	Shell	Commands
Windows	notepad, VS Code, Notepad++	PowerShell, CMD	Windows-specific
macOS	VS Code, nano, vim, vi	bash, zsh	macOS-specific
Linux	VS Code, nano, vim, gedit	bash, zsh, fish	Distribution-specific

⚙️ Configuration

Configuration File

DrGPT stores configuration in ~/.config/drgpt/config.

Supported Providers

Provider	Models	API Key Required
OpenAI	gpt-4, gpt-4o, gpt-4o-mini, gpt-3.5-turbo	Yes
Anthropic	claude-3-haiku, claude-3-sonnet, claude-3-opus	Yes
Google	gemini-pro, gemini-pro-vision	Yes
Custom	User-defined	Optional

🔧 Development

Setting up Development Environment

# Clone the repository
git clone https://github.com/DrDataYE/drgpt.git
cd drgpt

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

# Install in development mode
pip install -e ".[dev]"

# Run tests
python tests/test_basic.py

Project Structure

drgpt/
├── drgpt/                  # Main package
│   ├── core/              # Core functionality
│   │   ├── config.py      # Configuration management
│   │   ├── ai_interface.py # AI provider interface
│   │   └── manager.py     # Main manager class
│   ├── cli/               # Command-line interface
│   │   └── main.py        # CLI implementation
│   └── __init__.py        # Package initialization
├── tests/                 # Test suite
├── docs/                  # Documentation
├── ADVANCED_FEATURES.md   # Detailed feature guide
├── README.md              # This file
└── setup.py              # Package setup

📷 Screenshots

Example of interactive chat session in AI interface.

Example of safe shell command generation and execution.

Example of pure code generation in markdown output.

🎯 Use Cases

⚡ CLI Shortcuts

DrGPT provides convenient shortcuts for frequently used options:

Long Option	Short	Description
--code	-c	Generate code only (no explanations)
--shell	-s	Generate shell commands with execution options
--editor	-e	Open text editor for input composition
--interface	-i	Setup terminal aliases (!, s:, c:, e:)
--chat	-ch	Start or continue a chat session
--output	-o	Save response to file

Examples with shortcuts:

# Instead of: drgpt --code "Create a Python function"
drgpt -c "Create a Python function"

# Instead of: drgpt --shell "List all processes"
drgpt -s "List all processes"

# Instead of: drgpt --editor
drgpt -e

# Instead of: drgpt --interface
drgpt -i  # Setup terminal aliases

# Instead of: drgpt --output result.md "Explain AI"
drgpt -o result.md "Explain AI"

# Combine shortcuts:
drgpt -c -o code.py "Create a web scraper"

🎯 Use Cases

For Developers

# Code generation workflow
drgpt -e        
drgpt -c "Implement user authentication with JWT"  
drgpt -c "Create database migration for user roles"  

For System Administrators

# System management workflow
drgpt -s "Setup nginx with SSL certificate"  
drgpt -s "Configure automatic backups"      
drgpt -s "Monitor system performance"       

For Learning and Exploration

# Interactive learning session
drgpt -i  
! What is Kubernetes?
! code: Show me a simple Kubernetes deployment
! shell: Install kubectl on my system

🤝 Contributing

We welcome contributions! Please see our Contributing Guide for details.

📄 License

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

🎉 What's New in v2.7.2

• Enhanced Code Mode: Pure code generation without explanations
• Interactive Shell: Safe command execution with confirmations
• Editor Integration: Use any text editor for prompt composition
• Interactive Interface: Continuous chat with special commands
• Cross-Platform: Full Windows, macOS, and Linux support
• Security Features: Safe command execution and secure configuration

---

DrGPT v2.7.2 - The most advanced command-line AI assistant for developers and power users! 🚀