Deep Shell 🐚

Note: For the Linux version, see @gokul6350/DeepShell4

Deep Shell is an intelligent terminal application that combines a chat interface with a command-line interface, powered by Google's Gemini AI. It helps users execute terminal commands through natural language conversations.

Features

• Interactive chat interface with AI assistant
• Integrated terminal emulator
• Command explanations
• Support for various development operations:

- Python environment management - Git operations - Docker commands - Database operations (MySQL, PostgreSQL) - Package management (pip, npm) - File system operations - System information queries

TODO

• [X] Fix terminal direct input handling
• [ ] Add Agent B for command result processing
• [ ] Add settings button and configuration panel
• [ ] Implement transparent and blur window features
• [ ] Add support for additional LLMs:

- [ ] Integration with LiteLLM - [ ] Support for local models via Ollama - [ ] Model switching capability

Prerequisites

• Python 3.x
• Qt framework
• Google Gemini API key

Installation

• Clone the repository:

git clone <repository-url>
   cd deep-shell

• Install the required dependencies:

pip install -r requirements.txt

• Configure the API key:

- Copy config.template.py to config.py

cp config.template.py config.py

- Edit config.py and add your Gemini API key:

GEMINIAPIKEY = "your-api-key-here"

Usage

• Start the application:

python app.py

• The interface consists of two main sections:

- Left: Chat interface for natural language interactions - Right: Terminal emulator for command execution

• Type your query in the chat input to get command suggestions and explanations

• Use the terminal directly for command execution

• Click the reset button (↻) to clear and restart the terminal session

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

[Add your license here]