This project provides a command-line coding assistant powered by the DeepSeek API, designed for developers needing to interact with codebases programmatically. It enables users to read local files, create new ones, and apply precise diff edits directly from their terminal, streamlining code-related tasks and discussions.

How It Works

The assistant leverages Pydantic for robust data modeling of file operations (creation, editing) and chat responses. It uses a comprehensive system prompt to enforce strict JSON output for both conversational text and file modification instructions. The core interaction involves streaming completions from the DeepSeek API, parsing the JSON output to execute file operations like reading (/add), creating, or applying diff edits to existing files.

Quick Start & Requirements

• Install dependencies: pip install -r requirements.txt
• Run: python3 main.py
• Requires a DeepSeek API key set in a .env file (DEEPSEEK_API_KEY=your_api_key_here).
• Official documentation and demo are not explicitly linked.

Highlighted Details

• Integrates with DeepSeek API for code generation and file manipulation.
• Supports reading entire files or directories into the conversation context via the /add command.
• Implements real-time diff editing for precise code modifications.
• Includes an experimental r1.py script utilizing DeepSeek's Reasoning Model for Chain of Thought (CoT) capabilities.

Maintenance & Community

• Developed by Skirano as a rapid prototype to test DeepSeek v3 API capabilities.
• No explicit community links (Discord, Slack) or roadmap are provided in the README.

Licensing & Compatibility

• The README does not specify a license.

Limitations & Caveats

This project is described as an experimental rapid prototype. The lack of a specified license may pose compatibility issues for commercial or closed-source use. No benchmarks or performance metrics are provided.