DeepSeek Engineer 🐋

Overview

This repository contains a powerful coding assistant application that integrates with the DeepSeek API to process user conversations and generate structured JSON responses. Through an intuitive command-line interface, it can read local file contents, create new files, and apply diff edits to existing files in real time.

Key Features

1. DeepSeek Client Configuration

   • Automatically configures an API client to use the DeepSeek service with a valid DEEPSEEK_API_KEY.
   • Connects to the DeepSeek endpoint specified in the environment variable to stream GPT-like completions.

2. Data Models

   • Leverages Pydantic for type-safe handling of file operations, including: • FileToCreate – describes files to be created or updated.
     • FileToEdit – describes specific snippet replacements in an existing file.
     • AssistantResponse – structures chat responses and potential file operations.

3. System Prompt

   • A comprehensive system prompt (system_PROMPT) guides conversation, ensuring all replies strictly adhere to JSON output with optional file creations or edits.

4. Helper Functions

   • read_local_file: Reads a target filesystem path and returns its content as a string.
   • create_file: Creates or overwrites a file with provided content.
   • show_diff_table: Presents proposed file changes in a rich, multi-line table.
   • apply_diff_edit: Applies snippet-level modifications to existing files.

5. "/add" Command

   • Users can type "/add path/to/file" to quickly read a file's content and insert it into the conversation as a system message.
   • This allows the assistant to reference the file contents for further discussion, code generation, or diff proposals.

6. Conversation Flow

   • Maintains a conversation_history list to track messages between user and assistant.
   • Streams the assistant's replies via the DeepSeek API, parsing them as JSON to preserve both the textual response and the instructions for file modifications.

7. Interactive Session

   • Run the script (for example: "python3 main.py") to start an interactive loop at your terminal.
   • Enter your requests or code questions. Enter "/add path/to/file" to add file contents to the conversation.
   • When the assistant suggests new or edited files, you can confirm changes directly in your local environment.
   • Type "exit" or "quit" to end the session.

Getting Started

1. Prepare a .env file with your DeepSeek API key: DEEPSEEK_API_KEY=your_api_key_here

2. Install dependencies and run (choose one method):

   Using pip

   pip install -r requirements.txt
   python3 main.py

   Using uv (faster alternative)

   uv venv
   
   uv run main.py

3. Enjoy multi-line streaming responses, file read-ins with "/add path/to/file", and precise file edits when approved.

Note: This is an experimental project developed by Skirano to test the new DeepSeek v3 API capabilities. It was developed as a rapid prototype and should be used accordingly.