deepseekCLI

Overview

deepseekCLI is a command-line interface (CLI) and Read-Eval-Print Loop (REPL) tool designed to streamline project generation using the DeepSeek API. Users can input a project description in natural language, and the tool generates complete files, evaluates them, and learns from each execution to enhance the performance of future tasks.

Key Features

• Intuitive Project Creation: Simply provide a natural language description, and deepseekCLI will generate the necessary files and configuration.
• Learning Mechanism: Each project execution improves the tool's capabilities, leading to progressively better outputs.
• Interactive REPL: Access an interactive environment with autocompletion and command history for efficient project management.

Usage Examples

Interactive Mode

Initiate deepseekCLI by running:

deep

This opens the REPL, where all commands with autocompletion features can be utilized.

Direct Command Execution

Run commands directly from the terminal without entering the REPL:

deep build "API REST en FastAPI with JWT authentication"
deep ask "how Redis works?"
deep doctor

Command Breakdown

build - Create a Project

Generate a project based on a description:

deep build "project description"
deep build -t task.txt                          # load description from a file
deep build "Flask app with SQLite" -f            # auto-fix on failure
deep build "HTML/CSS landing page" -o ~/dir      # specify output directory
deep build "expression compiler" --model deepseek-reasoner

Each build process executes several phases, ensuring comprehensive planning, generation, evaluation, and learning to optimize future builds.

ask - Engage with the Model

Start a conversation with the model using:

deep ask "how Redis works?"

Continue the dialogue effortlessly using a chat format without re-issuing commands.

Manage Projects with Update and Fix Commands

Update existing projects with:

deep update "add JWT authentication"
deep update "add unit tests" --model deepseek-reasoner

Fix errors in current projects effortlessly:

deep fix

Web Server Access

Easily serve the tool for mobile access:

deep serve           # Basic HTTP
deep serve --https     # HTTPS enabled, installable as an app

Utilize Tailscale for secure mobile access without needing to adjust network settings.

Logging and Debugging

Use the --debug flag for detailed session logs, capturing every action taken by deepseekCLI:

deep --debug build "my task"
deep --debug ask "how does Redis work?"

Additional Capabilities

• Configuration Management: Set and manage your DeepSeek API key easily.
• Task History: View accumulated experiences from previous builds.
• Customized Skills: Define personalized roles for specialized responses during interactions.

System Requirements

• Compatible with Python 3.9+
• Requires a valid DeepSeek API key.

Optional Dependencies

To enhance the functionality of the REPL and HTTPS serving, optional dependencies can be installed:

pip install prompt_toolkit          # For autocompletion and history in REPL
pip install trustme                 # For HTTPS support

Compatibility

deepseekCLI is fully supported on:

• Linux
• macOS
• Windows 10+ (Windows Terminal)

For more details and comprehensive documentation, visit the deepseekCLI GitHub repository.