DeepSeek-Based Coding Agent

This project is my terminal-based coding agent built on top of the DeepSeek API. It lets me chat with an AI assistant that can use tools to inspect and modify files inside the project directory.

What This Project Does

• Runs an interactive command-line chat loop
• Sends prompts to DeepSeek for reasoning and tool selection
• Executes local tools for file operations
• Returns tool results back to the model for follow-up actions

Core Capabilities

• Read file contents
• Edit or create files
• List directory contents
• Keep conversational context while working on tasks

Requirements

• Python 3.9+
• A valid DeepSeek API key

Setup

1. Clone this repository.
2. (Optional but recommended) Create and activate a virtual environment.
3. Install dependencies:

pip install -r requirements.txt

4. Export your API key:

export DEEPSEEK_API_KEY="your-api-key"

Run

python main.py

Type your request and press Enter. Use Ctrl+D to exit.

Example Prompts

Create a Python script that prints hello world
Read the contents of tools.py
List all files in the current folder

Project Files

• main.py: chat loop, DeepSeek request flow, and tool orchestration
• tools.py: local tool implementations exposed to the model
• requirements.txt: Python dependencies