deepseeker 2.3.0

DeepSeek AI-powered CLI agent with HITL guardrails for code assistance and automation

DeepSeeker

AI-powered CLI agent with HITL guardrails for code assistance and automation.

Features

• Multi-Provider Support: DeepSeek, OpenAI, Anthropic
• Tool Use: Bash, Read, Write, Edit, Glob, Grep
• HITL Guardrails: MQ-9 Reaper model for operation safety
• Streaming Responses: Real-time output with tool execution display
• Interactive Shell: Slash commands, history, auto-completion

Installation

pip install deepseeker

Quick Start

# Interactive mode
deepseekpy

# Quick query
deepseekpy -q "explain this code"

# Set API key
deepseekpy --key YOUR_DEEPSEEK_API_KEY

API Key Setup

On first launch, you'll be prompted to enter your API key:

No DEEPSEEK API key found
Get your key from: https://platform.deepseek.com/api-keys
Enter DEEPSEEK_API_KEY: sk-...

Keys are stored securely in ~/.agi/secrets.json (mode 0600).

HITL Guardrails (MQ-9 Reaper Model)

Operations are classified by risk level:

Level	Approval	Examples
ROUTINE	Auto-approved	ls, git status, file reads
ELEVATED	Logged	File writes, git operations
CRITICAL	1 confirmation	sudo operations, system changes
LETHAL	2 confirmations + 5s delay	rm -rf /, disk writes

Commands

Command	Description
/help	Show help
/model [provider]	Switch AI provider
/tools	List available tools
/guardrails	Show guardrails status
/secrets	Manage API keys
/exit	Exit

Tools

• Bash: Execute shell commands
• Read: Read files with line numbers
• Write: Create/overwrite files
• Edit: Precise text replacement
• Glob: Find files by pattern
• Grep: Search file contents

API Error Handling

DeepSeeker detects and handles API errors:

• Invalid Key: Prompts for new key
• Rate Limited: Shows wait message
• Frozen Account: Displays support info
• Quota Exceeded: Shows billing link

License

MIT License - see LICENSE for details.

Author

Bo Shang [e-mail]