zackeryyy wang
644071850a
- AI-powered shell command generator using DeepSeek V3 - Support for natural language to shell command conversion - Secure configuration management with .env files - Package structure with uv tool installation support - Chinese and English language support - Configuration validation and error handling
43 lines
1.0 KiB
Markdown
43 lines
1.0 KiB
Markdown
# AI Shell
|
|
|
|
AI-powered shell command generator using DeepSeek V3 model via OpenAI-compatible API.
|
|
|
|
## Features
|
|
|
|
- Generate shell commands from natural language descriptions
|
|
- Interactive execution confirmation (Enter to execute, n to cancel)
|
|
- Supports multiple languages for prompts and responses
|
|
- Uses DeepSeek V3 model for high-quality command generation
|
|
- User-friendly interface with default execution on Enter
|
|
|
|
## Usage
|
|
|
|
```bash
|
|
uv run python ai.py "your command description here"
|
|
```
|
|
|
|
## Setup
|
|
|
|
1. Install dependencies:
|
|
```bash
|
|
uv sync
|
|
```
|
|
|
|
2. Run the tool:
|
|
```bash
|
|
uv run python ai.py "list all files in current directory"
|
|
uv run python ai.py "show disk usage"
|
|
uv run python ai.py "find all Python files"
|
|
```
|
|
|
|
## Configuration
|
|
|
|
- **Model**: DeepSeek V3 (deepseek-v3-250324)
|
|
- **API**: Volces (ByteDance) OpenAI-compatible interface
|
|
- **Base URL**: https://ark.cn-beijing.volces.com/api/v3/
|
|
|
|
## Requirements
|
|
|
|
- Python 3.12+
|
|
- UV package manager with configured Chinese mirrors for fast downloads
|